日付と時刻を検証し、内部形式に変換します。

$ZDATETIMEH(datetime,dformat,tformat,monthlist,yearopt,startwin,endwin,mindate,maxdate,erropt)
$ZDTH(datetime,dformat,tformat,monthlist,yearopt,startwin,endwin,mindate,maxdate,erropt)

$ZDATETIMEH は、指定された日付と時刻値を検証し、これを表示形式から内部形式に変換します。対応する $ZDATETIME 関数は、日付と時刻値を内部形式から表示形式に変換します。内部形式は、$HOROLOG または $ZTIMESTAMP によって使用される形式です。コンマで区切られた 2 つの数値の文字列として、日付と時刻値を表します。

返される値は、使用するパラメータによって異なります。

$ZDATETIMEH(datetime) は、日付と時刻値を "MM/DD/[YY]YY hh:mm:ss[.ffff]" 形式から $HOROLOG 形式に変換します。

$ZDATETIMEH(datetime,dformat,tformat,monthlist,yearopt,startwin,endwin,mindate,maxdate,erropt) は、($ZDATETIMEを使用して) 最初に指定された日付と時刻値を $HOROLOG 形式または $ZTIMESTAMP 形式に変換します。dformat、tformat、yearopt、startwin および endwin の値は、$ZDATETIME によって使用される値と同一です。

しかし、5、6、7、8、9 の dformat を使用するとき、$ZDATETIMEH は、dformat コード 1、2、3、5、6、7、8、9 に対応する、外部の日付形式によるあらゆる日付を認識し、変換します。また、T あるいは t で始まる特殊な相対日付形式も同様で、任意にプラス (+) やマイナス (-) を付けたり、現在の日付の前もしくは後の日数を付けます。

$ZDATETIMEH は、関数呼び出しで指定した時刻形式に関係なく、8 つの時刻形式の時刻をすべて認識して変換します。さらに、$ZDATETIMEH は、接尾語 "AM、PM、NOON、MIDNIGHT" を認識して変換します。これらの接尾語は、大文字、小文字、または両方を混ぜ合わせて表すことができます。これらの接尾語を文字に省略することもできます。

認識する形式は、以下のとおりです。

$HOROLOG 形式に変換する日付と時刻。datetime は、先頭に日付、その後に 1 つの空白スペース、時刻と続く 1 つの文字列に評価される式として指定します。時刻部分を省略する場合、$ZDATETIMEH は $HOROLOG 形式の時刻部分をゼロに設定します。有効な日付値、および時刻値は、現在のロケールの DateFormat プロパティと TimeFormat プロパティ、および dformat パラメータと tformat パラメータに指定する値によって異なります。日付に関する詳細は、"$ZDATEH" を参照してください。

日付の形式です。有効な値は以下のとおりです。

以下はその説明です。

時刻の値を表記する形式を指定する数値です。サポートされている値は、以下のとおりです。

tformat 値が (現地時間を返す) 1 から 4 までの場合、日付と時刻はスペースで区切られます。tformat 値が (UTC 時間の情報を返す) 5 から 8 までの場合、日付と時刻は文字 "T" で区切られます。

tformat が 7 または 8 に設定される場合、時刻は UTC 時間で返され、返される日付も (必要であれば) UTC 時間値に調整されます。この日付は、現地日付とは異なる場合があります。

月名の文字列を含む文字列あるいは変数名です。monthlist にある名前は、既定の月名の値と月の省略値を置き換え、現在のロケールの MonthName プロパティと MonthAbbr プロパティをオーバーライドします。monthlist の最も一般的な用途は、ロケールの既定言語以外の言語で、正式な月名または省略名を指定することです。

monthlist は、dformat が 2、5、6、7、または 9 の場合にのみ有効です。dformat が -1、1、3、4、または 8 の場合、$ZDATETIMEH は monthlist を無視します。

monthlist 文字列の形式は、以下のとおりです。

monthlist を省略するか、または monthlist 値に -1 を指定して、dformat が 2、5、6、または 7 の場合、$ZDATETIMEH は現在のロケールの MonthAbbr プロパティで定義された月の省略名リストを使用します。既定は以下のとおりです。"Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec"

monthlist を省略するか、または monthlist 値に -1 を指定して、dformat が 9 の場合、$ZDATETIMEH は現在のロケールの MonthName プロパティで定義された月名のリストを使用します。既定は以下のとおりです。"January February March April May June July August September October November December"

dformat 値に 0、1、2、4、7 を使用して、年を 2 桁で表示する時間ウィンドウを指定する数値コードです。yearopt の値は以下のとおりです。

日付を 2 桁の年で表す必要があるスライディング・ウィンドウの最初を指定する数値です。yearopt の値に 3 または 5 を使用する場合は、startwin を指定する必要があります。startwin は、その他の yearopt 値では無効になります。

