...

• Если обе даты заданы количеством секунд, то функция вернёт их разность в виде числ секунд.
• Если обе даты заданы строкой, то будет возвращено целое число равное разности между датами в секундах.
• Если первый аргумент задан строкой даты, а второй числом секунд, то результатом будет новая дата равная разности даты и числа секунд.
• Если второй аргумент задан строкой даты, а первый числом секунд, то результатом будет ошибка.

Аргументы:

1. d1 - строка представляющая собой дату в одном из допустимых форматов или целое число соответствующее количеству секунд.
2. d2 - аналогично первому аргументу.

...

$d = dt.sub(100, 50)                                      // $d содержит 50
$d = dt.sub("2022-01-01 12:30:00", 3600)                  // $d содержит строку "2022-01-01 11:30:00"
$d = dt.sub(3600, "2022-01-01 12:30:00")                  // Такой вызов недопустим и приведёт к остановке программы
$d = dt.sub("2022-01-01 01:00:00", "2022-01-01 00:00:00") // $d содержит 3600

date.nearest(day int) string

Назначение: возвращает ближайшую к текущей дату по заданному дню.

Аргументы:

1. day - число дней для определения ближайшей даты.

Возвращаемое значение: возвращает ближайшую к day дату.

// Допустим сейчас 2022-08-20
$d = date.nearest(25) // $d содержит 2022-08-25
$d = date.nearest(10) // $d содержит 2022-09-10

Функции для работы с фактами

...