标准库头文件 <time.h>

 

C

编译器支持

语言

头文件

类型支持

程序实用工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

标准库头文件

<assert.h> <complex.h> (C99) <ctype.h> <errno.h> <fenv.h> (C99) <float.h> <inttypes.h> (C99)     <iso646.h> (C95) <limits.h> <locale.h> <math.h>

<setjmp.h> <signal.h> <stdalign.h> (C11*) <stdarg.h> <stdatomic.h> (C11)     <stdbit.h> (C23) <stdbool.h> (C99*) <stdckdint.h> (C23) <stddef.h> <stdint.h> (C99) <stdio.h>

<stdlib.h> <stdmchar.h> (C29) <stdnoreturn.h> (C11*) <string.h> <tgmath.h> (C99) <threads.h> (C11) <time.h> <uchar.h> (C11) <wchar.h> (C95) <wctype.h> (C95)

 

此头文件是 日期和时间实用工具 库的一部分。

函数

时间操作
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	将日历时间转换为自纪元以来的时间 (函数)

常量

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__ 并且用户代码在包含 <time.h> 之前额外定义了 __STDC_WANT_LIB_EXT1__ 时

#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