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

Функция

Описание

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

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

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

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

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

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

• GMT-8

• GMT-08:00

• America/Los_Angeles

Пример: date(2026, 0, 1, 8, 30, 0, 0, "GMT-08:00") возвращает "01.01.2026 08:30:00"

Date

Да

Да

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

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

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

• GMT-8

• GMT-08:00

• America/Los_Angeles

Пример: dateAdd(date(2026, 0, 1), 2, "day") возвращает "03.01.2026 03:00:00"

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 для Лет.

Пример: dateDiff(date(2026, 0, 1), date(2026, 0, 2), "day") возвращает "1"

Long

Да

Да

day(Date date [, String timezone])

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

Пример: day(date(2026, 0, 1, 23, 0, 0, 0, "UTC"), "GMT+02:00") возвращает "2"

Integer

Да

Да

dayOfWeek(Date date [, String timezone])

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

Пример: dayOfWeek(date(2026, 0, 1), "UTC") возвращает "5"

Integer

Да

Да

dayOfYear(Date date [, String timezone])

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

Пример: dayOfYear(date(2026, 0, 1)) возвращает "1"

Integer

Да

Да

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

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

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

• GMT-8

• GMT-08:00

• America/Los_Angeles

Пример: formatDate(date(2026, 0, 1, 12, 5, 30, 123), "yyyy-MM-dd HH:mm:ss.SSS") возвращает "2026-01-01 12:05:30.123"

String

Да

Да

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

hour(Date date [, String timezone])

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

Пример: hour(date(2026, 0, 1, 23, 0, 0, 0, "UTC"), "GMT+02:00") возвращает "1"

Integer

Да

Да

millisecond(Date date)

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

Пример: millisecond(date(2026, 0, 1, 0, 0, 0, 987)) возвращает "987"

Integer

Да

Да

minute(Date date [, String timezone])

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

Пример: minute(date(2026, 0, 1, 12, 34, 0)) возвращает "34"

Integer

Да

Да

month(Date date [, String timezone])

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

Пример: month(date(2026, 0, 15)) возвращает "0"

Integer

Да

Да

now()

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

Пример: now() возвращает текущую дату/время

Date

Да

Да

second(Date date)

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

Пример: second(date(2026, 0, 1, 0, 0, 42)) возвращает "42"

Integer

Да

Да

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

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

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

• GMT-8

• GMT-08:00

• America/Los_Angeles

Пример: parseDate("2026-01-01 12:05:30.123", "yyyy-MM-dd HH:mm:ss.SSS", "UTC") возвращает "01.01.2026 15:05:30"

String

Да

Да

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

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

Пример: printPeriod(90061000) возвращает "1 Days 1 Hours 1 Minutes 1 Seconds"

String

Да

Да

time(Date date)

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

Пример: time(date(1970, 0, 1)) возвращает "0"

Long

Да

Да

year(Date date [, String timezone])

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

Пример: year(date(2026, 0, 1)) возвращает "2026"

Integer

Да

Да

weekOfMonth(Date date [, String timezone])

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

Пример: weekOfMonth(date(2026, 0, 1)) возвращает "1"

Integer

Да

Нет

weekOfYear(Date date [, String timezone])

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

Пример: weekOfYear(date(2026, 0, 1)) возвращает "1"

Integer

Да

Нет