画面・帳票サポートシステム XMAP3 開発ガイド

[目次][用語][索引][前へ][次へ]

8.5.5 入出力日付・時刻テキスト入出力日付・時刻フィールド

入出力日付・時刻テキスト/入出力日付・時刻フィールドは,キーボードなどから日付時刻を表すデータを入力するとき,およびAPから渡される日付や時刻を表すデータを表示するときに使用します。

表示されている出力データを必要に応じて編集したり,日付や時刻を表記する形式(表示書式)を選んだりできます。また,入出力対象にする単位(年/月/日,時/分/秒)なども指定できます。

<この項の構成>
(1) 設定できる項目
(2) 表示形式(数字表示)
(3) 表示形式(元年表示)
(4) 表示形式の例
(5) データのチェック
(6) データ入力後の動作
(7) 画面確定時のチェック
(8) 入力時のAPの操作
(9) 出力時のAPの操作
(10) 表示属性の動的変更

(1) 設定できる項目

入出力日付テキスト/入出力日付フィールドの項目と設定できる値を次の表に示します。

表8-19 入出力日付テキスト/入出力日付フィールドの項目と設定できる値

項目 動的変更 設定できる値
テキスト フィールド 日付テキスト 日付フィールド
表示書式 12.1.11 表示書式」を参照 12.1.11 表示書式」を参照
入力形式 表示書式に連動して自動的に変更 表示書式に連動して自動的に変更
チェック範囲 部分,全体 部分,全体
空白入力 全桁(半角),一部(半角) 全桁(半角),一部(半角)
遷移条件 手動スキップ,自動スキップ 手動スキップ,自動スキップ
表示方法 入力可能-標準表示,
入力可能-文字だけ非表示,
入力不可-標準表示,
入力不可-グレーアウト表示,
入力不可-文字だけ非表示,
全体非表示
入力可能-標準表示,
入力可能-文字だけ非表示,
入力不可-標準表示,
入力不可-文字だけ非表示
背景色 白,赤,緑,青,ライトレッド,ライトブルー,黄,グレー,黒,ダークグレー,ライトグレー,ダークグリーン,ライトグリーン,ライトイエロー,ダークブルー,透明
枠高 3ます,2.5ます,2ます
文字色 白,赤,緑,青,紫,空,黄,黒,ダークレッド,ダークブルー,ダークグリーン,ダークイエロー 白,赤,緑,青,紫,空,黄,黒,ダークレッド,ダークブルー,ダークグリーン,ダークイエロー
文字サイズ 大,標準,小
文字の書体 標準,明朝,ゴシック
文字の強調 標準,太字,斜体,太字&斜体
テキスト※1・フィールド※2反復 回数は,
縦方向:1〜96
横方向:1〜160
間隔は,
縦方向:0〜92
横方向:0〜158
回数は,
縦方向:1〜127
横方向:1〜255
間隔は,
縦方向:0〜125
横方向:0〜253
反転表示する チェックあり/チェックなし チェックあり/チェックなし
フォーカス設定 チェックあり/チェックなし チェックあり/チェックなし
入力済み チェックあり/チェックなし チェックあり/チェックなし
自動送信 チェックあり/チェックなし チェックあり/チェックなし
入力必須 チェックあり/チェックなし チェックあり/チェックなし
ワンタッチクリア チェックあり/チェックなし チェックあり/チェックなし
印字する チェックあり/チェックなし
APが受け取る項目 データ名 8.6 APが受け取る項目およびAPが渡す項目」を参照 8.6 APが受け取る項目およびAPが渡す項目」を参照
データ長
データ型
格納形式
APからデータを表示する
下位項目
APが渡す項目 データ名 8.6 APが受け取る項目およびAPが渡す項目」を参照 8.6 APが受け取る項目およびAPが渡す項目」を参照
データ長
データ型
格納形式
下位項目
動的変更
(凡例)
○:動的変更できる。
−:動的変更できない,または,該当しない。
注※1
レイアウト領域に収まる範囲で指定できます。
注※2
プレーン領域に収まる範囲で指定できます。

入出力時刻テキスト/入出力時刻フィールドの項目と設定できる値を次の表に示します。

表8-20 入出力時刻テキスト/入出力時刻フィールドの項目と設定できる値

