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