当前位置： C语言 -- 附录 -- gmtime_s

gmtime_s函数

概要：

#define __STDC_WANT_LIB_EXT1__ 1
#include <time.h>
struct tm *gmtime_s(const time_t * restrict timer, 
      struct tm * restrict result);

描述：

该函数将参数timer指向的日历时间转换为UTC表示的分解时间（broken-down time），并将转换结果存储在参数result指向的结构中。

运行约束：

参数timer和参数result不能是空指针。

如果存在运行约束冲突，函数不会尝试转换时间。

参数：

const time_t * restrict timer

指向time_t类型对象的指针。

struct tm * restrict result

指向struct tm类型对象的指针。

返回值：

如果指定时间不能转换成UTC时间或者存在运行约束冲突，函数返回空指针；否则函数返回result。

范例：

/*安全函数gmtime_s范例*/

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <time.h>

#define LENGTH 26

int main(void)
{
    time_t currentTime;
    char str[LENGTH];
    struct tm result;

    time(&currentTime);
    if(!gmtime_s(&result, &currentTime))
    {
        if(!asctime_s(str, LENGTH, &result))
            printf_s("UTC Time: %s\n", str);
    }
    
    return 0;
}

输出：

UTC Time: Wed Jun 22 00:26:42 2022

注：使用Visual Studio编译。

gmtime_s函数在Visual Studio中的声明与ISO/IEC 9899:2018标准有差异，在Visual Studio中声明如下：

errno_t gmtime_s( 
   struct tm *result,
   const time_t *timer);

差异主要表现在两个方面：

1、返回值不同，Visual Studio返回类型是errno_t类型；ISO/IEC 9899:2018标准返回的是struct tm类型指针。

2、参数的先后顺序两者正好相反。