概要 | パッケージ | クラス | 使用 | 階層ツリー | 非推奨 API | 索引 | ヘルプ
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

## 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 コードでない場合。 または指定された数値をフォーマットできない場合。

概要 | パッケージ | クラス | 使用 | 階層ツリー | 非推奨 API | 索引 | ヘルプ
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

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