当前位置: C语言 -- 标准库 -- <time.h> -- gmtime

gmtime函数


概要:
#include <time.h>
struct tm *gmtime(const time_t *timer);

描述:

该函数将参数timer指向的日历时间转换为以UTC时间表示的分解时间(broken-down time)。

同一线程中gmtime函数调用和localtime函数调用返回的指针指向相同的静态对象。gmtime函数调用可能会覆盖先前gmtime函数或者localtime函数调用的数据,并且gmtime函数不需要避免数据竞争。实现应像没有库函数调用gmtime函数一样。

ISO/IEC 9899:2018标准定义了该函数的安全版本gmtime_s


参数:
const time_t *timer

参数为一个指向time_t类型对象的指针。


返回值:

函数返回一个指向分解时间的指针;如果指定的时间不能转换为UTC时间,函数返回空指针。


范例:
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
/*函数gmtime范例*/

#include <stdio.h>
#include <time.h>

int main(void)
{
    time_t currentTime;
    time(&currentTime);
    
    /*本地时间。*/
    printf("Beijing Time: %s\n", asctime(localtime(&currentTime)));

    /*UTC时间。*/
    printf("%4cUTC Time: %s", ' ', asctime(gmtime(&currentTime)));
    
    return 0;
}


输出:

Beijing Time: Mon Jul 03 14:35:30 2017

    UTC Time: Mon Jul 03 06:35:30 2017


相关内容:
localtime time_t类型日历时间转换为本地时间表示的struct tm类型分解时间的函数。