ЛИНТЕР

Форматное преобразование даты в строку

Прототип

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);
…