formatTime()

Возвращает значения времени в определенном формате.

Краткое описание

string formatTime ( string format, time t [, string milliFormat] );

Параметры

ПараметрыОписание
formatВыходной формат (без миллисекунд) или в формате HTTP. В случае указания формата «HTTP», функция возвращает значение времени в формате HTTP, а значения миллисекунд (строка «milliFormat») — игнорируются (см. RFC 2616).
ttime
milliFormatВыходной формат для миллисекунд

Возвращаемое значение

Функция возвращает новый формат времени в качестве строки или, в случае возникновения ошибок, пустую строку.

Ошибки

Неверные типы переменной или недействительные аргументы

Описание

Функция formatTime() возвращает значение времени t , указанное как time , в формате, определяемом аргументами format и milliFormat. Строка format содержит форматирование с точностью до секунд. Доступными для этого параметрами являются параметры функции strftime() стандарта ANSI C:
ПараметрыЗначение
%aСокращенное название дня недели
%AПолное название дня недели
%bСокращенное имя месяца
%BПолное имя месяца
%cМестный способ представления даты и времени
%dДата месяца (01 — 31)
%HЧас (00 — 23)
%IЧас (00 -12)
%jДень в году (01 — 366)
%mМесяц (01 — 12)
%MМинута (00 — 59)
%pМестный аналог AM (утро) или PM (дневное время)
%SСекунда (00 — 59)
%UНеделя в году (воскресенье — первый день недели) (00 — 53)
%wДень недели (0-6, воскресенье — 0!)
%WНеделя в году (понедельник — первый день недели) (00 — 53)
%xМестный способ представления даты
%XМестный способ представления времени
%yГод, без столетия (00 — 99)
%YГод с указанием столетия
%ZНазвание часового пояса, если существует
%%%
Формат fprintf() используется в дополнительной строке milliFormat для определения миллисекунд. Соответствующее выходное значение добавляется к выражению, сформированному первой спецификацией формата.
ЗначокПРИМЕР
Нижеуказанный пример формирует значение недели в году, дату и время по местному времени (localTime), а также универсальное глобальное время (utcTime).
main()
{
  time t1;
 
  string localTime;
  string utcTime;
 
  setTime(t1,2010,6,1,15);
 
  localTime = formatTime(«%W; %c», t1, » ms: %04d»);
  utcTime = formatTimeUTC(«%W; %c», t1, » ms: %04d»);
 
  DebugN(«Local: «, localTime);
//Результат: [«Local: «][«22; 6/1/2010 3:00:00 PM ms: 0000»]
  DebugN(«UTC: «, utcTime);
//Результат: [«UTC: «][«22; 6/1/2010 1:00:00 PM ms: 0000»]
}

Используется для объекта

Функция времени

Доступность

 CTRL

См. также

formatTimeUTC()

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *