time()

Определить текущее календарное время

Прототип:

#include <time.h>
time_t time( time_t *tloc );

Аргументы:

tloc
NULL, или указатель на переменную типа time_t, в которую будет записано текущее календарное время.

Библиотека:

libc

Описание:

Функция time() принимает аргументом указатель на time_t и возвращает значение текущего времени в секундах, начиная с т.н. Эпохи UNIX (00:00:00 1-го января 1970 года по скоординированному универсальному времени (UTC) (также известному как время по Гринвичу или GMT).

Для установки часов на компьютере обычно используется команда date. Переменные окружения TZ или _CS_TIMEZONE определяют локальную временную зону.

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

Текущее календарное время в секундах, начиная с 00:00:00 1-го января 1970 года по UTC. Если параметр tloc не равен NULL, то это время также будет сохранено в переменной, на которую указывает tloc.

Примеры:

#include <stdio.h>
#include <stdlib.h>
#include <time.h>
int main( void )
{
time_t time_of_day;
time_of_day = time( NULL );
printf( "Текущее время: %s", ctime( &time_of_day ) );
return (EXIT_SUCCESS);
}

Код генерирует следующий вывод:

$ ./a.out Текущее время: Wed Jun 30 09:09:33 1999

Классификация:

ANSI, POSIX 1003.1

Безопасность использования
Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

time_t, asctime(), asctime_r(), clock(), clock_gettime(), ctime(), difftime(), gmtime(), localtime(), localtime_r(), mktime(), strftime(), tzset()




Предыдущий раздел: Описание API системной библиотеки