Share via

format_datetime()

  • Статья

Форматирует дату и время в соответствии с указанным форматом.

Синтаксис

format_datetime(Дата,Формат)

Дополнительные сведения о соглашениях о синтаксисе.

Параметры

Имя Тип Обязательно Описание
date datetime ✔️ Форматируемое значение.
format string ✔️ Выходной формат, состоящий из одного или нескольких поддерживаемых элементов формата.

Поддерживаемые элементы формата

Параметр format должен включать один или несколько из следующих элементов:

Спецификатор формата Описание Примеры
d День месяца, в диапазоне от 1 до 31. 2009-06-01T13:45:30 -> 1, 2009-06-15T13:45:30 -> 15
dd День месяца, в диапазоне от 01 до 31. 2009-06-01T13:45:30 -> 01, 2009-06-15T13:45:30 -> 15
f Десятые доли секунды в значении даты и времени. 2009-06-15T13:45:30.6170000 -> 6, 2009-06-15T13:45:30.05 -> 0
ff Сотые доли секунды в значении даты и времени. 2009-06-15T13:45:30.6170000 -> 61, 2009-06-15T13:45:30.0050000 -> 00
fff Тысячные доли секунды в значении даты и времени. 15.06.2009 13:45:30.617 -> 617, 15.06.2009 13:45:30.0005 -> 000
ffff Десятитысячные доли секунды в значении даты и времени. 2009-06-15T13:45:30.6175000 -> 6175, 2009-06-15T13:45:30.0000500 -> 0000
fffff Стотысячные доли секунды в значении даты и времени. 2009-06-15T13:45:30.6175400 -> 61754, 2009-06-15T13:45:30.000005 -> 000000
ffffff Миллионные доли секунды в значении даты и времени. 2009-06-15T13:45:30.6175420 -> 617542, 2009-06-15T13:45:30.0000005 -> 0000000
fffffff Десятимиллионные доли секунды в значении даты и времени. 2009-06-15T13:45:30.6175425 -> 6175425, 2009-06-15T13:45:30.0001150 -> 0001150
F Если ненулевое значение, то десятые доли секунды в значении даты и времени. 2009-06-15T13:45:30.6170000 -> 6, 2009-06-15T13:45:30.0500000 -> (без выходных данных)
FF Если ненулевое значение, то сотые доли секунды в значении даты и времени. 2009-06-15T13:45:30.6170000 -> 61, 2009-06-15T13:45:30.0050000 -> (без выходных данных)
FFF Если ненулевое значение, то тысячные доли секунды в значении даты и времени. 2009-06-15T13:45:30.6170000 -> 617, 2009-06-15T13:45:30.0005000 -> (без выходных данных)
FFFF Если ненулевое значение, то десятитысячные доли секунды в значении даты и времени. 2009-06-15T13:45:30.5275000 -> 5275, 2009-06-15T13:45:30.0000500 -> (без выходных данных)
FFFFF Если ненулевое значение, то стотысячные доли секунды в значении даты и времени. 2009-06-15T13:45:30.6175400 -> 61754, 2009-06-15T13:45:30.00000050 -> (без выходных данных)
FFFFFF Если ненулевое значение, то миллионные доли секунды в значении даты и времени. 2009-06-15T13:45:30.6175420 -> 617542, 2009-06-15T13:45:30.0000005 -> (без выходных данных)
FFFFFFF Если ненулевое значение, то десятимиллионные доли секунды в значении даты и времени. 2009-06-15T13:45:30.6175425 -> 6175425, 2009-06-15T13:45:30.0001150 -> 000115
h Час в 12-часовом формате от 1 до 12. 2009-06-15T01:45:30 -> 1, 2009-06-15T13:45:30 -> 1
hh Час в 12-часовом формате от 01 до 12. 2009-06-15T01:45:30 -> 01, 2009-06-15T13:45:30 -> 01
H Час в 24-часовом формате от 0 до 23. 2009-06-15T01:45:30 -> 1, 2009-06-15T13:45:30 -> 13
HH Час в 24-часовом формате от 00 до 23. 2009-06-15T01:45:30 -> 01, 2009-06-15T13:45:30 -> 13
m Минуты, в диапазоне от 0 до 59. 2009-06-15T01:09:30 -> 9, 2009-06-15T13:29:30 -> 29
mm Минуты, в диапазоне от 00 до 59. 2009-06-15T01:09:30 -> 09, 2009-06-15T01:45:30 -> 45
M Месяц, в диапазоне от 1 до 12. 2009-06-15T13:45:30 -> 6
MM Месяц, в диапазоне от 01 до 12. 2009-06-15T13:45:30 -> 06
s Секунды, в диапазоне от 0 до 59. 2009-06-15T13:45:09 -> 9
ss Секунды, в диапазоне от 00 до 59. 2009-06-15T13:45:09 -> 09
y Год, в диапазоне от 0 до 99. 0001-01-01T00:00:00 -> 1, 0900-01-01T00:00:00 -> 0, 1900-01-01T00:00:00 -> 0, 2009-06-15T13:45:30 -> 9, 2019-06-15T13:45:30 -> 19
yy Год, в диапазоне от 00 до 99. 0001-01-01T00:00:00 -> 01, 0900-01-01T00:00:00 -> 00, 1900-01-01T00:00:00 -> 00, 2019-06-15T13:45:30 -> 19
yyyy Год в виде четырехзначного числа. 0001-01-01T00:00:00 -> 0001, 0900-01-01T00:00:00 -> 0900, 1900-01-01T00:00:00 -> 1900, 2009-06-15T13:45:30 -> 2009
tt Часы до и после полудня 2009-06-15T13:45:09 -> PM

Поддерживаемые разделители

Описатель формата может включать следующие разделители:

Разделитель Комментарий
' ' Пробел
'/'
'-' Штрих
':'
','
'.'
'_'
'['
']'

Возвращаемое значение

Строка с датой, заданной в формате .

Примеры

В следующих трех примерах возвращаются значения даты и времени в разном формате.

Выполнить запрос

let dt = datetime(2017-01-29 09:00:05);
print 
v1=format_datetime(dt,'yy-MM-dd [HH:mm:ss]')

Выходные данные

Версия 1
17-01-29 [09:00:05]

Выполнить запрос

let dt = datetime(2017-01-29 09:00:05);
print 
v2=format_datetime(dt, 'yyyy-M-dd [H:mm:ss]')

Выходные данные

Версия 2
2017-1-29 [9:00:05]

Выполнить запрос

let dt = datetime(2017-01-29 09:00:05);
print 
v3=format_datetime(dt, 'yy-MM-dd [hh:mm:ss tt]')

Выходные данные

Версия 3
17-01-29 [09:00:05 AM]

См. также