头文件<time.h>定义了两个宏,声明了四种类型和几个操作时间de函数。
1、宏:
NULL 这个宏是一个空指针常量的值。
CLOCKS_PER_SEC 这个宏表示每秒的处理器时钟个数。
2、类型:
size_t 是无符号整数类型,它是 sizeof 关键字的结果。
clock_t 这是一个适合存储处理器时间的类型。
time_t 这是一个适合存储日历时间类型。
struct tm 这是一个用来保存时间和日期的结构。
struct tm {
int tm_sec; /* 秒,范围从 0 到 59 */
int tm_min; /* 分,范围从 0 到 59 */
int tm_hour; /* 小时,范围从 0 到 23 */
int tm_mday; /* 一月中的第几天,范围从 1 到 31 */
int tm_mon; /* 月,范围从 0 到 11 */
int tm_year; /* 自 1900 年起的年数 */
int tm_wday; /* 一周中的第几天,范围从 0 到 6 */
int tm_yday; /* 一年中的第几天,范围从 0 到 365 */
int tm_isdst; /* 夏令时 */
};
3、函数:
3.1时间操纵函数
clock_t clock(void);
说明:返回程序执行起(一般为程序的开头),处理器时钟所使用的时间。
返回值:该函数返回自程序启动起,处理器时钟所使用的时间。如果失败,则返回 -1 值。
double difftime(time_t time1,time_t time0);
说明:返回 time1 和 time2 之间相差的秒数 (time1-time2)。
参数:time1 -- 这是表示结束时间的 time_t 对象。
time2 -- 这是表示开始时间的 time_t 对象。
返回值:该函数返回以双精度浮点型 double 值表示的两个时间之间相差的秒数 (time2 -
time1)。
time_t mktime(struct tm *timeptr);
说明:把 timeptr 所指向的结构转换为一个依据本地时区的 time_t 值。
参数:timeptr -- 这是指向表示日历时间的 time_t 值的指针,该日历时间被分解为以下各部
分。
返回值:该函数返回一个 time_t 值,该值对应于以参数传递的日历时间。如果发生错误,则
返回 -1 值。
time_t time(time_t *timer);
说明:计算当前日历时间,并把它编码成 time_t 格式。
参数:timer -- 这是指向类型为 time_t 的对象的指针,用来存储 timer 的值。
返回值:以 time_t 对象返回当前日历时间。
3.2时间转换函数
char *asctime(const struct tm *timeptr);
说明:返回一个指向字符串的指针,它代表了结构 timeptr 的日期和时间。
参数:timeptr 是指向 tm 结构的指针
返回值:该函数返回一个 C 字符串,包含了可读格式的日期和时间信息 Www Mmm dd hh:mm:ss
yyyy,其中,Www 表示星期几,Mmm 是以字母表示的月份,dd 表示一月中的第几天,hh:mm:ss
表示时间,yyyy 表示年份。
char *ctime(const time_t *time);
说明:返回一个表示当地时间的字符串,当地时间是基于参数 time。
参数:time -- 这是指向 time_t 对象的指针,该对象包含了一个日历时间。
返回值:该函数返回一个 C 字符串,该字符串包含了可读格式的日期和时间信息。
struct tm *gmtime(const time_t *timer);
说明:timer 的值被分解为 tm 结构,并用协调世界时(UTC)也被称为格林尼治标准时间
(GMT)表示。
参数:timer -- 这是指向表示日历时间的 time_t 值的指针。
返回值:该函数返回指向 tm 结构的指针,该结构带有被填充的时间信息。
struct tm *localtime(const time_t *timer);
说明:timer 的值被分解为 tm 结构,并用本地时区表示。
参数:timer -- 这是指向表示日历时间的 time_t 值的指针。
返回值:函数返回指向 tm 结构的指针,该结构带有被填充的时间信息。
size_t strftime(char *s,size_t maxsize,const char *format,const struct tm
*timeptr);
说明:根据 format 中定义的格式化规则,格式化结构 timeptr 表示的时间,并把它存储在 s
中。
参数:s -- 这是指向目标数组的指针,用来复制产生的 C 字符串。
maxsize -- 这是被复制到 s 的最大字符数。
format -- 这是 C 字符串,包含了普通字符和特殊格式说明符的任何组合。这些格式
说明符由函数替换为表示 tm 中所指定时间的相对应值。
返回值:如果产生的 C 字符串小于 size 个字符(包括空结束字符),则会返回复制到 str
中的字符总数(不包括空结束字符),否则返回零。