ctime_r()、ctime64_r() - 時間値の日時文字ストリングへの変換

標準

形式

#define _XOPEN_SOURCE 500
#include <time.h>

char *ctime_r(const time_t *clock, char *buf);

#define _LARGE_TIME_API
#include <time.h>

char  *ctime64_r (const time64_t *clock, char *buf);

機能説明

ctime_r() 関数は、clock が指すカレンダー時間を、ctime() と完全に同じフォームの現地時間に変換し、そのストリングを buf が指す配列 (少なくとも 26 バイトを含む) に入れ、buf を戻します。

ctime() とは異なり、スレッド・セーフ・バージョンの ctime_r() は、tzname を設定するために必要ではありません。

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

戻り値

正常に実行された場合、ctime_r() は、buf によって示されたストリングへのポインターを戻します。

正常に実行されなかった場合、ctime_r() は NULL ポインターを戻します。

設定される errno 値はありません。

関連情報

• locale.h
• time.h
• asctime()、asctime64() - 文字ストリングへの時間の変換
• asctime_r()、asctime64_r() - 文字ストリングへの日時の変換
• ctime()、ctime64() - 文字ストリングへの時間の変換
• gmtime()、gmtime64() - ブレークダウン UTC 時間への変換
• gmtime_r()、gmtime64_r() - ブレークダウン UTC 時間へのタイム値の変換
• localdtconv() - 日付および時刻のフォーマット設定規則の照会
• localtime()、localtime64() - 時間の変換と現地時間に応じた訂正
• localtime_r()、localtime64_r() - ブレークダウン現地時間へのタイム値の変換
• mktime()、mktime64() - 現地時間の変換
• strftime() - フォーマット設定された時刻への変換
• time()、time64() - 現在の UTC 時間の判別
• tzset() - 時間帯の設定