Улучшить эту документацию Просмотреть исходный код дата
- Фильтр в модуле 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 PM) -
'short': эквивалентно'M/d/yy h:mm a'для локали en_US (например, 3.09.2010 12:05 PM) -
'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 PM) -
'shortTime': эквивалентно'h:mm a'для локали en_US (например, 12:05 PM)Строка
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–2020 Google, Inc.
Licensed under the Creative Commons Attribution License 3.0.
https://code.angularjs.org/1.8.2/docs/api/ng/filter/date
