$ZTIME(htime,tformat,precision,erropt,localeopt)
$ZT(htime,tformat,precision,erropt,localeopt)
引数
htime
この値は、その日の午前 0 時 00 分から経過した秒数を表します。$HOROLOG 値の秒の構成要素で、$PIECE($HOROLOG,",",2) を使用して抽出できます。htime は、整数、または precision で指定された精度の小数桁数を持つ小数です。
tformat 値が -1 ～ 4 の場合、htime の有効値は、0 ～ 86399 (-0 は0 として処理される) の範囲の整数部分にする必要があります。この範囲外の値では、<ILLEGAL VALUE> エラーが発生します。tformat 値が 9 および 10 の場合、htime の有効値に負の数字および 86399 より大きい値を含めることもできます。
tformat
サポートされている値は、以下のとおりです。
| tformat |
説明 |
| -1 |
現在のロケールの TimeFormat プロパティから、有効な形式値を取得します。既定は 1 です。tformat を指定せず、localeopt が未指定または 0 の場合は、これが既定になります。 |
| 1 |
時刻を "hh:mm:ss" (24 時間) で表します。 |
| 2 |
時刻を “hh:mm” (24 時間) で表します。 |
| 3 |
時刻を “hh:mm:ss[AM/PM]” (12 時間) で表します。 |
| 4 |
時刻を “hh:mm[AM/PM]” (12 時間) で表します。 |
ユーザのロケールの既定の時刻形式を決定するには、GetFormatItem()Opens in a new tab NLS クラス・メソッドを呼び出します。
WRITE ##class(%SYS.NLS.Format).GetFormatItem("TimeFormat")
12 時間形式では、午前と午後を時間接尾語で表します。ここでは、AM と PM で表示されています。ユーザのロケールの既定の時間接尾語を決定するには、以下の NLS クラス・メソッドを呼び出します。
WRITE ##class(%SYS.NLS.Format).GetFormatItem("AM"),!
WRITE ##class(%SYS.NLS.Format).GetFormatItem("PM"),!
precision
この関数は、precision 引数で指定された小数点以下の桁数まで、秒の小数部を表示します。例えば precision の値に 3 を入力すると、$ZTIME は秒の小数部を小数点以下 3 桁まで表示します。また、precision が 9 の場合、$ZTIME は秒の小数部を小数点以下 9 桁まで表示します。サポートされている値は、以下のとおりです。
| 値 |
説明 |
| -1 |
現在のロケールの TimePrecision プロパティから precision 値を取得します。既定は 0 です。precision を指定しない場合は、これが既定の振る舞いになります。 |
| n |
ゼロ (0) 以上の n の値は、時刻を少数点以下の n 桁まで表すことを示します。 |
| 0 |
0 に設定された場合、または既定値の 0 である場合、秒の小数部は切り捨てられます。 |
ユーザのロケールの既定の時刻精度を決定するには、GetFormatItem()Opens in a new tab NLS クラス・メソッドを呼び出します。
WRITE ##class(%SYS.NLS.Format).GetFormatItem("TimePrecision")
erropt
この引数は、無効な htime 値に対応するエラー・メッセージを抑制します。<ILLEGAL VALUE> エラー・メッセージを生成する代わりに、関数は erropt で示された値を返します。
localeopt
この引数は、時刻のオプションのソースとして、ユーザの現在のロケール定義 (0) または ODBC ロケール定義 (1) を選択します。ODBC ロケールは変更できません。これは、異なる各国語サポート (NLS) の選択を行った InterSystems IRIS プロセス間で移植できる、日付文字列および時刻文字列をフォーマットするために使用されます。
ODBC ロケールの時刻定義は、以下のとおりです。
例
特殊変数 $HOROLOG を使用して現在の現地時刻を返すには、$PIECE 関数を使用して、$HOROLOG の秒の部分を指定する必要があります。以下は、24 時間形式 “13:55:11” で時刻を返します。
WRITE $ZTIME($PIECE($HOROLOG,",",2),1)
次の例では、現在時刻に対して htime が $PIECE($HOROLOG,",",2) に設定されています。これらの例は、さまざまな $ZTIME を使用し、異なる時刻形式を返す方法を示しています。
通常、以下の例は、"13:28:55" という形式の時刻を返します。しかし、この形式はロケールに依存します。
SET htime=$PIECE($HOROLOG,",",2)
WRITE $ZTIME(htime)
以下の例は、"13:28:55" の形式で時刻を返します。
SET htime=$PIECE($HOROLOG,",",2)
WRITE $ZTIME(htime,1)
以下の例は、"13:28:550.999" の形式で時刻を返します。
SET htime=$PIECE($HOROLOG,",",2)
WRITE $ZTIME(htime,1,3)
以下の例は、"13:28:55.999999999" の形式で時刻を返します。
SET htime=$PIECE($HOROLOG,",",2)
WRITE $ZTIME(htime,1,9)
以下の例は、"13:28" の形式で時刻を返します。
SET htime=$PIECE($HOROLOG,",",2)
WRITE $ZTIME(htime,2)
以下の例は、"01:28:24PM" の形式で時刻を返します。
SET htime=$PIECE($HOROLOG,",",2)
WRITE $ZTIME(htime,3)
以下の例は、"01:28PM" の形式で時刻を返します。
SET htime=$PIECE($HOROLOG,",",2)
WRITE $ZTIME(htime,4)
以下の例は、“13:45:56.021” の形式で時刻を返します。小数点以下有効桁数 3 桁で現在の UTC 時刻を返します。
SET t=$ZTIME($PIECE($ZTIMESTAMP,",",2),1,3)
WRITE "Current UTC time is ",t
