Расчеты со временем

Эти функции выполняют календарные вычисления, используя значения времени (см. Время суток). Как и в любом значении времени, значение nil для любого из их аргументов со значением времени означает текущее системное время, а одно число обозначает количество секунд с эпохи.

Функция: time-less-p t1 t2

Эта функция возвращает t если значение времени t1 меньше значения времени t2. Результат равен nil если какой-либо из аргументов является NaN.

Функция: time-equal-p t1 t2

Эта функция возвращает t если значения t1 и t2 равны. Результат равен nil если какой-либо из аргументов является NaN.

Функция: time-subtract t1 t2

Эта функция возвращает разность времени t1 - t2 между двумя значениями времени, как значение времени Lisp. Результат точный, и его разрешение по времени не хуже, чем у наихудшего разрешения двух аргументов. Результатом является число с плавающей точкой только в случае бесконечности или NaN. Если вам нужна разность в единицах прошедших секунд, вы можете преобразовать её с помощью time-convert или float-time. См. Преобразование времени.

Функция: time-add t1 t2

Эта функция возвращает сумму двух значений времени, используя те же правила преобразования, что и time-subtract. Один аргумент должен представлять разность времени, а не точку во времени, как значение времени, которое часто является просто целым числом прошедших секунд. Вот как добавить количество секунд к значению времени:

(time-add time seconds)

Функция: time-to-days time-value

Эта функция возвращает количество дней между началом года 1 и time-value, предполагая стандартную часовую зону. Операционная система ограничивает диапазон значений времени и часовых зон.

Функция: time-to-day-in-year time-value

Эта функция возвращает номер дня в году, соответствующий time-value, предполагая стандартную часовую зону. Операционная система ограничивает диапазон значений времени и часовых зон.

Функция: date-leap-year-p year

Эта функция возвращает t если year високосный год.

Функция: date-days-in-month year month

Возвращает количество дней в месяце month в году year. Например, февраль 2020 года имеет 29 дней.

Функция: date-ordinal-to-time year ordinal

Возвращает дату ordinal в году year в виде декодированной структуры времени. Например, 120-й день 2004 года — 29 апреля.