localtime_r()、localtime64_r() - ブレークダウン現地時間へのタイム値の変換

標準

形式

#define _XOPEN_SOURCE 500
#include <time.h>

struct tm *localtime_r(const time_t *__restrict__ clock,
                       struct tm *__restrict__ result);

#define _LARGE_TIME_API
#include <time.h>

struct tm *localtime64_r(const time64_t *__restrict__ clock, 
                       struct tm *__restrict__ result);

機能説明

localtime_r() 関数は、clock で指定されるカレンダー時間を、result が指す構造体に保管されるブロークンダウン時間に変換します。localtime_r() 関数は、その同じ構造体を指すポインターも戻します。

localtime() とは異なり、tzname の設定に再入可能バージョンは、必要ありません。

localtime64_r() 関数は、localtime_r() とまったく同じように動作します。ただし、2038 年 1 月 19 日の 03:14:07 UTC を超え、9999 年 12 月 31 日の 23:59:59 UTC を限度とするカレンダー時間を指す time64_t 値をブレークダウンする点を除きます。

戻り値

正常に実行された場合、localtime_r() は、引数 result によって示される構造体へのポインターを戻します。

エラーが検出された場合、localtime() は NULL ポインターを戻し、errno をエラーを示すように設定します。

エラー・コード

説明

EOVERFLOW

結果は表されません。

関連情報

• 「z/OS XL C/C++ プログラミング・ガイド」のロケールと文字セットの国際化に関するトピックを参照してください。
• locale.h
• time.h
• asctime()、asctime64() - 文字ストリングへの時間の変換
• asctime_r()、asctime64_r() - 文字ストリングへの日時の変換
• ctime()、ctime64() - 文字ストリングへの時間の変換
• ctime_r()、ctime64_r() - 時間値の日時文字ストリングへの変換
• gmtime()、gmtime64() - ブレークダウン UTC 時間への変換
• gmtime_r()、gmtime64_r() - ブレークダウン UTC 時間へのタイム値の変換
• localdtconv() - 日付および時刻のフォーマット設定規則の照会
• localtime()、localtime64() - 時間の変換と現地時間に応じた訂正
• mktime()、mktime64() - 現地時間の変換
• strftime() - フォーマット設定された時刻への変換
• time()、time64() - 現在の UTC 時間の判別
• tzset() - 時間帯の設定