Возвращает значения времени в определенном формате. |
Краткое описание
string formatTime ( string format, time t [, string milliFormat] ); |
Параметры
Параметры | Описание |
format | Выходной формат (без миллисекунд) или в формате HTTP. В случае указания формата «HTTP», функция возвращает значение времени в формате HTTP, а значения миллисекунд (строка «milliFormat») — игнорируются (см. RFC 2616). |
t | time |
milliFormat | Выходной формат для миллисекунд |
Возвращаемое значение
Функция возвращает новый формат времени в качестве строки или, в случае возникновения ошибок, пустую строку. |
Ошибки
Неверные типы переменной или недействительные аргументы |
Описание
Функция formatTime() возвращает значение времени t , указанное как time , в формате, определяемом аргументами format и milliFormat. Строка format содержит форматирование с точностью до секунд. Доступными для этого параметрами являются параметры функции strftime() стандарта ANSI C: |
Формат 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 |
См. также