日付と時刻の形式

関数 FORMATTED-CURRENT-DATE、FORMATTED-DATE、FORMATTED-TIME、および FORMATTED-DATETIME の形式定数の引数は、関数の結果である日付または時刻の値の形式を示す。関数の結果の型は、形式定数と同じ英数字、各国文字、または UTF-8 のいずれかとなる。

関数 INTEGER-OF-FORMATTED-DATE、SECONDS-FROM-FORMATTED-TIME、および TEST-FORMATTED-DATETIME の形式定数は、関数の 2 番目の引数として指定された日付または時刻の値の形式を示す。

許容される形式文字列を以下に示す。形式に関連付けられたデータで許容される値の範囲など、形式定数の各項目の詳細については、「値の意味と制限」セクションを参照。

整数日付形式

整数日付形式の値は、グレゴリオ暦の 1601 年 1 月 1 日以降の通算日数を表す正の整数とする。この値は 0 よりも大きく、FUNCTION INTEGER-OF-DATE (99991231) の値 (3,067,671) 以下とする。

注: 整数日付関数の起算日は、INTDATE コンパイラ指令によって変わることがある。

標準日付形式

標準日付形式の値は、YYYYMMDD の形式の整数とする。この値は (YYYY * 10,000) + (MM * 100) + DD として計算される。

YYYY はグレゴリオ暦の暦年を表す。これは [1601, 9999] の範囲の整数とする。
MM は月を表す。これは [01, 12] の範囲の整数とする。
DD は日を表す。これは [01, 31] の範囲の整数とする。ただし、指定した年月の組み合わせに対して有効な日数とする。

ユリウス暦形式

ユリウス暦形式の値は、YYYYDDD の形式の整数とする。この値は (YYYY * 1000) + DDD として計算される。

YYYY はグレゴリオ暦の暦年を表す。これは [1601, 9999] の範囲の整数とする。
DDD は日付を表す。これは [1, 366] の範囲の正の整数とする。ただし、指定した年に対して有効な日数とする。

UTC オフセット値

UTC オフセット値は、UTC (協定世界時) からのオフセットを分単位で表す整数表現とする。この値は -1439 以上 1439 以下とする。

注: オフセット値 1439 は、1 日より 1 分短い 23 時間 59 分を表す。

標準の数値時刻形式

標準の数値時刻形式の値は、深夜 0 時から経過した秒数を表す数値とする。この値は 0 以上 86,400 未満とする。