linux 时区时间相关库函数

╰半夏微凉° 2023-06-14 13:56 11阅读 0赞

### **时钟计数** ###

**clock**  
*clock*\_t *clock*(void) ;  
返回处理器调用某个进程或函数所花费的时间。函数返回从“开启这个程序进程”到“程序中调用clock()函数”时之间的CPU时钟计时单元(clock tick)数,其中clock\_t是用来保存时间...”  
clock 函数的返回值类型是clock\_t,它除以CLOCKS\_PER\_SEC来得出时间,一般用两次clock函数来计算进程自身运行的时间.  
ANSI clock有三个问题:  
1)如果超过一个小时,将要导致溢出.  
2)函数clock没有考虑CPU被子进程使用的情况.  
3)也不能区分用户空间和内核空间.  
所以clock函数在linux系统上变得没有意义.

### **时间/时区获取/设置** ###

**clock\_gettime**  
clock\_t times(struct timespec \*buf);  
clk\_id : 检索和设置的clk\_id指定的时钟时间。  
CLOCK\_REALTIME:系统实时时间,随系统实时时间改变而改变,即从UTC1970-1-1 0:0:0开始计时,中间时刻如果系统时间被用户改成其他,则对应的时间相应改变  
CLOCK\_MONOTONIC:从系统启动这一刻起开始计时,不受系统时间被用户改变的影响  
CLOCK\_PROCESS\_CPUTIME\_ID:本进程到当前代码系统CPU花费的时间  
CLOCK\_THREAD\_CPUTIME\_ID:本线程到当前代码系统CPU花费的时间  
timespec类型包含一个**ns**和**s**两个时间

**time**  
time\_t time(time\_t \* timer)；  
获取当前的系统时间，返回的结果是一个time\_t类型，其实就是一个大整数，其值表示从CUT（Coordinated Universal Time）时间1970年1月1日00:00:00（称为UNIX系统的Epoch时间）到当前时刻的**秒数**。

**gettimeofday**  
int gettimeofday(struct [timeval][]\*tv, struct timezone \*tz);  
函数返回从TC1970-1-1 0:0:0开始到现在的**微秒/秒**数，以及**时区**信息 。  
其参数tv是保存获取时间结果的结构体，参数tz用于保存时区结果：  
struct timezone\{  
int tz\_minuteswest;/\*格林威治时间往西方的时差分钟数\*/  
int tz\_dsttime;/\*DST 时间的修正方式\*/  
\}  
timezone 参数若不使用则传入NULL即可。  
而结构体[timeval][]的定义为：  
struct timeval\{  
long int tv\_sec; // 秒数  
long int tv\_usec; // 微秒数  
\}

**settimeofday**  
int settimeofday(const struct timeval \*tv , const struct timezone \*tz);  
settimeofday设置当前时间和时区信息。和gettimeofday相反。

### **时间转换** ###

**localtime**  
struct tm \*localtime(const time\_t \* calptr);   
将**time\_t**格式的时间数值变换成**本地时间**,考虑到本地时区和夏令时标志;

**gmtime**  
struct tm \*gmtime(const time\_t \*calptr);  
将**time\_t**格式的时间数值变换成格林威治标准时区（**GMT**）时间，没有夏令时。

**mktime**  
time\_t mktime(struct tm \**tm*);  
将**tm**格式时间转换为自1970年1月1日以来持续时间的**秒数**

**char \*asctime(const struct tm \**tm*);**  
**把****tm**格式的时间转换为**字符串**。

**char \*asctime\_r(const struct tm \**tm*, char \**buf*);**

**char \*ctime(const time\_t \**timep*);  
把time\_t**格式的时间转换为**字符串**。

### 函数变种 ###

**char \*ctime\_r(const time\_t \**timep*, char \**buf*);**  
**struct tm \*gmtime\_r(const time\_t \**timep*, struct tm \**result*);**  
**struct tm \*localtime\_r(const time\_t \**timep*, struct tm \**result*);**  
这些函数可以将数据存储到用户提供的结构体中。  
使用gmtime和localtime等函数后要立即处理结果，否则返回的指针指向的内容可能会被覆盖。使用变种的函数不会。

### **其他函数** ###

void **tzset** (void);  
设置时间环境变量。  
tzset在程序中用来初始化daylight,timezone和tzname全局变量，它首先试图从环 境变量“TZ”中获取时区，如果TZ环境变量存在，即getenv("TZ")返回值不为NULL，且包含内容有效，则使用TZ值；如果该变量存在但内容 无效，比如包含错误的时区名字，则使用UTC；如果该变量不存在，即getenv("TZ")返回NULL，则查找系统时区设置文件，一般是/etc /localtime。localtime所指文件的内容格式可参考tzfile(5)。  
这些变量由ftime和localtime函数使用校正格林威治(UTC)时间为本地时间,通过time函数从系统时间计算UTC,使用如下语法设置TZ环境变量:**set TZ=tzn\[+|-\]hh\[:mm\[:ss\]\]\[dzn\]**  
ctime()/localtime()/mktime()：这类和时区相关的函数内部会调用tzset，但只是第一次调用tzset会做实际初始化，后面的调用都是直接返回。  
[https://blog.csdn.net/epicyong333/article/details/5258152][https_blog.csdn.net_epicyong333_article_details_5258152]

[timeval]: https://baike.baidu.com/item/timeval
[https_blog.csdn.net_epicyong333_article_details_5258152]: https://blog.csdn.net/epicyong333/article/details/5258152