dt.formatФорматирует дату согласно заданному формату.
Сигнатура: dt.format(dt string|int|dt.Time, format string) -> string
Аргументы:
dt — дата в виде строки, целого числа (секунды с 1 января 1970 года) или объекта типа dt.Time.format — строка, определяющая формат вывода даты и времени.Возвращаемое значение: Строка с датой, отформатированной в соответствии с указанным шаблоном.
Пример использования:
$dt = dt.format('2022-12-20 08:34:05.123', 'y.MM.dd h-mm-ss.SSSSSS') // "22.12.20 8-34-05.123000"
$dt = dt.format('16:30:47', '\Hour\s \an\d \minute\s: hh/mm A') // "Hours and minutes: 04/30 PM"
Допустимые параметры форматирования:
Символ в строке format |
Описание | Пример значения |
|---|---|---|
| Год | ||
y |
Полное числовое представление года (не менее 4 цифр) | 1999, 2012 |
yy |
Два последних числа года, с дополнением нулями | 99, 05 |
| Месяц | ||
M |
Порядковый номер месяца без ведущего нуля | 1-12 |
MM |
Порядковый номер месяца с ведущим нулем | 01-12 |
| День | ||
d |
День месяца без ведущего нуля | 1-31 |
dd |
День месяца с ведущим нулем | 01-31 |
| Час | ||
h |
Часы в 12-часовом формате без ведущего нуля | 1-12 |
hh |
Часы в 12-часовом формате с ведущим нулем | 01-12 |
H |
Часы в 24-часовом формате без ведущего нуля | 0-23 |
HH |
Часы в 24-часовом формате с ведущим нулем | 00-23 |
a |
am или pm в нижнем регистре | am, pm |
A |
AM или PM в верхнем регистре | AM, PM |
| Минуты | ||
m |
Минуты без ведущего нуля | 0-59 |
mm |
Минуты с ведущим нулем | 00-59 |
| Секунды | ||
s |
Секунды без ведущего нуля | 0-59 |
ss |
Секунды с ведущим нулем | 00-59 |
| Милли/Микро/Нано секунды | ||
S, SS, SSS, ..., SSSSSSSSS |
Дробная часть секунды, усеченная до количества цифр | 1, 12, 123, 123456 |
| Часовой пояс | ||
Z |
Название часового пояса | UTC, PDT, BST |
z |
Смещение часового пояса в часах | +02, -01 |
zz |
Смещение часового пояса без двоеточия между часами и минутами | +0200, -0100 |
ZZ |
Смещение часового пояса с двоеточием между часами и минутами | +02:00, -01:00 |
zzz |
Смещение часового пояса без двоеточия между часами, минутами и секундами | +020000, -010000 |
ZZZ |
Смещение часового пояса с двоеточием между часами, минутами и секундами | +02:00:00, -01:00:00 |