©
本文檔使用 php中文網手册 發布
在头文件<time.h>中定义 | ||
---|---|---|
time_t mktime(struct tm * time); |
将表示为struct tm
对象的本地日历时间重新规范化,并将其转换为时代以来的时间作为time_t
对象。time->tm_wday
并被time->tm_yday
忽略。中的数值time
不检查超出范围。
试图确定夏令时是否在指定时间内生效的time->tm_isdst
原因的负值mktime
。
如果转换time_t
成功,time
则修改该对象。所有字段都会time
更新以适合其适当的范围。time->tm_wday
并time->tm_yday
使用其他领域的信息重新计算。
时间 | - | 指向指定本地日历时间转换的tm对象的指针 |
---|
自成立以来的时间作为time_t
成功的对象,或者-1
如果time
不能被表示为time_t
对象(在这种情况下POSIX也需要EOVERFLOW
被存储errno
)。
如果该struct tm
对象是从POSIX strptime或等价函数获得的,则其值tm_isdst
是不确定的,并且需要在调用之前明确设置mktime
。
#define _POSIX_C_SOURCE 200112L // for setenv on gcc#include <stdlib.h>#include <stdio.h>#include <time.h> int main(void){ setenv("TZ", "/usr/share/zoneinfo/America/New_York", 1); // POSIX-specific struct tm tm = *localtime(&(time_t){time(NULL)}); printf("Today is %s", asctime(&tm)); printf("(DST is %s)\n", tm.tm_isdst ? "in effect" : "not in effect"); tm.tm_mon -= 100; // tm_mon is now outside its normal range mktime(&tm); // tm_dst is not set to -1; today's DST status is used printf("100 months ago was %s", asctime(&tm)); printf("(DST was %s)\n", tm.tm_isdst ? "in effect" : "not in effect");}
输出:
Today is Fri Apr 22 11:53:36 2016(DST is in effect)100 months ago was Sat Dec 22 10:53:36 2007(DST was not in effect)
C11标准(ISO / IEC 9899:2011):
7.27.2.3 mktime函数(p:390-391)
C99标准(ISO / IEC 9899:1999):
7.23.2.3 mktime函数(p:340-341)
C89 / C90标准(ISO / IEC 9899:1990):
4.12.2.3 mktime函数