asctime, _wasctime

Преобразование a tm время структуру в командную строку.Более безопасные версии этих функций доступны; см. asctime_s, _wasctime_s.

char *asctime( 
   const struct tm *timeptr 
);
wchar_t *_wasctime( 
   const struct tm *timeptr 
);

Параметры

  • timeptr
    Структура времени и даты.

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

asctime возвращает указатель к результату символьные строки; _wasctime возвращает указатель к результату характерной черты.Возвращаемое значение ошибки.

Заметки

Более безопасные версии этих функций доступны; см. asctime_s, _wasctime_s.

asctime функция преобразует время, которые хранятся в виде структуры в командную строку.timeptr значение обычно извлекаются из вызова gmtime OR localtime, оба возвращают указатель на a tm структура, указанная в TIME.H.

элемент timeptr

Значение

tm_hour

Количество часов, истекших после полуночи (0-23)

tm_isdst

Положительное значение, если фактически относится к летнему времени; 0, если летнее время не действует. недостаток если состояние летнего времени неизвестно.Библиотека времени выполнения c использует правила Соединенных Штатов для реализации вычисление летнего времени не).

tm_mday

День месяца (1-31)

tm_min

Минуты после часа (0-59)

tm_mon

Месяц (0-11; январь = 0)

tm_sec

С помощью секунды после минута (0-59)

tm_wday

День недели (0-6; воскресенье = 0)

tm_yday

День года (0-365; 1-ое января = 0)

tm_year

Year (текущий год минус 1900)

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

Строковый результат generated by asctime содержит ровно 26 символов и имеет форму Wed Jan 02 02:03:55 1980\n\0.24 Часовой часы используется.Все поля имеющих постоянной шириной.Символ перевода строки и нуль-символ занимают 2 последних позиции строки.asctime использует единственный статически выделенный буфер для хранения возвращенную строку.Каждый вызов этой функции уничтожает результат предыдущего вызова.

_wasctime версия расширенных символов asctime._wasctime и asctime поступайте совпадают, в противном случае.

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

Сопоставление Родов-Текста обычного

Подпрограмма TCHAR.H

_MBCS не заданные _UNICODE &

Указанный символ _MBCS

Указанный _UNICODE

_tasctime

asctime

asctime

_wasctime

Требования

Процедура

Обязательный заголовок

asctime

<time.h>

_wasctime

<time.h> OR <wchar.h>

Пример

Эта программа устанавливает системное время в длинном целом числе aclock, преобразует его в структуру newtime затем преобразовать его в форме строки для вывода с помощью asctime функция.

// crt_asctime.c
// compile with: /W3

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

int main( void )
{
    struct tm   *newTime;
    time_t      szClock;

    // Get time in seconds
    time( &szClock );

    // Convert time to struct tm form 
    newTime = localtime( &szClock );

    // Print local time as a string.
    printf_s( "Current date and time: %s", asctime( newTime ) ); // C4996
    // Note: asctime is deprecated; consider using asctime_s instead
}
  

Эквивалент в .NET Framework

См. также

Ссылки

Управление временем

ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

_ftime, _ftime32, _ftime64

gmtime, _gmtime32, _gmtime64

localtime, _localtime32, _localtime64

time, _time32, _time64

_tzset

asctime_s, _wasctime_s