Для разработчиков > Серверные скрипты > Описание функций > Дата и время

"Для разработчиков", "Серверные скрипты", "Описание функций", "Дата и время", "FormatDateTime".

Преобразование даты и времени в форматированную текстовую строку.

Синтаксис

function FormatDateTime(sFormat: string; dt: double): string;

Параметры и возвращаемые значения

Параметр	Тип	Значение
sFormat	string	формат, по которому значение переменной даты и времени будет преобразовано в текстовую строку;
dt	double	дата и время.

Символы для форматирования

y либо yy	год, последние две цифры;
yyyy	год, 4 цифры;
m	номер месяца без "0" впереди, если месяц меньше октября;
mm	номер месяца с ведущим нулём;
mmm	короткое название месяца;
mmmm	полное название месяца;
d	дата, число;
dd	дата с ведущим нулём, если число меньше 10;
ddd	короткое название дня недели;
dddd	полное название дня недели;
ddddd	дата в коротком формате ("21.11.2015");
dddddd	дата в полном формате ("21 Ноябрь 2015 г.");

c	дата и время в коротком формате ("21.11.2015 18:33:50");
h	часы, без ведущего нуля;
hh	часы, с ведущим нулём;
n	минуты, без ведущего нуля;
nn	минуты, с ведущим нулём;
s	секунды, без ведущего нуля;
ss	секунды, с ведущим нулём;
z	миллисекунды, без ведущего нуля;
zzz	миллисекунды, с ведущими нулями ("007");
t	время в коротком формате, без секунд ("18:36");
tt	время в полном формате ("18:36:52");

am/pm	вставлять "am" либо "pm", в зависимости о того, время до 12 дня или после (12-часовой формат времени);
a/p	то же самое, только вставляются буквы "a" либо "m";
ampm	использовать 12-часовой формат времени вместо 24-часового;
/	использовать системный разделитель даты;
:	использовать системный разделитель времени.

Результат функции

Текстовая строка.

Пример

var
  dt: double;
begin
  dt := Now;
 
 // работа с датами
  mLogScript(FormatDateTime('d/m/y', dt), 'd/m/y');
  mLogScript(FormatDateTime('dd/mm/yy', dt), 'dd/mm/yy');
  mLogScript(FormatDateTime('ddd d mmm yyyy', dt), 'ddd d mmm yyyy');
  mLogScript(FormatDateTime('dddd, d, mmmm yyyy', dt), 'dddd, d, mmmm yyyy');
  mLogScript(FormatDateTime('ddddd ', dt), 'ddddd');
  mLogScript(FormatDateTime('dddddd', dt), 'dddddd');
  mLogScript(FormatDateTime('c', dt), 'c');
  
  // работа со временем
  mLogScript(FormatDateTime('h:n:s.z', dt), 'h:n:s.z');
  mLogScript(FormatDateTime('hh:nn:ss.zzz', dt), 'hh:nn:ss.zzz');
  mLogScript(FormatDateTime('t', dt), 't');
  mLogScript(FormatDateTime('tt', dt), 'tt');
  mLogScript(FormatDateTime('c', dt), 'c');
end.

Результат работы скрипта

[19:01:19] (Log "test"): [d/m/y] 21.11.15

[19:01:19] (Log "test"): [dd/mm/yy] 21.11.15

[19:01:19] (Log "test"): [ddd d mmm yyyy] Сб 21 ноя 2015

[19:01:19] (Log "test"): [dddd, d, mmmm yyyy] суббота, 21, Ноябрь 2015

[19:01:19] (Log "test"): [ddddd] 21.11.2015

[19:01:19] (Log "test"): [dddddd] 21 Ноябрь 2015 г.

[19:01:19] (Log "test"): [c] 21.11.2015 19:01:19

[19:01:19] (Log "test"): [h:n:s.z] 19:1:19.513

[19:01:19] (Log "test"): [hh:nn:ss.zzz] 19:01:19.513

[19:01:19] (Log "test"): [t] 19:01

[19:01:19] (Log "test"): [tt] 19:01:19