jp.sf.orangesignal.ta.util
クラス NumberFormatUtils

java.lang.Object
  上位を拡張 jp.sf.orangesignal.ta.util.NumberFormatUtils

public abstract class NumberFormatUtils
extends Object

数値/通貨のフォーマットと解析をロケールを考慮して行うユーティリティを提供します。

このクラスは、DecimalFormat の使用を簡素化する為のユーティリティ機能を提供します。

導入されたバージョン:
2.1
作成者:
杉澤 浩二

コンストラクタの概要
NumberFormatUtils()
           
 
メソッドの概要
static String format(Number number, String pattern)
          指定された数値をフォーマットして文字列を作成します。
static String format(Number number, String pattern, Locale locale)
          指定された数値をフォーマットして文字列を作成します。
static String format(Number number, String pattern, Locale locale, String currencyCode)
          指定された数値をフォーマットして文字列を作成します。
static Number parse(String source, String[] patterns)
          指定された複数の数値/通貨書式文字列を順番に使用して、指定された数値/通貨文字列を解析します。
static Number parse(String source, String[] patterns, Locale locale)
          指定された複数の数値/通貨書式文字列を順番に使用して、指定された数値/通貨文字列を解析します。
static Number parse(String source, String[] patterns, Locale locale, String[] currencyCodes)
          指定された複数の数値/通貨書式文字列と通貨コードを順番に使用して、指定された数値/通貨文字列を解析します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

NumberFormatUtils

public NumberFormatUtils()
メソッドの詳細

parse

public static Number parse(String source,
                           String[] patterns)
                    throws ParseException

指定された複数の数値/通貨書式文字列を順番に使用して、指定された数値/通貨文字列を解析します。

パラメータ:
source - 解析する数値/通貨文字列
patterns - 数値/通貨書式文字列群
例外:
IllegalArgumentException - 数値/通貨文字列または数値/通貨書式文字列群、通貨コード群に不正な値が指定された場合
ParseException - 指定された数値/通貨文字列が解析できない場合
関連項目:
parse(String, String[], Locale, String[])

parse

public static Number parse(String source,
                           String[] patterns,
                           Locale locale)
                    throws ParseException

指定された複数の数値/通貨書式文字列を順番に使用して、指定された数値/通貨文字列を解析します。

パラメータ:
source - 解析する数値/通貨文字列
patterns - 数値/通貨書式文字列群
locale - 解析で使用する地域情報
戻り値:
解析された数値/通貨
例外:
IllegalArgumentException - 数値/通貨文字列または数値/通貨書式文字列群、通貨コード群に不正な値が指定された場合
ParseException - 指定された数値/通貨文字列が解析できない場合
関連項目:
parse(String, String[], Locale, String[])

parse

public static Number parse(String source,
                           String[] patterns,
                           Locale locale,
                           String[] currencyCodes)
                    throws ParseException

指定された複数の数値/通貨書式文字列と通貨コードを順番に使用して、指定された数値/通貨文字列を解析します。

このメソッドでは Java 仮想マシンの言語や地域などのホスト環境に依存せずに、数値/通貨の解析を行うことが可能です。

 以下は Java 仮想マシンの言語や地域などのホスト環境に依存せずに、日本の数値形式で表現されているアメリカ・ドル通貨文字列を解析する場合の例です。
Number number = NumberFormatUtils.parse("USD 123,456,789.10", new String[]{ "¤¤ #,##0.00" }, Locale.JAPAN, new String[]{ "USD" });

パラメータ:
source - 解析する数値/通貨文字列
patterns - 数値/通貨書式文字列群
locale - 解析で使用する地域情報
currencyCodes - 通貨コード (ISO 4217 コード) 群
戻り値:
解析された数値/通貨
例外:
IllegalArgumentException - 数値/通貨文字列または数値/通貨書式文字列群、通貨コード群に不正な値が指定された場合
ParseException - 指定された数値/通貨文字列が解析できない場合

format

public static String format(Number number,
                            String pattern)

指定された数値をフォーマットして文字列を作成します。

パラメータ:
number - フォーマットする数値
pattern - 数値/通貨書式文字列
戻り値:
フォーマットされた数値文字列
例外:
IllegalArgumentException - 数値または数値/通貨書式文字列に null が指定された場合。 または数値/通貨書式文字列に指定されたパターンが正しくない場合。 または指定された数値をフォーマットできない場合。
関連項目:
format(Number, String, Locale, String)

format

public static String format(Number number,
                            String pattern,
                            Locale locale)

指定された数値をフォーマットして文字列を作成します。

パラメータ:
number - フォーマットする数値
pattern - 数値/通貨書式文字列
locale - フォーマットで使用する地域情報
戻り値:
フォーマットされた数値文字列
例外:
IllegalArgumentException - 数値または数値/通貨書式文字列に null が指定された場合。 または数値/通貨書式文字列に指定されたパターンが正しくない場合。 または指定された数値をフォーマットできない場合。
関連項目:
format(Number, String, Locale, String)

format

public static String format(Number number,
                            String pattern,
                            Locale locale,
                            String currencyCode)

指定された数値をフォーマットして文字列を作成します。

このメソッドでは Java 仮想マシンの言語や地域などのホスト環境に依存せずに、数値/通貨のフォーマットを行うことが可能です。

 以下は Java 仮想マシンの言語や地域などのホスト環境に依存せずに、日本の数値形式でアメリカ・ドル通貨文字列へフォーマットする場合の例です。
String str = NumberFormatUtils.format(Double.valueOf(123456789.10D), "¤¤ #,##0.00", Locale.JAPAN, "USD");

パラメータ:
number - フォーマットする数値
pattern - 数値/通貨書式文字列
locale - フォーマットで使用する地域情報
currencyCode - 通貨コード (ISO 4217 コード)
戻り値:
フォーマットされた数値文字列
例外:
IllegalArgumentException - 数値または数値/通貨書式文字列に null が指定された場合。 または数値/通貨書式文字列に指定されたパターンが正しくない場合。 または通貨コードが、サポートされた ISO 4217 コードでない場合。 または指定された数値をフォーマットできない場合。


Copyright © 2006-2009 OrangeSignal.com. All Rights Reserved.