Улучшить эту документацию Просмотреть исходный код дата
- фильтр в модуле 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.09.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 (например, 03.09.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.6.9/docs/api/ng/filter/date
