Namespaces
Variants

std:: gmtime

From cppreference.net
< cpp ‎ | chrono ‎ | c
定義済みヘッダー <ctime>
std:: tm * gmtime ( const std:: time_t * time ) ;

エポックからの経過時間を std::time_t 値として受け取り、協定世界時(UTC)で表された暦時刻に変換します。

目次

パラメータ

time - time_tオブジェクトへのポインタ(変換対象)

戻り値

成功時には静的内部 std::tm オブジェクトへのポインタ、それ以外の場合はヌルポインタを返します。この構造体は std::gmtime std::localtime 、および std::ctime 間で共有される可能性があり、各呼び出し時に上書きされる可能性があります。

注記

この関数はスレッドセーフではない可能性があります。

POSIXでは、 gmtime が引数が大きすぎるために失敗した場合、 errno EOVERFLOW に設定することが要求されています。

#include <ctime>
#include <iomanip>
#include <iostream>
#include <sstream>
int main()
{
    setenv("TZ", "/usr/share/zoneinfo/Europe/London", 1); // POSIX固有
    std::tm tm{}; // get_timeは全てのフィールドを設定しないため{}
    tm.tm_year = 2020 - 1900; // 2020年
    tm.tm_mon = 7 - 1; // 7月
    tm.tm_mday = 15; // 15日
    tm.tm_hour = 10;
    tm.tm_min = 15;
    tm.tm_isdst = 1; // ロンドンの夏時間
    std::time_t t = std::mktime(&tm); 
    std::cout << "UTC:   " << std::put_time(std::gmtime(&t), "%c %Z") << '\n';
    std::cout << "local: " << std::put_time(std::localtime(&t), "%c %Z") << '\n';
}

出力例:

UTC:   Wed Jul 15 09:15:00 2020 GMT
local: Wed Jul 15 10:15:00 2020 BST

関連項目

エポックからの経過時間を現地時間で表した暦時間に変換する
(関数)