Функции обработки даты/времени

Раздел описывает функции языка выражений, относящиеся к обработке временных меток.

Функция

Описание

Тип результата

Поддержка бэкендом

Поддержка фронтендом

date(Integer year, Integer month, Integer day, Integer hour, Integer minute, Integer second [, Integer millisecond [, String timezone]])

Формирует дату по заданным значениям года, месяца, дня, часа, минуты и секунды. Имейте в виду, что месяц отсчитывается с нуля, т.е. значение Января равно 0.

Временная зона по умолчанию, используемая для построения временных меток - UTC. Пользовательские временные зоны могут задаваться в форме строки, например:

  • GMT-8

  • GMT-08:00

  • America/Los_Angeles

Date

Да

Да

dateAdd(Date date, Integer count, String unit [, String timezone])

Добавляет число периодов времени, заданное в упомянутых выше единицах, к дате, и возвращает результат. См. названия единиц выше.

Временная зона по умолчанию - UTC. Пользовательские временные зоны могут задаваться в форме строки, например:

  • GMT-8

  • GMT-08:00

  • America/Los_Angeles

Date

Да

Да

dateDiff(Date first, Date second, String unit)

Рассчитывает время, прошедшее с первой даты до второй, измеряемое в:

  • millisecond или ms для миллисекунд

  • second, sec или s для Секунд

  • minute, min или m для Минут

  • hour, hr или h для Часов

  • day или d для Дней

  • week или w для Недель

  • month для Месяцев (Имейте в виду, что  месяц с нулевой базой, т.е. значение для Января равно 0.)

  • year или y для Лет.

Long

Да

Да

day(Date date [, String timezone])

Возвращает день заданной временной метки. См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

Да

Да

dayOfWeek(Date date [, String timezone])

Возвращает день недели заданной временной метки (1 для воскресенья). См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

Да

Да

dayOfYear(Date date [, String timezone])

Возвращает день года заданной временной метки. См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

Да

Да

formatDate(Date date, String pattern [, String timezone])

Форматирует значение Даты в Строку. Образцы форматирования даты описаны здесь.

Временная зона по умолчанию, используемая для форматирования временных меток - UTC. Пользовательские временные зоны могут задаваться в форме строки, например:

  • GMT-8

  • GMT-08:00

  • America/Los_Angeles

Для форматирования даты в строку, подходящую для перестройки Таблицы Данных из списка параметров строки, используйте следующий образец: yyyy-MM-dd HH:mm:ss.SSS.

String

Да

Да

hour(Date date [, String timezone])

Возвращает час заданной временной метки. См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

Да

Да

millisecond(Date date)

Возвращает миллисекунду заданной временной метки.

Integer

Да

Да

minute(Date date [, String timezone])

Возвращает минуту заданной временной метки. См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

Да

Да

month(Date date [, String timezone])

Возвращает месяц заданной временной метки (0 для Января). См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

Да

Да

now()

Возвращает текущую дату/время.

Date

Да

Да

second(Date date)

Возвращает секунду заданной временной метки.

Integer

Да

Да

parseDate(String source, String pattern [, String timezone])

Разбирает значение Даты из Строки. Шаблоны дат описаны здесь.

Временная зона по умолчанию, используемая для построения временных меток - UTC. Пользовательские временные зоны могут задаваться в форме строки, например:

  • GMT-8

  • GMT-08:00

  • America/Los_Angeles

String

Да

Да

printPeriod(Long period [, minUnit [, maxUnit]])

Интеллектуально форматирует временной период (выраженный в миллисекундах) в строку в следующей форме: X days X hours X minutes X seconds. minUnit и maxUnit - это минимальные и максимальные типы целых единиц для использования в отрисовке и редактировании периода. Доступные единицы описаны здесь, единицы Неделя и Квартал не поддерживаются.

String

Да

Да

time(Date date)

Возвращает число миллисекунд с Начала отчета для заданной временной точки.

Long

Да

Да

year(Date date [, String timezone])

Возвращает год заданной временной метки. См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

Да

Да