項目 動的変更 設定できる値
テキスト フィールド 時刻テキスト 時刻フィールド
表示書式 12.1.11 表示書式」を参照 12.1.11 表示書式」を参照
入力形式 表示書式に連動して自動的に変更 表示書式に連動して自動的に変更
チェック範囲
空白入力 全桁(半角),一部(半角) 全桁(半角),一部(半角)
遷移条件 手動スキップ,自動スキップ 手動スキップ,自動スキップ
表示方法 入力可能-標準表示,
入力可能-文字だけ非表示,
入力不可-標準表示,
入力不可-グレーアウト表示,
入力不可-文字だけ非表示,
全体非表示
入力可能-標準表示,
入力可能-文字だけ非表示,
入力不可-標準表示,
入力不可-文字だけ非表示
背景色 白,赤,緑,青,ライトレッド,ライトブルー,黄,グレー,黒,ダークグレー,ライトグレー,ダークグリーン,ライトグリーン,ライトイエロー,ダークブルー,透明
枠高 3ます,2.5ます,2ます
文字色 白,赤,緑,青,紫,空,黄,黒,ダークレッド,ダークブルー,ダークグリーン,ダークイエロー 白,赤,緑,青,紫,空,黄,黒,ダークレッド,ダークブルー,ダークグリーン,ダークイエロー
文字サイズ 大,標準,小
文字の書体 標準,明朝,ゴシック
文字の強調 標準,太字,斜体,太字&斜体
テキスト※1・フィールド※2反復 回数は,
縦方向:1〜96
横方向:1〜160
間隔は,
縦方向:0〜92
横方向:0〜158
回数は,
縦方向:1〜127
横方向:1〜255
間隔は,
縦方向:0〜125
横方向:0〜253
反転表示する チェックあり/チェックなし チェックあり/チェックなし
フォーカス設定 チェックあり/チェックなし チェックあり/チェックなし
入力済み チェックあり/チェックなし チェックあり/チェックなし
自動送信 チェックあり/チェックなし チェックあり/チェックなし
入力必須 チェックあり/チェックなし チェックあり/チェックなし
ワンタッチクリア チェックあり/チェックなし チェックあり/チェックなし
印字する チェックあり/チェックなし
APが受け取る項目 データ名 8.6 APが受け取る項目およびAPが渡す項目」を参照 8.6 APが受け取る項目およびAPが渡す項目」を参照
データ長
データ型
格納形式
APからデータを表示する
下位項目
APが渡す項目 データ名 8.6 APが受け取る項目およびAPが渡す項目」を参照 8.6 APが受け取る項目およびAPが渡す項目」を参照
データ長
データ型
格納形式
下位項目
動的変更
(凡例)
○:動的変更できる。
−:動的変更できない,または,該当しない。
注※1
レイアウト領域に収まる範囲で指定できます。
注※2
プレーン領域に収まる範囲で指定できます。

(2) 表示形式(数字表示)

[図データ]

(3) 表示形式(元年表示)

[図データ]

(4) 表示形式の例

日付および時刻を入力するとき,出力するときおよび格納するときのデータの形式や,入出力の対象にする単位(年/月/日,時/分/秒)はドローで定義します。ドローで定義した入力形式を基に,キーボードから入力されたデータはチェックされ,出力形式(表示書式)を基に,APから渡されるデータは表示されます。また,データは格納形式に従ってAPに格納されます。日付および時刻の入力形式と格納形式については「12.1.11 表示書式」の表12-10および表12-11を参照してください。

(5) データのチェック

キーボードから入力した日付および時刻のデータをチェックします。なお,西暦下2桁(YY)の場合に「00」を指定すると,西暦2000年(うるう年)と見なされます。

(a) チェック範囲
(b) 時刻のチェック

時刻を「HH」「MM」「SS」に分け,それぞれの数字に対し最小値から最大値の範囲でチェックします。「HH」「MM」「SS」がそれぞれ「0〜23」「0〜59」「0〜59」を超えている場合,入力エラーになります。

(6) データ入力後の動作

次に示す項目で,データを入力したあとのフォーカス・カーソルの遷移や,APへ制御を返すタイミングなどを定義します。

(7) 画面確定時のチェック

画面属性ダイアログの「イベント通知コード」設定の「動作」に「AP通知(確定)」を指定している場合,画面確定時に「入力必須」を指定したテキスト・フィールドの内容が入力されているかがチェックされます。ヘルプの表示など,一時的に入力を中断してAPに通知を返すときは,「AP通知(中断)」「AP通知(取消)」を使用して,「入力必須」を指定したテキスト・フィールドが未入力でもチェックされないようにできます。

(8) 入力時のAPの操作

デリミタ(/や−など)を除いた形式のデータをAPに渡します。和暦の場合は,先頭に元号を指定します。時刻の場合は,24時間表示で入力します。

(例)
[図データ]
注1
和暦の元号は1桁の数字(1〜5)で表します。数字と元号との対応を次に示します。
  • 1:明治
  • 2:大正
  • 3:昭和
  • 4:平成
  • 5:*.COGNK5=の値
注2
「年月日」および「時刻」のデータは一まとまりに扱われます。「年」「月」「日」および「時」「分」「秒」それぞれのデータを分けて扱いたいときには入出力日付テキストまたは入出力時刻テキストの属性を定義するダイアログで下位項目を設定してください。

(9) 出力時のAPの操作

下位項目を指定してデータを細分化できます。下位項目はデータ型が「文字(XX)」のときに設定できます。

(10) 表示属性の動的変更

入出力の日付・時刻は,表示属性をAP実行時に変更できます。表示属性の動的変更については「8.2.4 表示属性の動的変更」を参照してください。