Трансформеры даты и времени (Date & time)
Операторы даты сначала разбирают вход: ISO-строку, Date или числовой epoch
(автоматически трактуется как секунды, если величина меньше ~1e12, иначе —
миллисекунды). Вся арифметика и форматирование выполняются в UTC.
Неразбираемый вход проходит насквозь без изменений.
formatDate
Вид: трансформер · Обработка значения: whole-value
Форматирует значение даты.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
format |
string | нет | ISO8601 |
Поведение. ISO8601 (или iso) выдаёт полную ISO-строку; иначе используется
токен-шаблон: YYYY, MM, DD, HH, mm, ss, SSS, Z.
Пример. "2024-03-05T12:34:56Z" с format="YYYY-MM-DD" → "2024-03-05"
parseDate
Вид: трансформер · Обработка значения: whole-value
Разбирает дату/метку времени в ISO-строку.
Пример. "2024-03-05" → "2024-03-05T00:00:00.000Z"
dateAdd
Вид: трансформер · Обработка значения: whole-value
Добавляет промежуток времени к дате.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
amount |
number | да | — |
unit |
string | нет | days |
Поведение. unit — одно из seconds, minutes, hours, days, months,
years.
Пример. "2024-03-05T12:00:00Z" с amount=1, unit="days" →
"2024-03-06T12:00:00.000Z"
dateSubtract
Вид: трансформер · Обработка значения: whole-value
Вычитает промежуток времени из даты (те же единицы, что у dateAdd).
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
amount |
number | да | — |
unit |
string | нет | days |
Пример. "2024-03-05T12:00:00Z" с amount=2, unit="hours" →
"2024-03-05T10:00:00.000Z"
dateDiff
Вид: трансформер · Обработка значения: whole-value
Разница между значением и другой датой, округлённая вниз до выбранной единицы.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
other |
string | да | — |
unit |
string | нет | seconds |
Поведение. unit — одно из milliseconds, seconds, minutes, hours,
days, months, years. Результат — value − other.
Пример. "2024-03-05T12:00:00Z" с other="2024-03-04T12:00:00Z",
unit="days" → 1
utcNow
Вид: трансформер · Обработка значения: whole-value · Синоним: now
Текущее время UTC в виде ISO-строки. Недетерминирован по замыслу — читает часы, поэтому повторный запуск маппера даёт новое значение. Игнорирует свой вход.
Пример. (любой вход) → "2024-03-05T12:34:56.000Z" (момент запуска)
toEpoch
Вид: трансформер · Обработка значения: whole-value
Преобразует дату в epoch-секунды.
Пример. "2024-03-05T12:34:56Z" → 1709642096
fromEpoch
Вид: трансформер · Обработка значения: whole-value
Преобразует epoch-секунды в ISO-строку.
Пример. 1709642096 → "2024-03-05T12:34:56.000Z"
isBeforeDate
Вид: трансформер · Обработка значения: whole-value
true, когда значение раньше другой даты.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
other |
string | да | — |
Пример. "2024-01-01" с other="2024-02-01" → true
isAfterDate
Вид: трансформер · Обработка значения: whole-value
true, когда значение позже другой даты.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
other |
string | да | — |
Пример. "2024-03-01" с other="2024-02-01" → true
isBetweenDates
Вид: трансформер · Обработка значения: whole-value
true, когда значение лежит между двумя датами (включительно).
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
start |
string | да | — |
end |
string | да | — |
Пример. "2024-02-15" с start="2024-02-01", end="2024-03-01" → true
getYear
Вид: трансформер · Обработка значения: whole-value
Год UTC значения даты (число).
Пример. 1709640896 → 2024
getMonth
Вид: трансформер · Обработка значения: whole-value
Месяц UTC (1–12) значения даты.
Пример. "2024-03-05T12:34:56Z" → 3
getDay
Вид: трансформер · Обработка значения: whole-value
День месяца UTC значения даты.
Пример. "2024-03-05T12:34:56Z" → 5
getDayOfWeek
Вид: трансформер · Обработка значения: whole-value
День недели UTC, 0 = воскресенье … 6 = суббота.
Пример. "2024-03-05T12:34:56Z" → 2 (вторник)
timeZoneConvert
Вид: трансформер · Обработка значения: whole-value
Отображает дату в другом часовом поясе IANA (как форматированную строку
MM/DD/YYYY, HH:mm:ss).
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
timezone |
string | да | UTC |
Пример. "2024-03-05T12:00:00Z" с timezone="America/New_York" →
"03/05/2024, 07:00:00"