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