asctime_s, _wasctime_s

Преобразуют структуру времени tm в символьную строку. Здесь представлены версии asctime, _wasctime с усовершенствованной безопасностью, как описано в разделе Функции безопасности в CRT.

errno_t asctime_s( 
   char* buffer,
   size_t numberOfElements,
   const struct tm *_tm 
);
errno_t _wasctime_s( 
   wchar_t* buffer,
   size_t numberOfElements
   const struct tm *_tm 
);
template <size_t size>
errno_t asctime_s( 
   char (&buffer)[size],
   const struct tm *_tm 
); // C++ only
template <size_t size>
errno_t _wasctime_s( 
   wchar_t (&buffer)[size],
   const struct tm *_tm 
); // C++ only

Параметры

• buffer
  [out] Указатель на буфер для хранения полученной символьной строки. Эта функция принимает указатель на допустимое расположение в памяти, размер которого указан в numberOfElements.

• numberOfElements
  [in] Размер буфера, используемого для хранения результатов.

• _tm
  [in] Структура даты/времени. Эта функция принимает указатель на допустимый объект struct tm.

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

Ноль, если успешно. Если проверка завершается с ошибкой, то вызывается обработчик недопустимого параметра, как описано в Проверка параметров. Если выполнение может быть продолжено, функция возвращает код ошибки. Коды ошибок определенны в ERRNO.H. Для получения дополнительной информации см. Константы errno. Фактические коды ошибок, возвращаемые для каждого условия ошибки, отображены в следующей таблице.

Условия возникновения ошибки

Заметки

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

Преобразованная символьная строка также настраивается согласно параметрам зоны локального времени. Обратитесь к функциям time, _time32, _time64, _ftime, _ftime32, _ftime64 и localtime_s, _localtime32_s, _localtime64_s за сведениями о настройке местного времени и к функции _tzset за сведениями об определении среды временной зоны и глобальных переменных.

Итоговая строка, полученная с помощью asctime_s, содержит ровно 26 символов и имеет вид Wed Jan 02 02:03:55 1980\n\0. Время в 24-часовом формате. Все поля имеют постоянную ширину. Символ новой строки и нуль-символ занимают две последние позиции строки. Значение, переданное в качестве второго параметра, должно иметь по крайней мере такое значение. Если оно меньше, то будет возвращен код ошибки EINVAL.

_wasctime_s — это двухбайтовая версия asctime_s. В остальных случаях поведение _wasctime_s и asctime_s идентично.

Универсальное текстовое сопоставление функций

В C++ использование этих функций упрощено шаблонными перегрузками; перегрузки могут определить длину буфера автоматически, устранена необходимость указывать аргумент size. Дополнительные сведения см. в разделе Безопасные перегрузки шаблонов.

Требования

Безопасность

Если указатель буфера не NULL и указатель не указывает на допустимый буфер, функция перезапишет все в указанном месте. Это также может привести к нарушению доступа.

buffer overrun может возникать, если переданный аргумент size превышает фактический размер буфера.

Пример

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

// crt_asctime_s.c
#include <time.h>
#include <stdio.h>

struct tm newtime;
__time32_t aclock;

int main( void )
{
   char buffer[32];
   errno_t errNum;
   _time32( &aclock );   // Get time in seconds.
   _localtime32_s( &newtime, &aclock );   // Convert time to struct tm form.

   // Print local time as a string.

   errNum = asctime_s(buffer, 32, &newtime);
   if (errNum)
   {
       printf("Error code: %d", (int)errNum);
       return 1;
   }
   printf( "Current date and time: %s", buffer );
   return 0;
}

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

• DateTime.ToLongDateString

• DateTime.ToLongTimeString

• DateTime.ToShortDateString

• DateTime.ToShortTimeString

• DateTime.ToString

См. также

Ссылки

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

ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s

_ftime, _ftime32, _ftime64

gmtime_s, _gmtime32_s, _gmtime64_s

localtime_s, _localtime32_s, _localtime64_s

time, _time32, _time64

_tzset