ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Статья
04/10/2013

Преобразовать значение времени в строке и обработка параметров зона локального времени.Более безопасные версии этих функций доступны; см. ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s.

char *ctime( 
   const time_t *timer 
);
char *_ctime32( 
   const __time32_t *timer )
;
char *_ctime64( 
   const __time64_t *timer )
;
wchar_t *_wctime( 
   const time_t *timer 
);
wchar_t *_wctime32( 
   const __time32_t *timer
);
wchar_t *_wctime64( 
   const __time64_t *timer 
);

Параметры

timer
Указатель к хранимому времени.

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

Указатель к результату символьной строки.NULL возвращает, если:

time представляет дату перед полночью 1-ое января 1970, в формате UTC.
При использовании _ctime32 OR _wctime32 и time представляет дату после 03:14. 7-ое января 19, 2038.
При использовании _ctime64 OR _wctime64 и time представляет дату после 23:59. 59 - 31-ое декабря 3000, в формате UTC.

ctime встроенная функция, которая принимает значение _ctime64и time_tравно __time64_t.Если необходимо принудительно компилятора интерпретировать time_tнапример, старое пакетом обновления 32 (sp2) time_tможно указать _USE_32BIT_TIME_T.Это вызовет ctimeвыдавать _ctime32.Это не рекомендуется, поскольку приложение может завершиться ошибкой после 18-ого января 2038 и не разрешено на платформах с пакетом обновления 64 (sp2).

Заметки

ctime функция преобразует значение времени, которые хранятся в виде a time_t значение в строку символов.timer значение обычно извлекаются из вызова Время, который возвращает число секунд, прошедшего с полуночи (00:00: 00, 1-ое января 1970), координируемый всемирное время (UTC).Строка возвращаемого значения содержит только 26 символов и имеет форму:

Wed Jan 02 02:03:55 1980\n\0

24 Часовой часы используется.Все поля имеющих постоянной шириной.Символ перевода строки (" \ n ") и нуль-символ (" \ 0 ") занимают 2 последних позиции строки.

Преобразованная строка символов кроме того, которым регулируется согласно параметрам зона локального времени.См. time" _ftimeи localtime функции дополнительные сведения о настройке локального времени и _tzset функция дополнительные сведения об определении среду и глобальные переменные часового пояса.

Вызов ctime изменяет один выделенный буфер, используемый статически gmtime и localtime функции.Каждый вызов к одной из этих подпрограмм уничтожает результат предыдущего вызова.ctime совместно использует буфер со статическими asctime функция.Таким образом, вызов ctime уничтожает результаты любого предыдущего вызова asctime" localtimeили gmtime.

_wctime и _wctime64 версия расширенных символов ctime и _ctime64; возвращение указателя на характерной чертой.В противном случае - _ctime64" _wctimeи _wctime64 поступайте идентично ctime.

Эти функции проверяют их параметры.If timer указатель null или таймера если значение отрицательное, вызывающие эти функции недопустимы обработчик параметра, как описано в разделе Проверка параметров.Если выполнение может быть продолжено, то функции возвращают NULL и errno В EINVAL.

Сопоставления подпрограммы Родов-Текста

Подпрограмма TCHAR.H	_MBCS не заданные _UNICODE &	Указанный символ _MBCS	Указанный _UNICODE
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

Требования

Процедура	Обязательный заголовок
ctime	<time.h>
_ctime32	<time.h>
_ctime64	<time.h>
_wctime	<time.h> OR <wchar.h>
_wctime32	<time.h> OR <wchar.h>
_wctime64	<time.h> OR <wchar.h>

Дополнительные сведения о совместимости см. Совместимость во введении.

Пример

// crt_ctime64.c
// compile with: /W3
/* This program gets the current
 * time in _time64_t form, then uses ctime to
 * display the time in string form.
 */

#include <time.h>
#include <stdio.h>

int main( void )
{
   __time64_t ltime;

   _time64( &ltime );
   printf( "The time is %s\n", _ctime64( &ltime ) ); // C4996
   // Note: _ctime64 is deprecated; consider using _ctime64_s
}