Spec-Zone.ru › Angular.js 1.4

Улучшить эту документацию Просмотреть исходный код дата

  1. фильтр в модуле 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)
  • '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 (например, 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'").

Использование

В привязке к шаблону 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

Правила форматирования (см. описание). Если не указано, используется mediumDate.

часовой пояс
(необязательно)
string

Часовой пояс, который будет использоваться для форматирования. Он понимает UTC/GMT и сокращения часовых поясов стран Северной Америки, но для общего использования используйте смещение часового пояса, например, '+0430' (4 часа 30 минут к востоку от Гринвичского меридиана). Если не указано, будет использоваться часовой пояс браузера.

Возвращаемое значение

string

Отформатированная строка или входные данные, если входные данные не распознаются как дата/миллисекунды.

© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.4.14/docs/api/ng/filter/date

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API