...
- Если обе даты заданы количеством секунд, то функция вернёт их разность в виде числ числа секунд.
- Если обе даты заданы строкой, то будет возвращено целое число равное разности между датами в секундах.
- Если первый аргумент задан строкой даты, а второй числом секунд, то результатом будет новая дата равная разности даты и числа секунд.
- Если второй аргумент задан строкой даты, а первый числом секунд, то результатом будет ошибка.
...
| Блок кода | ||
|---|---|---|
| ||
$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 |
dt.format(dt int|string, format string) string
Назначение: форматирует дату согласно заданному формату.
Аргументы:
- dt - дата заданная строкой или числом секунд.
- format - строка определяющая формат даты и времени.
Возвращаемое значение: возвращает строку даты в заданном формате.
Допустимые параметры форматирования:
| Символ в строке format | Описание | Пример возвращаемого значения |
|---|---|---|
| Год | ||
| y | Полное числовое представление года, не менее 4 цифр | 1999, 2012, 10208 |
| yy | Две последние цифры года c дополнением нулями если необходимо | 99, 05 |
| Месяц | ||
| M | Порядковый номер месяца без ведущего нуля | от 1 до 12 |
| MM | Порядковый номер месяца с ведущим нулём | от 01 до 12 |
| День | ||
| d | День месяца без ведущего нуля | от 1 до 31 |
| dd | День месяца, 2 цифры с ведущим нулём | от 01 до 31 |
| Час | ||
| h | Часы в 12-часовом формате без ведущего нуля | от 1 до 12 |
| hh | Часы в 12-часовом формате с ведущим нулём | от 01 до 12 |
| H | Часы в 24-часовом формате без ведущего нуля | от 0 до 23 |
| HH | Часы в 24-часовом формате с ведущим нулём | от 00 до 23 |
| Минуты | ||
| m | Минуты без ведущего нуля | от 0 до 59 |
| mm | Минуты с ведущим нулём | от 00 до 59 |
| Секунды | ||
| s | Секунды без ведущего нуля | от 0 до 59 |
| ss | Секунды с ведущим нулём | от 00 до 59 |
Примечание: если строка формата содержит символы совпадающие с вышеперечисленными, но не являющиеся параметрами форматирования, то их следует экранировать с помощью символа обратного слэша "\".
| Блок кода | ||
|---|---|---|
| ||
$dt = dt.format('2022-12-20 08:34:05', 'y.MM.dd h-mm-ss') // $dt будет содержать строку "22.12.20 8-34-05"
$dt = dt.format('16:30:47', '\Hour\s and \minute\s: HH/mm') // $dt будет содержать строку "Hours and minutes: 16/30" |
date.nearFuture(day int) string
...