Spec-Zone.ru › C

Заголовок стандартной библиотеки <time.h>

Этот заголовок входит в библиотеку средств работы с датой и временем.

Функции

Работа со временем
difftime
вычисляет разницу между моментами времени
(функция)
time
возвращает текущее календарное время системы в виде времени, прошедшего с начала эпохи
(функция)
clock
возвращает значение тактов процессора с момента запуска программы
(функция)
timespec_get
(C11)
возвращает календарное время в секундах и наносекундах на основе заданной основы времени
(функция)
timespec_getres
(C23)
возвращает разрешение календарного времени на основе заданной основы времени
(функция)
Преобразование форматов
asctimeasctime_s
(устарела в C23)(C11)
преобразует объект tm в текстовое представление
(функция)
ctimectime_s
(устарела в C23)(C11)
преобразует объект time_t в текстовое представление
(функция)
strftime
преобразует объект tm в пользовательское текстовое представление
(функция)
gmtimegmtime_rgmtime_s
(C23)(C11)
преобразует время, прошедшее с начала эпохи, в календарное время по всемирному координированному времени (UTC)
(функция)
localtimelocaltime_rlocaltime_s
(C23)(C11)
преобразует время, прошедшее с начала эпохи, в календарное местное время
(функция)
mktime
преобразует календарное время во время, прошедшее с начала эпохи
(функция)
timegm
(C23)
преобразует календарное время во время, прошедшее с начала эпохи, игнорируя флаг перехода на летнее время
(функция)

Константы

CLOCKS_PER_SEC
количество тактов процессора в секунду
(макроконстанта)

Типы

tm
тип календарного времени
(структура)
time_t
тип календарного времени, прошедшего с начала эпохи
(определение типа)
clock_t
тип процессорного времени, прошедшего с начала отсчёта
(определение типа)
timespec
(C11)
время в секундах и наносекундах
(структура)

Сводка

#define __STDC_VERSION_TIME_H__ 202311L

#define NULL           /* see description */
#define CLOCKS_PER_SEC /* see description */
#define TIME_UTC       /* see description */

typedef /* see description */ clock_t;
typedef /* see description */ size_t;
typedef /* see description */ time_t;

struct timespec { /* see description */ };
struct tm { /* see description */ };

clock_t clock(void);
double difftime(time_t time1, time_t time0);
time_t mktime(struct tm* timeptr);
time_t timegm(struct tm* timeptr);
time_t time(time_t* timer);
int timespec_get(struct timespec* ts, int base);
int timespec_getres(struct timespec* ts, int base);
[[deprecated]] char* asctime(const struct tm* timeptr);
[[deprecated]] char* ctime(const time_t* timer);
struct tm* gmtime(const time_t* timer);
struct tm* gmtime_r(const time_t* timer, struct tm* buf);
struct tm* localtime(const time_t* timer);
struct tm* localtime_r(const time_t* timer, struct tm* buf);
size_t strftime(char* restrict s, size_t maxsize, const char* restrict format,
const struct tm* restrict timeptr);

Только если это поддерживается реализацией:

#define TIME_MONOTONIC /* see description */
#define TIME_ACTIVE    /* see description */

Только если поддерживаются потоки и это поддерживается реализацией:

#define TIME_THREAD_ACTIVE /* see description */

Только если реализация определяет __STDC_LIB_EXT1__ и пользовательский код дополнительно определяет __STDC_WANT_LIB_EXT1__ до любого включения <time.h>:

#ifdef __STDC_WANT_LIB_EXT1__
typedef /* see description */ errno_t;
typedef /* see description */ rsize_t;

errno_t asctime_s(char* s, rsize_t maxsize, const struct tm* timeptr);
errno_t ctime_s(char* s, rsize_t maxsize, const time_t* timer);
struct tm* gmtime_s(const time_t* restrict timer, struct tm* restrict result);
struct tm* localtime_s(const time_t* restrict timer, struct tm* restrict result);
#endif

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/c/header/time

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API