Работа с датами и временем¶

Доступные модули:

datetime – работа с датой и временем;
timezone – работа с часовыми поясами;
clock – значения времени, полученные из функции Posix / C CLOCK_GETTIME. Для работы доступны все функции модуля, за исключением функции clock.bench().

datetime¶

Модуль datetime содержит функции для работы с датой и временем. Помимо функций ниже, для работы также доступны функции из встроенного Tarantool-модуля datetime.

datetime.now()¶

Returns: текущее время по Гринвичу (GMT) в наносекундах
Return type: cdata

datetime.sec_to_iso_8601_date(sec)¶

Преобразует число секунд в строковое представление даты.

Parameters: sec (number) – число секунд
Returns: дата в формате ISO 8601 вида yyyy-MM-dd
Return type: string

datetime.nsec_to_iso_8601_date(nsec)¶

Преобразует число наносекунд в строковое представление даты.

Parameters: nsec (cdata) – число наносекунд
Returns: дата в формате ISO 8601 вида yyyy-MM-dd
Return type: string

datetime.nsec_to_iso_8601_datetime(nsec)¶

Преобразует число наносекунд в строковое представление даты и времени.

Parameters: nsec (cdata) – число наносекунд
Returns: дата и время в формате ISO 8601 вида yyyy-MM-ddTHH:mm:ss.SSSZ
Return type: string

datetime.nsec_to_iso_8601_time(nsec)¶

Преобразует заданную в наносекундах дату и время в строковое представление времени.

Parameters: nsec (cdata) – число наносекунд
Returns: время в формате ISO 8601 вида HH:mm:ss.SSS
Return type: string

datetime.nsec_to_day_of_week(nsec)¶

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

Parameters: nsec (cdata) – число наносекунд
Returns: день недели в формате числа от 1 до 7, где 1 – воскресенье, а 7 – суббота
Return type: number

datetime.iso_8601_datetime_to_nsec(iso_8601_datetime)¶

Преобразует строковое представление даты и времени в наносекунды.

Parameters

iso_8601_datetime (string) –

дата и время в формате ISO 8601. Доступные форматы строки:

yyyy-MM-dd'T'HH:mm:ss.SSSZZZZZ
yyyy-MM-dd'T'HH:mm:ssZZZZZ
yyyy-MM-dd'T'HH:mm:ss
yyyy-MM-dd'T'HHmmss.SZZZZZ
yyyy-MM-dd'T'HHmmssZZZZZ
yyyy-MM-dd'T'HHmmss.SSS
yyyy-MM-dd'T'HHmmss

Returns

число наносекунд

Return type

cdata

datetime.iso_8601_date_to_nsec(iso_8601_date)¶

Преобразует строковое представление даты в наносекунды.

Parameters: iso_8601_date (string) – дата в формате ISO 8601 вида yyyy-MM-dd
Returns: число наносекунд
Return type: cdata

datetime.iso_8601_time_to_nsec(iso_8601_time)¶

Преобразует строковое представление времени в наносекунды.

Parameters: iso_8601_time (string) – время в формате ISO 8601. Доступные форматы: HH:mm:ss.SSS, HH:mm:ss.
Returns: число наносекунд
Return type: cdata

datetime.iso_8601_day_of_week_to_number(iso_8601_day_of_week)¶

Преобразует строковое представление дня недели в число от 1 до 7, где 1 – воскресенье, а 7 – суббота.

Parameters: iso_8601_day_of_week (string) – день недели в формате ISO 8601 (например, “Sunday”, “Sun”)
Returns: число от 1 до 7
Return type: number

datetime.custom_datetime_str_to_nsec(date_str, format_str)¶

Преобразует заданное шаблоном строковое представление даты или даты и времени в наносекунды.

Parameters

date_str (string) – дата или дата и времени
format_str (string) – шаблон строки

Returns

число наносекунд

Return type

cdata

datetime.millisec_to_formatted_datetime(datetime_millisec, datetime_format_str)¶

Преобразует миллисекунды в заданное шаблоном строковое представление даты и времени.

Parameters

datetime_millisec (number) – время в миллисекундах
datetime_format_str (string) – шаблон строки даты и времени

Returns

дата и время, заданные шаблоном

Return type

string

datetime.to_sec(nsec)¶

Преобразует наносекунды в секунды и приводит к типу number.

Parameters: nsec (cdata) – число наносекунд
Returns: число секунд
Return type: number

datetime.to_millisec(nsec)¶

Преобразует наносекунды в миллисекунды и приводит к типу number.

Parameters: nsec (cdata) – число наносекунд
Returns: число миллисекунд
Return type: number

datetime.seconds_since_midnight()¶

Returns: число секунд с начала суток по Гринвичу (GMT)
Return type: number

datetime.curr_date_nsec()¶

Метка времени (Unix timestamp) в наносекундах, соответствующая началу текущих суток UTC. Например, для времени и даты 01.01.2023 15:42 вернется метка, соответствующая 01.01.2023 00:00.

Returns: Unix timestamp в наносекундах
Return type: cdata

Набор констант, которые используются для работы со временем:

NSEC_IN_SEC – число наносекунд в секунде;
NSEC_IN_MILLISEC – число наносекунд в миллисекунде;
NSEC_IN_DAY – число наносекунд в сутках.

timezone¶

Модуль timezone содержит функции для работы с часовыми поясами.

timezone.now()¶

Returns: текущее время по Гринвичу (GMT) в наносекундах
Return type: cdata

timezone.seconds_since_midnight(timezone_id)¶

Parameters: timezone_id (string) – ID часового пояса
Returns: число секунд с начала текущих суток для указанного часового пояса
Return type: number

timezone.curr_date_nsec(timezone_id)¶

Метка времени (Unix timestamp) в наносекундах, соответствующая началу текущих местных суток для указанного часового пояса.

Parameters: timezone_id (string) – ID часового пояса
Returns: Unix timestamp в наносекундах
Return type: cdata

Version:

Работа с датами и временем¶

datetime¶

timezone¶