jp.finaluna.api.type.util
インタフェース NumberFormatUtil


@Rcsid(value="$Revision$ $Date")
public interface NumberFormatUtil

数値を文字列に変換し整形する。 数字を表す整形された文字列を解釈し数値に変換する。

パターンを指定して、数字文字列の出力、解析を行う。

パターンは以下の文字列を組み合わせて指定する。

0 指定桁数に満たない場合はゼロ埋め
(例:123) 00000→「00123」
# ゼロだと表示されない
(例:123) #,###→「123」
. 数値桁区切り子
(例:12.3) ##0.00→「12.30」
, グループ区切り子
(例:123456)#,###→「123,456」
- マイナス記号
(例:-123456)#,###;-#,###→「-123,456」
% 接尾辞(100 倍してパーセントを表す)
(例:1.234) ###.##%→「123.4%」
; サブパターン境界(正と負のサブパターンを区切る)
(例:123456) #,###;#,###CR→「123,456」
(例:-123456) #,###;#,###CR→「123,456CR」

バージョン:
$Revision$ $Date$
作成者:
NTTデータ

メソッドの概要
 StringCode format(DecimalType number, StringCode pattern)
          受け取ったDecimalTypeを数値フォーマットで指定したフォーマットの文字列表現で返す。
 StringCode format(DecimalType number, StringCode pattern, MathUtil.Round roundingMode)
          受け取ったDecimalTypeを数値フォーマットで指定したフォーマットの文字列表現で返す。
 StringCode format(IntegerType integer, StringCode pattern)
          受け取ったIntegerTypeを数値フォーマットで指定したフォーマットの文字列表現で返す。
 DecimalType parseDecimalType(StringCode numberString, StringCode pattern)
          受け取ったIntegerTypeを数値フォーマットで指定したフォーマットの文字列表現で返す。
 IntegerType parseIntegerType(StringCode integerString, StringCode pattern)
          受け取ったStringCodeをIntegerTypeにparseして返す。
 StringCode toPlainStringCode(DecimalType number)
          指数フィールドなしで、受け取ったDecimalTypeの文字列表現を返す。
 

メソッドの詳細

toPlainStringCode

StringCode toPlainStringCode(DecimalType number)
指数フィールドなしで、受け取ったDecimalTypeの文字列表現を返す。

パラメータ:
number - 変換対象の型
戻り値:
処理結果文字列表現

format

StringCode format(DecimalType number,
                  StringCode pattern)
受け取ったDecimalTypeを数値フォーマットで指定したフォーマットの文字列表現で返す。 丸めが必要な場合にはMathUtil.ROUND_HALF_EVENを使用する。

パラメータ:
number - 指定数値
pattern - 数値フォーマット
戻り値:
処理結果文字列表現

format

StringCode format(DecimalType number,
                  StringCode pattern,
                  MathUtil.Round roundingMode)
受け取ったDecimalTypeを数値フォーマットで指定したフォーマットの文字列表現で返す。

パラメータ:
number - 指定数値
pattern - 数値フォーマット
roundingMode - 丸めモード
戻り値:
処理結果文字列表現

format

StringCode format(IntegerType integer,
                  StringCode pattern)
受け取ったIntegerTypeを数値フォーマットで指定したフォーマットの文字列表現で返す。

パラメータ:
integer - 指定数値
pattern - 数値フォーマット
戻り値:
処理結果文字列表現

parseDecimalType

DecimalType parseDecimalType(StringCode numberString,
                             StringCode pattern)
                             throws FinalunaFormatException
受け取ったIntegerTypeを数値フォーマットで指定したフォーマットの文字列表現で返す。

パラメータ:
numberString - 指定文字列
pattern - 数値フォーマット
戻り値:
処理結果文字列表現
例外:
FinalunaFormatException - フォーマット処理に失敗した場合

parseIntegerType

IntegerType parseIntegerType(StringCode integerString,
                             StringCode pattern)
                             throws FinalunaFormatException
受け取ったStringCodeをIntegerTypeにparseして返す。

小数以下の数は切り捨てる。

パラメータ:
integerString - 指定文字列
pattern - 数値フォーマット
戻り値:
変換後オブジェクト
例外:
FinalunaFormatException - フォーマット処理に失敗した場合