gmtime, gmtime_r, gmtime_s
提供: cppreference.com
ヘッダ <time.h> で定義 | ||
| (1) | ||
| (2) | (C2x以上) | |
| (3) | (C11以上) | |
1) 指定されたエポックからの経過時間 (
timer の指す time_t の値) を協定世界時 (UTC) で表される struct tm 形式のカレンダー時刻に変換します。 結果は静的記憶域に格納され、その静的記憶域が返されます。2)(1) と同じですが、この関数は結果のためにユーザ提供の記憶域
buf を使用します。3)(1) と同じですが、この関数は結果のためにユーザ提供の記憶域
buf を使用し、以下のエラーが実行時に検出され、現在設定されている制約ハンドラ関数を呼びます。 timerまたはbufがヌルポインタ。
- すべての境界チェック付き関数と同様に、
gmtime_sは __STDC_LIB_EXT1__ が処理系によって定義されていて、<time.h>をインクルードする前にユーザが __STDC_WANT_LIB_EXT1__ を整数定数 1 に定義した場合にのみ、利用可能であることが保証されます。
目次 |
[編集]引数
| timer | - | 変換する time_t オブジェクトを指すポインタ |
| buf | - | 結果を格納するための構造体 tm のオブジェクトを指すポインタ |
[編集]戻り値
1) 成功した場合は静的な内部の tm オブジェクトを指すポインタ、そうでなければヌルポインタ。 この構造体は gmtime、 localtime およぼ ctime の間で共有されているかもしれず、呼び出しのたびに上書きされるかもしれません。
2,3)
buf ポインタのコピー、またはエラー (実行時制約違反または指定された時刻の UTC への変換の失敗かもしれません) の場合はヌルポインタ。[編集]ノート
関数 gmtime はスレッドセーフでないかもしれません。
POSIX は引数が大きすぎるためにこの関数が失敗した場合は errno を EOVERFLOW に設定することを要求しています。
POSIX はスレッドセーフな代替関数 gmtime_r を以前から定義していました。
Microsoft CRT の gmtime_s の実装は引数の順序が逆であり、また errno_t を返すため C 標準と非互換です。
[編集]例
Run this code
#define __STDC_WANT_LIB_EXT1__ 1#define _XOPEN_SOURCE // for putenv#include <time.h>#include <stdio.h>#include <stdlib.h> // for putenv int main(void){time_t t =time(NULL);printf("UTC: %s", asctime(gmtime(&t)));printf("local: %s", asctime(localtime(&t)));// POSIX-specific putenv("TZ=Asia/Singapore");printf("Singapore: %s", asctime(localtime(&t))); #ifdef __STDC_LIB_EXT1__structtm buf;char str[26]; asctime_s(str,sizeof str,gmtime_s(&t, &buf));printf("UTC: %s", str); asctime_s(str,sizeof str,localtime_s(&t, &buf));printf("local: %s", str);#endif}
出力例:
UTC: Fri Sep 15 14:22:05 2017 local: Fri Sep 15 14:22:05 2017 Singapore: Fri Sep 15 22:22:05 2017 UTC: Fri Sep 15 14:22:05 2017 local: Fri Sep 15 14:22:05 2017
[編集]参考文献
- C11 standard (ISO/IEC 9899:2011):
- 7.27.3.3 The gmtime function (p: 393-394)
- K.3.8.2.3 The gmtime_s function (p: 626-627)
