アノテーションインターフェース NumberFormat
@DocumentedSE
@RetentionSE(RUNTIMESE)
@TargetSE({METHODSE,FIELDSE,PARAMETERSE,ANNOTATION_TYPESE})
public @interface NumberFormat
フィールドまたはメソッドのパラメーターを数値としてフォーマットする必要があることを宣言します。
スタイルまたはカスタムパターン文字列によるフォーマットをサポートします。Double
や Long
などの JDK Number
型に適用できます。
スタイルベースの書式設定の場合、style()
属性を目的の NumberFormat.Style
に設定します。カスタム書式設定の場合、pattern()
属性を #, ###.##
などの番号パターンに設定します。
各属性は相互に排他的であるため、アノテーションインスタンスごとに 1 つの属性のみを設定します(書式設定のニーズに最も適した属性)。pattern()
属性が指定されている場合、style()
属性よりも優先されます。アノテーション属性が指定されていない場合、適用されるデフォルトの形式は、アノテーション付きフィールドまたはメソッドのパラメーター型に応じて、いずれかの通貨のスタイルに基づいています。
- 導入:
- 3.0
- 作成者:
- Keith Donald, Juergen Hoeller
- 関連事項:
ネストされたクラスのサマリー
ネストされたクラスオプション要素の概要
オプション要素修飾子と型オプションの要素説明フィールドのフォーマットに使用するカスタムパターン。フィールドのフォーマットに使用するスタイルパターン。
要素の詳細
style
NumberFormat.Style styleフィールドのフォーマットに使用するスタイルパターン。ほとんどのアノテーション付き型の汎用数値フォーマットでは、デフォルトで
NumberFormat.Style.DEFAULT
が使用されます。ただし、通貨型がデフォルトの通貨型は除きます。デフォルトのスタイル以外の一般的なスタイルに従ってフィールドをフォーマットする場合、この属性を設定します。- デフォルト:
- DEFAULT
pattern
StringSE patternフィールドのフォーマットに使用するカスタムパターン。デフォルトは空の文字列で、カスタムパターン文字列が指定されていないことを示します。スタイルで表されないカスタム番号パターンに従ってフィールドをフォーマットする場合、この属性を設定します。
- デフォルト:
- ""