Linux下gmtime、gmtime_r、localtime、localtime_r函数详解

函数功能介绍

使用man gmtime或man localtime都可以的得到这几个函数的介绍。原型如下：
struct tm *gmtime(const time_t *timep);
struct tm *gmtime_r(const time_t *timep, struct tm *result);
struct tm *localtime(const time_t *timep);
struct tm *localtime_r(const time_t *timep, struct tm *result);

gmtime() 函数将日历时间timep转换为用UTC时间表示的时间。它可能返回NULL，比如年份不能放到一个整数中。返回值指向一个静态分配的结构，该结构可能会被接下来的任何日期和时间函数调用覆盖。gmtime_r()函数功能与此相同，但是它可以将数据存储到用户提供的结构体中。

localtime() 函数将日历时间timep转换为用户指定的时区的时间。这个函数的行为好像是它调用了tzset(3) 并且将外部变量tzname设置为当前时区的信息，将timezone设为UTC和本地标准时间的差值，并且，如果在一年的部分时间使用日光节约规则时将daylight设置为非空值。返回值指向一个静态分配的结构，该结构可能会被接下来的任何日期和时间函数调用覆盖。localtime_r()函数功能与此相同，但是它可以将数据存储到用户提供的结构体中。它不需要设置tzname。

总结

使用gmtime和localtime后要立即处理结果，否则返回的指针指向的内容可能会被覆盖，可以使用gmtime_r和localtime_r替代前者，由于使用了用户分配的内存，这两个函数是不会出错的。

在写代码的时候，经常会用到读取系统时间的函数。很多人都会调用localtime函数来将时间转换本地时间，但是localtime函数不是线程安全的。如果在多线程里调用localtime函数，很可能会出现问题。

多线程应用里面，应该用localtime_r函数替代localtime函数，因为localtime_r是线程安全的

struct tm *localtime(const time_t *clock);

struct tm* localtime_r( const time_t* timer, struct tm* result )

下面这篇文章给出了较好实现例子：
https://blog.csdn.net/q1183345443/article/details/93169133