Работа с датами

Дополнительные функции для работы с датами

to_timestamp(dt)

Преобразует дату в число (в секундах).

>>> to_timestamp(%datetime%)
1725474395.201937

from_timestamp(ts)

Преобразует число (timestamp — в секундах) в дату.

>>> from_timestamp(1725474395.201937)
2024-09-04 21:26:35.201937+03:00

date_diff(d1, d2)

Возвращает число секунд, прошедших от d1 до d2.

>>> date_diff(%d1%, %d2%)
600.0

add_to_date(dt, delta, unit)

Прибавляет (вычитает) к дате указанное в delta число дней/часов/минут/секунд. Возможные значения для unit:

• days

• hours

• minutes

• seconds

>>> add_to_date(%datetime%, 2, 'days')
2024-09-07 13:40:35.377632+03:00

format_date(dt, fmt)

Преобразует дату (объект) в строку в указанном формате.

Основные спецификаторы формата:

Спецификатор	Пример	Описание
yy	24	год
yyyy	2024	год
MM	09	месяц
MMMM	сентября	месяц
dd	05	число
EE	чт	день недели
EEEE	четверг	день недели
HH	16	часы
mm	03	минуты
ss	25	секунды

Обращаем внимание, что регистр спецификаторов важен, так, например MM — это месяц, а mm — минуты.

Полное описание возможных спецификаторов формата: https://unicode.org/reports/tr35/tr35-dates.html#table-date-field-symbol-table

>>> format_date(%datetime%, 'dd.MM.yyyy HH:mm')
05.09.2024 16:05

>>> format_date(%datetime%, 'dd.MM.yyyy')
05.09.2024

>>> format_date(%datetime%, 'dd.MM.yyyy')
05.09.2024

>>> format_date(%datetime%, 'EEEE, d MMMM')
четверг, 5 сентября

>>> format_date(%datetime%, "yyyy-MM-dd'T'HH:mm:ss.SSSZ")
2024-09-05T16:14:38.523+0300