asctime – представление локального (местного) времени в виде текстовой строки
Синтаксис:
#include < time.h >
char *asctime (const struct tm *m_time);
Аргументы:
m_time – указатель на структуру содержащую локальное (местное) время и дату.
Возвращаемое значение:
Указатель на текстовую строку с датой и временем.
Описание:
Функция asctime () преобразует локальное (местное) время представленное в виде структуры типа struct tm, на которую указывает аргумент m_time в текстовую строку. Результат преобразования возвращается функцией в виде указатель на строку содержащую дату и время.
Преобразованная строка имеет вид: «Нед. Мес. Ден. Час:Mин:Сек Год\n\0», где:
Нед – день недель (3 символа),
Мес – название месяца (3 символа),
Ден – число (2 символа),
Час – часы (2 символа),
Мин – минуты (2 символа),
Сек – секунды (2 символа),
Год – Год (4 символа).
Структура tm содержит элементы:
int tm_sec – секунды (отсчет с 0);
int tm_min – минуты (отсчет с 0);
int tm_hour - часы (отсчет с 0);
int tm_mday - день месяца (отсчет с 1);
int tm_mon - месяц (отсчет с 0);
int tm_year – год;
int tm_wday - день недели (воскресенье - 0);
int tm_yday - день в году (отсчет с 0);
int tm_isdst - признак "летнее время" (больше нуля если «летнее время», ноль если «зимнее время», меньше нуля если нет информации.
Внимание! Не рекомендуется использовать функцию asctime () в многопоточных приложениях, так как данные функции использует общий буфер для сохранения преобразованного времени и одновременный вызов функции из разных потоков может привести к неверному результату работы. Для работы в многопоточных приложениях используйте функцию asctime _r().
Пример:
В примере определяется текущее системное время в секундах, преобразуется в локальное время (с учетом часового пояса) с помощью функции localtime, затем локальное время преобразуется в текстовую строку с помощью функции asctime и результат выводится в консоль.
#include < stdio.h > //Для printf
#include < time.h > //Для time, localtime, asctime
int main (void)
{
//Переменная для сохранения текущего системного времени
long int s_time;
//Указатель, в который будет помещен адрес структуры с
//преобразованным временем
struct tm *m_time;
//Считываем текущее системное время
s_time = time (NULL);
//Преобразуем системное время в локальное
m_time = localtime (&s_time);
// С помощью функции asctime преобразуем локальное время в строку
// и выводим результат на консоль
printf (“Время: %s\n”,asctime (m_time) );
return 0;
}
| |
Результат:
|
Время: Sat May 17 01:17:08 2014
|
Смотри так же:
asctime,
asctime_r,
clock_getres,
clock_gettime,
clock_gettime,
ctime,
ctime_r,
difftime,
gmtime,
gmtime_r,
localtime,
localtime_r,
mktime,
strftime,
time
|
