@Documented
@Retention(value=RUNTIME)
@Target(value={METHOD,FIELD,PARAMETER,ANNOTATION_TYPE})
public @interface NumberFormat スタイルまたはカスタムパターン文字列によるフォーマットをサポートします。すべての JDK java.lang.Number 型に適用できます。
スタイルベースの書式設定の場合、style() 属性を目的の NumberFormat.Style に設定します。カスタム書式設定の場合、pattern() 属性を #, ###.## などの番号パターンに設定します。
各属性は相互に排他的であるため、アノテーションインスタンスごとに 1 つの属性のみを設定します(書式設定のニーズに最も適した属性)。pattern() 属性が指定されている場合、style() 属性よりも優先されます。アノテーション属性が指定されていない場合、適用されるデフォルトの形式は、アノテーション付きフィールドまたはメソッドのパラメーター型に応じて、いずれかの通貨のスタイルに基づいています。
NumberFormat| 修飾子と型 | オプションの要素と説明 |
|---|---|
java.lang.String | pattern フィールドのフォーマットに使用するカスタムパターン。 |
NumberFormat.Style | style フィールドのフォーマットに使用するスタイルパターン。 |
public abstract NumberFormat.Style style
ほとんどのアノテーション付き型の汎用数値フォーマットでは、デフォルトで NumberFormat.Style.DEFAULT が使用されます。ただし、通貨型がデフォルトの通貨型は除きます。デフォルトのスタイル以外の一般的なスタイルに従ってフィールドをフォーマットする場合、この属性を設定します。