$ZDate()

$ZDate()
前	第7章. 関数	次

$HOROLOGの方法でフォーマットされた引数に基づいてテキストとしてフォーマットされた日付/時刻を返します。$HOROLOGのフォーマットについては、第8章： “固有の特殊変数”を参照してください。

$ZDATE関数のフォーマット：

$ZD[ATE](expr1[,expr2[,expr3[,expr4]]]])

1番目の式(expr1)は、$ZDATE() がテキスト形式で返す日付および/または時間を$HOROLOGフォーマットで指定します。もし出力が日付または時刻のみ必要な場合は、コンマ(,) で区切られた引数の他の部分は null である可能性があります。
オプションの2番目の式(expr2) は、希望する出力フォーマットの " picture " (書式) で、$ZDATE() を提供している文字列を指定します。もしこの引数が欠落している場合やnullである場合、$ZDATE() はデフォルトのフォーマット文字列である"MM/DD/YY"を使用します。もしオプションの2番目の式が64文字を超える場合、$ZDATE() は実行時エラーを生成します。
オプションの3番目の式は、カンマ(,) で区切られた、$ZDATE() が "MON" 書式で要求されているテキストの月の書式で使用しているその12ヶ月のコードのリストを指定します（つまり、"MON" が2番目の式に現れる時に、$ZDATE() は $PIECE(expr3,",",month-number) を出力します）。もしこの引数が見つからないか null の場合、$ZDATE() は月の3文字の英語の略語を使用します。
オプションの4番目の式は、カンマ(,) で区切られた、$ZDATE() が "DAY" 書式で要求されているテキストの週の日の書式を使用しているその7日間のコードのリストを指定します。"DAY" が2番目の式に現れる時、$ZDATE() は $PIECE (expr4,",",day-of-week-number) を出力します。もしこの引数が欠落している場合やnullの場合、$ZDATE() は、曜日の3文字の英語の略語を使用します。
$ZDATE() は、0日の日付表現として1840年12月31日を返します。

$ZDATE() は、Mの内部日付/時刻（$ HOROLOG）フォーマットをよりユーザーフレンドリーなフォーマットに置くための簡単で柔軟なツールを提供します。

	Warning : 警告
	$ZDATE() は、入力日付値として 31-Dec-999999（364570088）より大きい、または、01-JAN-1840（-365）より小さい場合はエラーを発生し、そして、時刻の値として真夜中（86399）より大きい、または、0より小さい秒数の場合はエラーを発生します。

特殊変数 $ZDATEFORMは、年の出力フォーマットを特定します。デフォルト値はゼロ（0）で、その場合には、1つの引数（フォーマット仕様のない）での$ZDATE() は、すべての年のために "YY"（2桁）のフォーマットを使用します。もし$ZDATEFORMが1つ（1）ならば、"YYYY"（4桁）のフォーマットは1999年より後の年として使用されます。 $ZDATEFORMの他のすべての値については、"YYYY"（4桁）のフォーマットは、すべての年のために使用されます。フォーマット引数が指定されている時、$ZDATEFORMは $ZDATE() には影響しません。

1番目の引数だけが指定されている時、次の表は、$ZDATE() の使用についての要約です。

$ZDATEFORM の値	$ZDATE() 出力フォーマット
0	2桁
1	2000年以降の4桁の年そうでなければ 2桁 ( 1840年から1999年の間の範囲の年)
その他	4桁

$ZDATEFORM の値

$ZDATE() 出力フォーマット

2桁

2000年以降の4桁の年

そうでなければ 2桁 ( 1840年から1999年の間の範囲の年)

その他

4桁

$ZDATE形式の仕様要素

このセクションでは、$ZDATEのフォーマットの仕様の要素を示します。$ZDATE() フォーマットの仕様では、大文字で記述する必要があります。フォーマット仕様内の任意のアルファベット文字が小文字の時、$ZDATE()は、実行時エラーを生成します。

YY：年の右端2桁の数字を出力します。

YEAR：4桁の数字として年を出力します。

YYYYYY：年を6桁の数字として出力します。

MM：01と12の間のゼロが埋め込まれた2桁の数値として月を出力します。

MON：3文字の省略形として月を出力します。（さらにexpr3を使用して出力を変更できます）。

DD：01と31の間のゼロが埋め込まれた2桁の数値としての月の日を出力します。

DAY：3文字の省略形として、曜日を出力します。（さらにexpr4を使用して出力を変更できます）。

24：00と23の間のゼロが埋め込まれた数値として1日の時間を出力します。

12：01と12の間のゼロが埋め込まれた数値として1日の時間を出力します。

60：00と59の間のゼロが埋め込まれた数値として1時間の中の分を出力します。

SS：00と59の間にゼロで初期化された数値として秒を出力します。

AM：時間に応じて AMとPM 文字を出力します。

+：出力文字列にプラス記号（+）を挿入します。

- ：出力文字列にマイナス記号（ - ）を挿入します。

. ：出力文字列にピリオド（ . ）を挿入します。

, ：出力文字列にコンマ（ , ）を挿入します。

/：出力文字列にスラッシュ（/）を挿入します。

: :出力文字列にコロン（ : ）を挿入します。

; ：出力文字列にセミコロン（;）を挿入します。

*：出力文字列にアスタリスク（*）を挿入します。

	注意
	空白は、出力文字列に空白を挿入します。

$ZDATE()の例

例：

GTM>write $horolog,!,$zdate($H)
62109,60946
01/18/11
GTM>

$HOROLOG を表示し、$ZDATE() を使用して今日の日付を表示します。表示される出力は、今日が2011年1月18日の場合に表示されます。

例：

GTM>write $zdate($H,"DD-MON-YEAR")
18-JAN-2011
GTM>

これは、2番目の引数を使用して、デフォルトと異なるテキスト形式を指定します。

例：

GTM>set m="Januar,Februar,Marz,April,Mai,Juni,Juli,August,"
GTM>set m=m_"September,October,November,Dezember"
GTM>write $zdate($horolog,"DD-MON-YEAR",m)
18-Januar-2011
GTM>

これは前の例と似ていますが、3番目の引数を使用してドイツ語で月を指定します。

例：

GTM>set d="Dimanche,Lundi,Mardi,Mercredi,Jeudi,Vendredi,Samedi"
GTM>write $zdate($H,"DAY, DD/MM/YY","",d)
Mardi, 18/01/2011
GTM>

この例は1月18日を表示しますが、4番目の引数を使用してフランス語で曜日を指定します。

例：

GTM>write !,$zdate($H,"12:60:SS AM")
10:35:51 PM
GTM>

この例では、AM / PM インジケータを使用して12時間表示の時、分、秒を示します。

例：

GTM>write !,$zdate(",36524","24-60")
10-08
GTM>

この例では、24時間制の時刻と分を示しています。最初の引数は、$HOROLOG 形式と一致するように2番目のコンマ区切りで取得した部分文字列で時間を指定する必要があることに注意してください。

例：

GTM>write $zdateform
0
GTM>write $zdate($H)
01/18/11
GTM>set $zdateform=1
GTM>write $zdate($horolog)
01/18/2011
GTM>write $zdate($horolog,"MM/DD/YY")
01/18/11

この例では、組み込み特殊変数 $ZDATEFORM を使用して、出力形式をデフォルト（ "YY"）形式から4桁形式（ "YYYY"）に変換します。

例：

GTM>write $zdate(123456789,"DAY MON DD, YYYYYY")
FRI MAR 17, 339854
GTM>

この例では、年を6桁の数字で表示しています。

前	上	次
$ZDATA()	ホーム	$ZExtract()