Улучшить эту документацию Просмотреть исходный код дата
- Фильтр в модуле ng
Обзор
Форматирует date в строку на основе запрошенного format.
Строка format может состоять из следующих элементов:
-
'yyyy': 4-значное представление года (например, н.э. 1 => 0001, н.э. 2010 => 2010) -
'yy': 2-значное представление года, дополненное нулями (00-99). (например, н.э. 2001 => 01, н.э. 2010 => 10) -
'y': 1-значное представление года, например (н.э. 1 => 1, н.э. 199 => 199) -
'MMMM': Месяц в году (январь-декабрь) -
'MMM': Месяц в году (янв-дек) -
'MM': Месяц в году, дополненный нулями (01-12) -
'M': Месяц в году (1-12) -
'LLLL': Отдельный месяц в году (январь-декабрь) -
'dd': День месяца, дополненный нулями (01-31) -
'd': День месяца (1-31) -
'EEEE': День недели (воскресенье-суббота) -
'EEE': День недели (вск-сб) -
'HH': Час в сутках, дополненный нулями (00-23) -
'H': Час в сутках (0-23) -
'hh': Час в формате AM/PM, дополненный нулями (01-12) -
'h': Час в формате AM/PM (1-12) -
'mm': Минута в часе, дополненная нулями (00-59) -
'm': Минута в часе (0-59) -
'ss': Секунда в минуте, дополненная нулями (00-59) -
's': Секунда в минуте (0-59) -
'sss': Миллисекунда в секунде, дополненная нулями (000-999) -
'a': Маркер AM/PM -
'Z': 4-значное представление смещения часового пояса (+знак) (-1200-+1200) -
'ww': Неделя года, дополненная нулями (00-53). Неделя 01 — неделя с первой четвергом года -
'w': Неделя года (0-53). Неделя 1 — неделя с первой четвергом года -
'G','GG','GGG': Сокращенная форма строки эпохи (например, 'н.э.') -
'GGGG': Полная форма строки эпохи (например, 'Anno Domini')Строка
formatтакже может быть одной из следующих предопределенных локализабельных форматов: -
'medium': эквивалент'MMM d, y h:mm:ss a'для регионального варианта en_US (например, 3 сен. 2010 г. 12:05:08) -
'short': эквивалент'M/d/yy h:mm a'для регионального варианта en_US (например, 3/9/10 12:05) -
'fullDate': эквивалент'EEEE, MMMM d, y'для регионального варианта en_US (например, Пятница, 3 сентября 2010 г.) -
'longDate': эквивалент'MMMM d, y'для регионального варианта en_US (например, 3 сентября 2010 г.) -
'mediumDate': эквивалент'MMM d, y'для регионального варианта en_US (например, 3 сен. 2010) -
'shortDate': эквивалент'M/d/yy'для регионального варианта en_US (например, 3/9/10) -
'mediumTime': эквивалент'h:mm:ss a'для регионального варианта en_US (например, 12:05:08) -
'shortTime': эквивалент'h:mm a'для регионального варианта en_US (например, 12:05)Строка
formatможет содержать литеральные значения. Они должны быть экранированы, заключённые в одинарные кавычки (например,"h 'in the morning'"). Для вывода одиночной кавычки необходимо экранировать её - две одинарные кавычки подряд (например,"h 'o''clock'").Любые другие символы в строке
formatбудут выводиться как есть.
Использование
В связывании с шаблоном HTML
{{ date_expression | date : format : timezone}} В JavaScript
$filter('date')(date, format, timezone) Аргументы
| Параметр | Тип | Подробности |
|---|---|---|
| дата | Datenumberstring | Дата для форматирования в виде объекта Date, миллисекунд (строка или число) или различных форматов строк даты и времени ISO 8601 (например, yyyy-MM-ddTHH:mm:ss.sssZ и его более короткие версии, такие как yyyy-MM-ddTHH:mmZ, yyyy-MM-dd или yyyyMMddTHHmmssZ). Если часовой пояс не указан в строковом вводе, время считается по местному времени. |
| формат (необязательно) | string | Правила форматирования (см. описание). Если не указано, используется |
| часовой пояс (необязательно) | string | Часовой пояс, используемый для форматирования. Он понимает UTC/GMT и сокращения часовых поясов США, но для общего использования используйте смещение часового пояса, например, |
Возвращаемое значение
string |
Отформатированная строка или входные данные, если входные данные не распознаются как дата/миллисекунды. |
Примеры
© 2010–2018 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.7.8/docs/api/ng/filter/date
