Spec-Zone.ru › Angular.js 1.5

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

  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)
  • '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

Правила форматирования (см. описание). Если не указано, используется 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.5.11/docs/api/ng/filter/date

Spec-Zone.ru

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