JSF Coreライブラリ - <f:convertDateTime>タグ

ID javax.faces.DateTimeに登録されるコンバータのインスタンスを作成および構成します。文字列からjava.util.Date値へ、またはその逆に変換する際に使用します。

構文

<f:convertDateTime
  [dateStyle="default|short|medium|long|full"]
  [timeStyle="default|short|medium|long|full"]
  [pattern="pattern"]
  [type="time|date|both"]
  [locale="locale"]
  [timezone="timezone"]
/>    

属性

dateStyle
文字列。受入れ可能ないずれかの日付パターン値(「構文」を参照)。
timeStyle
文字列。受入れ可能ないずれかの時間パターン値(「構文」を参照)。
pattern
文字列。java.text.SimpleDateFormatの定義に従って日付および時間のパターンを構成する記号。「パターン書式」を参照。
type
文字列。timeStyleを設定するとtimeにデフォルト設定されます。dateStyleを設定するとdateにデフォルト設定されます。両方とも設定するとbothに設定されます。
locale
文字列またはjava.util.Locale。デフォルトのかわりに使用するロケール。
timeZone
文字列またはjava.util.TimeZone。デフォルトのかわりに使用するタイムゾーン。

パターン書式

日付と時間の書式を決定する記号のパターン。たとえば、ロケール依存の日付パターン書式と時間パターン書式が"EEE, MMM d, yyyy"と"h:mm a"の場合、米国ロケールを指定すると、出力は"Thu, Apr 9, 1998"と"6:15 PM"になります。

日付と時間のパターンと記号の詳細は、Javaクラスjava.text.SimpleDateFormatを参照してください。

コード・サンプル

<h:inputText id="hiredate" value="#{employee.hireDate}">
  <f:convertDateTime dateStyle="full"/>
</h:inputText>    

リファレンス: JSF標準コンポーネント


変換または検証エラー・メッセージの表示