Программирование: GetDateTimeString

Прототип

function GetDateTimeString(const DateTimeFormat: String; const DateSeparator, TimeSeparator: Char): String;

Описание

Возвращает строковое значение текущей даты и времени в указанном формате. В параметре DateTimeFormat указывается желаемый формат даты/времени в виде спецификатора (см. ниже). В параметрах DateSeparator и TimeSeparator передаются соответственно символы разделения элементов даты и времени.

Поддерживаются следующие спецификаторы формата:

d Номер дня без начального нуля (1-31).
dd Номер дня с начальным нулем (01-31).
ddd Сокращенное название дня недели (Sun-Sat).
dddd Полное название дня недели (Sunday-Saturday).
ddddd Системная дата в сокращенном формате.
dddddd Системная дата в полном формате.
m Номер месяца без начального нуля (1-12). Если спецификатор m следует сразу за спецификаторами h или hh, то вместо месяца будут выведены минуты.
mm Номер месяца с начальным нулем (01-12). Если спецификатор m следует сразу за спецификаторами h или hh, то вместо месяца будут выведены минуты.
mmm Сокращенное название месяца (Jan-Dec).
mmmm Полное название месяца (January-December).
yy Двузначное число года (00-99).
yyyy Четырехзначное число года (0000-9999).
h Время часов без начального нуля (0-23).
hh Время часов с начальным нулем (00-23).
n Время минут без начального нуля (0-59).
nn Время минут с начальным нулем (00-59).
s Время секунд без начального нуля (0-59).
ss Время секунд с начальным нулем (00-59).
t Системное время в сокращенном формате.
tt Системное время в полном формате.
am/pm Установка 12-часового формата времени для указания часов (h или hh) и вывод сокращений: am - до полудня, pm - после полудня. Этот спецификатор является регистрозависимым. В зависимости от заданного регистра спецификатора, в соответствующем регистре будет выведен результат (am/pm, AM/PM или am/PM и наоборот).
a/p Установка 12-часового формата времени для указания часов (h или hh) и вывод сокращений: a - до полудня, p - после полудня. Этот спецификатор является регистрозависимым. В зависимости от заданного регистра спецификатора, в соответствующем регистре будет выведен результат (a/p, A/P или a/P и наоборот).
/ Установка символа разделителя для составляющих даты (DateSeparator). Если DateSeparator не указан (пустой), то будет использован разделитель системной даты.
: Установка символа разделителя для составляющих времени (TimeSeparator). Если TimeSeparator не указан (пустой), то будет использован разделитель системного времени.
'xx'/"xx" Символы, заключенные в одинарные или двойные кавычки, выводятся как есть, без учета условий форматирования спецификаторов.

Спецификаторы формата могут быть записаны как в верхнем регистре, так и в нижнем регистре — оба дают одинаковый результат.

Пример

GetDateTimeString('ddddd', #0, #0);
GetDateTimeString('ddddd tt', #0, #0);
GetDateTimeString('dd/mm/yyyy hh:nn:ss', '-', ':');