Улучшить эту документацию Просмотреть исходный код дата
- фильтр в модуле 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.10 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.09.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'").
Использование
В привязке шаблона 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–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.5.11/docs/api/ng/filter/date