$ZTIMESTAMP

ddddd,sssss.fff

ddddd は、1840 年 12 月 31 日からの経過日数を示す整数です。sssss は、現在の日付の午前 0 時からの経過秒数を示す整数です。fff は、秒の小数部を示す可変桁数です。この形式は $HOROLOG と似ていますが、$HOROLOG には秒の小数部は含まれません。

現在の日付と時間 (UTC) が以下のようになると仮定します。

2011-03-26 15:17:27.984

そのとき、$ZTIMESTAMP は以下の値を持ちます。

62176,55047.984

$ZTIMESTAMP は、タイム・ゾーンとは独立した UTC (Coordinated Universal Time) を報告します そのため、ローカル時間帯に関係なく、一様に時間を記録するタイムスタンプとして $ZTIMESTAMP を使用することができます。これは、ローカル時刻値とローカル日付値の両方と異なる場合があります。

$ZTIMESTAMP の時刻値は、秒数とその小数部で時刻をカウントする 10 進数値です。秒以下の桁数は、0 から 9 桁で、コンピュータの時刻クロックの有効桁数によって決定します。Windows システムでは、小数部分の有効桁数は 3 桁で、UNIX® システムでは 6 桁です。$ZTIMESTAMP は末尾の 0 や、この小数部での末尾の小数点を抑制します。深夜 12 時を過ぎて 1 秒以内の秒数は 0.fff (例えば、0.123) で表されます。この数値は ObjectScript キャノニック形式 (例えば、.123) ではないため、これらの値の文字列並べ替え順序に影響を及ぼします。並べ替え操作を実行する前に、数値を強制的にキャノニック形式に変換するプラス記号 (+) を先頭に追加できます。

現在の日付と時刻は、さまざまな方法で返すことができますが、その違いを以下に示します。

• $ZTIMESTAMP には、秒の小数部を含む UTC の日付と時刻が Caché ストレージ ($HOROLOG) 形式で格納されます。秒の小数部は、Windows システムでは有効桁数 3 桁で、UNIX® システムでは有効桁数 6 桁で表されます。

• $NOW は、現在のプロセスのローカル日付とローカル時刻を返します。ローカル時刻調整 (サマータイムなど) は適用されません。パラメータ値のない $NOW は、$ZTIMEZONE 特殊変数の値からローカル・タイム・ゾーンを決定します。パラメータ値のある $NOW は、指定されたタイム・ゾーン・パラメータに対応する時刻と日付を返します。$NOW(0) は、UTC による日付と時刻を返します。$ZTIMEZONE の値は無視されます。$NOW は、Caché ストレージ ($HOROLOG) 形式で日付と時刻を返します。これには、秒の小数部が含まれます。小数桁数は、現在のオペレーティング・システムでサポートされている最大精度の桁数です。このため、$NOW(0) は、$ZTIMESTAMP よりも大きい秒の小数部の精度で UTC 時刻を返す場合があります。

• $HOROLOG には、ローカル調整された日付と時刻が Caché ストレージ形式で格納されます。秒の小数部は記録されません。$HOROLOG による秒の小数部の処理方法は、オペレーティング・システム・プラットフォームによって異なります。Windows では、小数部はすべて切り上げられます。UNIX® では、小数部は切り捨てられます。

この特殊変数は、SET コマンドを使用して変更することはできません。変更を試みると、<SYNTAX> エラーが返されます。

協定世界時の変換

次の例のように、tformat 値 7 または 8 を指定して $ZDATETIME および $ZDATETIMEH 関数を使用することで、ローカル時刻情報を UTC として表すことができます。

   WRITE !,$ZDATETIME($ZTIMESTAMP,1,1,2)
   WRITE !,$ZDATETIME($HOROLOG,1,7,2)
   WRITE !,$ZDATETIME($HOROLOG,1,8,2)
   WRITE !,$ZDATETIME($NOW(),1,7,2)
   WRITE !,$ZDATETIME($NOW(),1,8,2)

上記の $ZDATETIME 関数はすべて、現在の時刻をローカル時刻ではなく UTC として返します。ローカル時刻からのこれらの時刻値変換は、$NOW がローカル時刻調整を行わないため、異なる場合があります。$ZTIMESTAMP および $HOROLOG は、ローカル時刻調整を行い、必要に応じてこの調整に従って日付を調整します。$ZTIMESTAMP の表示値と、tformat 値 7 または 8 で変換された表示値は同一ではありません。tformat 値 7 および 8 によって、時刻値の前に文字 “T”、後に文字 “Z” が挿入されます。また、$HOROLOG 時刻には 1 秒以下の秒数が含まれないので、上の例の precision 2 によって小数部にゼロが埋め込まれます。

以下の構文形式のいずれかを使用して TimeStamp()Opens in a new tab クラス・メソッドを呼び出すことで、$ZTIMESTAMP と同じタイム・スタンプ情報を取得することができます。

   WRITE !,$SYSTEM.SYS.TimeStamp()
   WRITE !,##class(%SYSTEM.SYS).TimeStamp()

詳細は、このドキュメントの "$SYSTEM" 特殊変数と、"インターシステムズ・クラス・リファレンス" の %SYSTEM.SYSOpens in a new tab クラスを参照してください。