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', '-', ':');