dateFormat
dateFormat プロパティーは、EGL が日付の構文解析または表示に使用する形式を識別します。
以下の値が有効です。
- "pattern"
- pattern は、日付形式を記述する文字で構成されます。 『日付、時刻、およびタイム・スタンプのフォーマット指定子』を参照してください。
- defaultDateFormat
- defaultDateFormat ビルド記述子オプションにおいて指定する形式です。詳しくは、「EGL 生成ガイド」を参照してください。 このビルド記述子を指定しない場合、EGL はローカルの Java™ のデフォルト日付形式、または文字列「MM/dd/yyyy」を使用します。
- eurDateFormat
- 「dd.MM.yyyy」パターン (IBM® 欧州標準規格の日付形式)。
- isoDateFormat
- 「yyyy-MM-dd」パターン (International Standards Organization (ISO) により指定された日付形式)
- jisDateFormat
- 「yyyy-MM-dd」パターン (日本工業規格 (JIS) 日付形式)。
- usaDateFormat
- 「MM/dd/yyyy」パターン (IBM USA 標準規格の日付形式)。
- systemGregorianDateFormat
- dd (日数)、MM (月数)、および yy か yyyy (年数) を、d、M、y または数字以外の、区切り文字として使用される文字と一緒に含む、8 または 10 文字のパターン。
COBOL プログラムの場合、 EGL ランタイム・サービスのシステム管理者がインストール時に形式を設定します。
Java プログラムでは、 形式は次の Java ランタイム・プロパティーに設定されています。vgj.datemask.gregorian.long.NLS- NLS
- vgj.nls.code Java ランタイム・プロパティーに
指定されている NLS (各国語サポート) コード。このコードは、targetNLS ビルド記述子オプションにリストされているコードの 1 つです。
大文字の英語
(コード ENP) はサポートされていません。
vgj.nls.code について詳しくは、「EGL 生成ガイド」を参照してください。
- systemJulianDateFormat
- DDD (日数)、および yy か yyyy (年数) を、D、y、または数字以外の、区切り文字として使用される文字とともに含む、6 または 8 文字のパターン。
COBOL プログラムの場合、 EGL ランタイム・サービスのシステム管理者がインストール時に形式を設定します。
Java プログラムでは、 形式は次の Java ランタイム・プロパティーに設定されています。vgj.datemask.julian.long.NLS- NLS
- vgj.nls.code Java ランタイム・プロパティーに
指定されている NLS (各国語サポート) コード。このコードは、targetNLS ビルド記述子オプションにリストされているコードの 1 つです。
大文字の英語
(コード ENP) はサポートされていません。
vgj.nls.code について詳しくは、「EGL 生成ガイド」を参照してください。
日付の長さに関する考慮事項
書式内で、書式上のフィールド長は、指定するフィールド・マスクの長さ以上であることが必要です。 フィールド長は、日付の内部形式を保持するために十分な長さであることが必要です。
JSF ハンドラー・フィールドにおける規則は以下のとおりです。
- フィールド長は、指定された日付マスクに十分な長さでなければならないが、それより長くてもよい
- 数値フィールドの場合、区切り文字は長さの計算から除外される
下の表は、さまざまな日付形式の例を示しています。
| 形式タイプ | 例 | 書式フィールド長 | ページ・フィールドの最小長さ (文字型) | ページ・フィールドの有効長さ (数値型) |
|---|---|---|---|---|
| 短いグレゴリオ暦 | yy/MM/dd | 8 | 8 | 6 |
| 長いグレゴリオ暦 | yyyy/MM/dd | 10 | 10 | 8 |
| 短いユリウス暦 | DDD-yy | 6 | 6 | 5 |
| 長いユリウス暦 | DDD-yyyy | 8 | 8 | 7 |
日付の入出力に関する考慮事項
変数フィールドに入力されたデータは、指定された形式で日付が入力されたかチェックされます。ユーザーは、日付および月の先行ゼロを入力する必要はなく、(例えば) 08/05/1996 でなく 8/5/1996 を指定することができます。ただし、区切り文字を省略した場合は、先行ゼロをすべて入力する必要があります。
互換性
| データ項目 | JSF ハンドラー | VGUI レコード | コンソール UI | テキスト書式 Java | テキスト書式 COBOL | 印刷書式 Java | 印刷書式 COBOL |
|---|---|---|---|---|---|---|---|
| あり | あり | あり | あり | あり | あり | あり | あり |