JSFコア・ライブラリ - <f:convertNumber>タグ

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

構文

<f:convertNumber
  [pattern="pattern"]
  [minIntegerDigits="min"] [maxIntegerDigits="max"]
  [minFractionDigits="min"] [maxFractionDigits="max"]
  [groupingUsed="true|false"] [integerOnly="true|false"]
  [type="number|currency|percent"] 
  [currencyCode="currencyCode"] [currencySymbol="currencySymbol"]
  [locale="locale"] 
/>

属性

pattern
文字列。java.text.DecimalFormatの定義に従って数値パターンを構成する記号。「パターン書式」を参照。
minIntegerDigits
整数。整数部分の最小桁数。
maxIntegerDigits
整数。整数部分の最大桁数。
minFractionDigits
整数。小数部分の最小桁数。
maxFractionDigits
整数。小数部分の最大桁数。
groupingUsed
ブール値。trueの場合は、結果にグループ・セパレータが含まれます。
integerOnly
ブール値。trueの場合は、整数部分のみが解析されます。
type
文字列。受入れ可能ないずれかのtype値(「構文」を参照)。
currencyCode
文字列。ISO-4217通貨コード。
currencySymbol
文字列。通貨記号として使用するJava文字列。
locale
文字列またはjava.util.Locale。デフォルトのかわりに使用するロケール。

パターン書式

数値の書式を決定する記号のパターン。たとえば、ロケール依存のパターンが###,###.###でロケールがen_USの場合、書式設定された数値は123,456.789になります。

数値パターンと記号の詳細は、Javaクラスjava.text.DecimalFormatを参照してください。

コード・サンプル

<h:inputText id="sal" value="#{employee.salary}">
  <f:convertNumber integerOnly="true"/>
</h:inputText>

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


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