日付・時刻(日付時刻)の活用ポイントを説明します。

日付・時刻型で「日付」「時刻」「日付と時刻」の3種類から「日付時刻」を選択すると、日付時刻を扱う項目が用意されます。年月日と時刻を同時に扱うもので、年は1753年〜9999年の範囲で指定できます。

図1 日付時刻型

Javaとの関係

時刻型項目は、内部では java.sql.Timestamp クラスとして管理されます。

Wagbyでは、入力された値は「フィルタ」によって補正されます。 フィルタにより「ゆれ」を自動的に補正することができます。この機能は自動的に設定されます。
フィルタはWebフォーム、アップロード更新、REST APIいずれも共通で利用されます。

日付時刻型項目で選択できるフィルタは日付型と同じです。詳細は「日付型 > 入力フィルタ」をお読みください。

「入力制御 > 日付・時刻型 > 日付入力方式」に「カレンダの利用」を指定すると、図2のような入力欄が用意されます。

図2 日付時刻型項目の入力欄

時刻部分は、マウスで入力欄にカーソルをあわせ、手動で入力できます。(日付を再選択した場合、時刻はゼロに戻ります。)

日付時刻をリストボックスで入力することは現在、未サポートです。将来の Wagby で対応する計画です。

日付入力方式を空欄とした場合、テキストフィールドで直接、日付時刻を入力します。 テキストフィールドで入力する場合の入力方式は、「出力制御 > 日付・時刻 > フォーマット」に従います。例を示します。

図3 日付時刻入力方式のフォーマット設定

yyyy-MM-dd HH:mm:ss

  • 年を西暦4桁で入力します。
  • 月を 1 から 12 の範囲で入力します。
  • 日を 1 から 31 の範囲で入力します。
  • 時間は 0 から 23 まで、分と秒は 0 から 59 の範囲で入力できます。
  • 年、月、日それぞれ空白で区切って入力します。時間、分、秒をそれぞれ空白またはコロン (":") 文字で区切って入力します。(例 2014 1 2 3 4 5 なら2014年1月2日3時4分5秒となります)

このルールにそぐわない値を入力した場合は、日付時刻として認識されません。保存すると空白になります。