Форматное преобразование даты в строку
Прототип
INT TICKTOSTRF ( DECIMAL D1, /* исходная дата */ CHAR * F, /* формат преобразования */ CHAR * S); /* выходная строка */
Описание
Функция TICKTOSTRF
преобразовывает дату D1
из внутреннего представления в строку S
согласно формату F
. Для спецификации форматной строки можно использовать следующие обозначения:
-
+ – признак вывода интервала (+ или - или ' ');
-
DDD
– день года; -
DD
– день месяца; -
DY
– сокращенное название дня недели; -
DAY
– название дня недели; -
D
– номер дня недели; -
MM
– номер дня в месяце; -
MI
– минута часа; -
MONTH
– название месяца; -
MON
– сокращенное название месяца; -
MS
,FFF
– миллисекунда секунды; -
YYYY
– год; -
YY
– последние две цифры года; -
HH24
,HH
– час дня (от 0 до 23); -
HH12
– час дня (от 1 до 12); -
A.M.
P.M.
AM
PM
– указатель времени до полудня или после полудня; -
SS
– секунда минуты; -
FF
– сотые доли секунды.
Если указан признак вывода знака интервала, то символьное представление интервала дат будет выдано с соответствующим знаком (+
или -
), в противном случае интервал дат выводится без знака, и представление отрицательного интервала совпадает с представлением положительного.
Примечание
Интервалы лет и месяцев могут быть получены с помощью функции TICKTOSTRF
с указанием шаблона, не содержащего других компонентов даты, кроме лет и месяцев.
Примеры
Форматы даты:
"DD-Mon-YY", "DD-Mon-YYYY", "MM/DD/YY", "MM/DD/YYYY", "DD.MM.YY", "DD.MM.YYYY" " + MM/DD/YYYY".
Форматы времени:
"HH24", "HH24:MI", "HH24:MI:SS", "HH24:MI:SS.FF".
Возвращаемое значение
-
0
– успешное завершение. -
1
– ошибка преобразования.
Пример
DECIMAL d; CHAR s[8]; INT Error; ... Error = TICKTOSTRF (d,"DD.MM.YY",s); ...