std:: gmtime
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
定義済みヘッダー
<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
関連項目
|
エポックからの経過時間を現地時間で表した暦時間に変換する
(関数) |
|
|
Cドキュメント
for
gmtime
|
|