getdate()、getdate64() - ユーザー形式の日時の変換

標準

形式

#define _XOPEN_SOURCE_EXTENDED 1
#include <time.h>

struct tm *getdate(const char *string);

extern int getdate_err;

#define _LARGE_TIME_API
#include <time.h>

struct tm *getdate64(const char *string);

機能説明

getdate() 関数は、string で示される日付または時刻 (あるいは日付と時刻の両方) の指定を tm 構造体へ変換します。tm 構造体の宣言は、ヘッダー <time.h> 内にあります。

テンプレートは、入力ストリングを解析および解釈するのに使用されます。テンプレートは、プロセスによって作成されたテキスト・ファイル内にあり、環境変数 DATEMSK を介して識別されます。DATEMSK 変数は、テンプレートを含むファイルの完全パス名を示す ため、設定されます。入力指定と一致するテンプレートの最初の行は、内部時間形式への 解釈および変換するために使用されます。

テンプレートと getdate() が実行する入力仕様との突き合わせでは、大文字小文字を区別しません。

月名と曜日名は、大文字と小文字の組み合わせから構成できます。プロセスは、LC_TIME カテゴリー (setlocale() を参照) を 設定することにより、入力日時指定を特定の言語で表すことを要求することができます。

先行 0 が許可されている記述子でも先行 0 は必要ではありませんが、先行 0 がある場合、先行 0 を 含めて 2 桁以下にする必要があります。テンプレート・ファイルまたは string のいずれかにある余分な空白文字は無視されます。

フィールド記述子 %c、%x、および %X は、これらがサポートされないフィ ールド記述子を含む場合は、サポートされません。

テンプレート・ファイル内のフィールド記述子が、サポートされているフィールド記述子の 1 つでない場合、その記述子が検出されると次の動作が生じます。

1. ASCII アプリケーションでは、それは無視され (不一致として扱われ)、処理は次のテンプレートに進みます。
2. EBCDIC アプリケーションでは、それにより関数が正常に戻されず、getdate_err が値 8 に設定されます。

関数 getdate64() は getdate() とまったく同じように動作しますが、ストリングで示される定義可能な日付または時刻指定を、2038 年 1 月 19 日の 03:14:07 UTC を超え、9999 年 12 月 31 日の 23:59:59 UTC までを限度とするカレンダー時間の tm 構造体に変換できます。

戻り値

正常に実行された場合、getdate() は tm 構造体へのポインターを戻します。

正常に実行されなかった場合、getdate() は、NULL ポインターが戻され、外部変数 getdate_err にエラーを示す値が設定されます。

getdate() がポインターを戻す tm 構造体は、他のどの関数とも 共用されません。また、getdate() 関数は、その上でそれが実行するスレッドに固有な tm 構造体を作成します。

C/370™ では、すべてのスレッド間で共用される書き込み可能な 静的ストレージ内に getdate_err 外部変数用のストレージが 割り振られます (これはすべての外部変数に当てはまります)。したがって、getdate_err は、本質的に「スレッド・セーフ」ではありません。

C/370 は、getdate_err の類似を基にスレッドごとにストレージを割り振 ります。__gderr() 関数はこのストレージへのポインターを戻します。getdate() が正常に実行されなかった理由をスレッド・セーフ方法で決定するために getdate() が NULL ポインターを戻す場合、マルチスレッド・アプリケーション や DLL から実行しているアプリケーションでは、getdate_err ではなく __gderr() 関数を使用することをお勧めします。

#include <time.h>

int *__gderr(void);

関連情報

• time.h