yearopt=3 のとき、startwin はスライディング・ウィンドウの最初の日付を示す $HOROLOG 日付形式の絶対日付です。

yearopt=5 のとき、startwin は、現在の年より前の年数で表される、スライディング・ウィンドウの最初の年を示す数値です。スライディング・ウィンドウは常に、startwin で指定した年の初日 (1 月 1 日) から開始します。

日付を 2 桁の年で表すスライディング・ウィンドウの最後を指定する数値です。yearopt が 3 あるいは 5 のとき、endwin を指定する必要があります。endwin は、その他の yearopt 値では無効になります。

yearopt=3 のとき、endwin はスライディング・ウィンドウの最後の日付を示す $HOROLOG 日付形式の絶対日付です。

yearopt=5 のとき、endwin は、現在の年から後の年数を示すスライディング・ウィンドウの最後の年を示す数値です。スライディング・ウィンドウは常に、endwin で指定した年の 12 月 31 日で終了します。endwin を指定しない場合、既定は、startwin 以降 100 年後の 12 月 31 日です。

endwin を省略、あるいは -1 を指定した場合、スライディング・ウィンドウの有効期限は 100 年間です。

startwin と endwin の両方を指定する場合、指定するスライディング・ウィンドウの年数は 100 年以内に収める必要があります。

有効な日付の下限を指定する数値です。mindate を省略、あるいは -1 を指定すると、現在のロケールの DateMinimum プロパティから下限を取得します。既定は 0 (1840 年 12 月 31 日) です。

有効な日付の上限を指定する数値です。maxdateを省略、あるいは -1 を指定すると、現在のロケールの DateMaximum プロパティから上限を取得します。既定は、$HOROLOG の日付部分で許容される最大値である、2980013 (9999 年 12 月 31 日) です。maxdate を超える値を指定しようとすると、<VALUE OUT OF RANGE> エラー・メッセージが発生します。

このパラメータは、datetime 値が無効あるいは範囲外の場合に生じるエラー・メッセージを制御します。<ILLEGAL VALUE> あるいは <VALUE OUT OF RANGE> エラー・メッセージを生成する代わりに、関数は erropt を返します。

$ZDATETIME とは異なり、$ZDATETIMEH は時刻の精度を指定することはできません。元の $ZDATETIME 時刻形式の秒の小数部は、$ZDATETIMEH が返す値に保持されます。

$HOROLOG 形式も秒の小数部を返しません。

以下の状況では、<FUNCTION> エラーが発生します。

以下の状況では、<ILLEGAL VALUE> エラーが発生します。

以下の状況では、<VALUE OUT OF RANGE> エラーが発生します。

erropt パラメータが指定されている場合、このパラメータは、datetime の無効な値、あるいは範囲外の値が原因で生成されるエラー・メッセージを制御します。他のパラメータの無効な値、あるいは範囲外の値が原因で発生したエラーについては、erropt が指定されているかどうかに関係なく、常にエラー・メッセージが生成されます。

例えば、$ZDATETIMEH でendwin が startwin より前になる値のスライディング･ウィンドウを指定すると、常に <ILLEGAL VALUE> エラーが発生します。同様に、maxdate が mindate より小さい場合、<ILLEGAL VALUE> エラーが発生します。

$ZDATETIMEH は、dformat が 1 または 4 のとき、年月日の区切り文字として現在のロケールの DateSeparator プロパティの値を使用します。ODBC 日付形式 (dformat=3) の区切り文字は常に、ODBC 基準で要求されている "-" になります。DateSeparator の既定値は "/" であり、この区切り文字は Caché のすべてのドキュメントで使用されています。

既定では、Caché は、現在のロケールの TimeSeparator プロパティ値を使用して、時間の区切り文字を指定します。既定では、区切り文字は ":" で、すべての例でこの区切り文字を使用しています。ODBC 日付形式 (dformat=3) の区切り文字は常に、ODBC 基準で要求されている ":" になります。

小数秒の区切り文字は、小数点 (.) です。

既定では、Caché は現在のロケールのプロパティを使用して、時間の接尾語名を指定します。$ZDATETIMEH で、これらのプロパティ (および、対応する既定値) は以下のとおりです。

このドキュメントでは、これらのプロパティに常に既定値を使用します。

$ZDATETIMEH は、$ZDATEH に似ています。$ZDATETIMEH が日付と時刻の値の両方を内部 $HOROLOG 形式に変換するのに対し (時刻値を指定していない場合でも)、$ZDATEH は、日付の値だけを $HOROLOG 形式に変換する点が異なります。例えば以下のようになります。

   WRITE $ZDATEH("Nov 25, 2002",5)

これは、59133 を返します。

   WRITE $ZDATETIMEH("Nov 25, 2002 10:08:09.539",5)

これは、59133,36489.539 を返します。

$ZDATETIMEH に値を指定しない場合

   WRITE $ZDATETIMEH("Nov 25, 2002",5)

これは、59133,0 を返します。