9.28 CONVERTDATE
注意: 9.1 組み込み関数の規則 &<a href="bifcat2_02.htm"&>利用オプション&</a&>
英数字の日付形式を変換します。
組み込み関数CONVERTDATEを2回使用して、2つの別々の結果フィールドを生成することにより、"THURSDAY 5TH OCTOBER 1987"などの日付を生成することができます。
引数
番号 |
タイプ |
必須/任意 |
記述 |
最小長 |
最大長 |
最小小数桁数 |
最大小数桁数 |
1 |
A |
必須 |
変換する日付 |
1 |
20 |
|
|
2 |
A |
必須 |
変換前の日付形式 |
1 |
1 |
|
|
3 |
A |
必須 |
戻り値で必要な日付形式 |
1 |
1 |
|
|
有効な日付形式
- 変換される日付：A、B、C、D、E、F、G、H、I、J、K、L、M、V、W、X、Y、Zおよび1です。
- 戻される日付：A、B、C、D、E、F、G、H、I、J、K、L、M、N、O、P、Q、R、S、T、U、V、W、X、Y、Zおよび1です。
- 「&<a href="crfile6_valid_date_formats.htm"&>日付形式&</a&>」を参照してください。
戻り値
番号 |
タイプ |
必須/ 任意 |
記述 |
最小長 |
最大長 |
最小小数桁数 |
最大小数桁数 |
1 |
A |
必須 |
戻される変換後の日付 |
1 |
20 |
|
|
2 |
A |
任意 |
変換が成功したかどうかを示す戻りコード (YまたはN) |
1 |
1 |
|
|
技術上の注記
- 比較および計算を正確に実行するため、すべての日付の年は4桁である必要があります。ユーザーが入力した年が2桁 (例：DDMMYY、YYMMDD、MMYY) の場合、システム定義データ・エリアから世紀の値が検索されます。指定された年をデータ・エリアの年と比較します。指定された年が比較年よりも小さいか等しい場合、前の世紀が使われます。指定された年が比較年よりも大きい場合、後の世紀が使われます。
- P、Q、R、S、T、Uの日付形式を使用すると、日付は、DC@M01のメッセージBIF0101およびBIF0102で指定された形式で返されます。英語以外の言語で日付が返されるようにする場合は、これらのメッセージが適切な言語に翻訳されるようにしてください。 LANGがENGまたはNAT以外の場合は、メッセージが、実行している言語のメッセージ・ファイルに存在していることを確認する必要があります。
例
日付形式がYYMMDD(Dタイプ)の日付フィールド#YMDを、日付形式がDDMMYY(Bタイプ)の日付フィールド#DMYに変換するには、次のように指定します。
USE BUILTIN(CONVERTDATE) WITH_ARGS(#YMD D B) TO_GET(#DMY)