Format Number 関数

Format Number 関数は、指定されたパターンに適合するように形式設定された数字としてストリングを返します。

パラメーター: number

形式設定する数値。 これはソース・ノード、別の関数の結果、または指定した値にすることができます。

パラメーター: string

最初のパラメーターの形式設定方法を指定するパターン。 このパターンは、以下のシンボルを使用してパターンを定義します。
  • 必須桁 = 0
  • オプション桁 = #
  • 負符号 = -
  • 10 進記号 = .
  • グループ分離文字 = ,。 一般的には、3 桁のグループを分離するために使用されます。
  • パーセント記号 = %。 パーセント記号があると、入力数値に 100 が乗算され、結果がパーセンテージとして示されます。
  • パーミル記号 =  (Unicode x2030)。 この記号により、数値に 1000 が乗算され、結果がパーミルとして示されます。
  • 正/負分離文字 = ;
  • 無限 = infinity
  • 非数値 = NaN
  • $ = $
パターンには、接頭部、接尾部、またはその両方として定数テキストを含めることができます。 一般的には、通貨記号または何らかの単位を指定するために使用されます。
  • $#,##0.00 - ドル記号、コンマ (分離文字)、および 1 桁以上のドルと 2 桁のセントを使用して、米国ドルの標準形式で数値を形式設定します。
  • #0.000% - 小数点以下が 3 桁以上のパーセンテージとして、10 進数を形式設定します。
  • #,##0.00;(#,##0.00) - 負の数値を小括弧を使用して形式設定します。 この形式は一般に会計で使用されます。

戻り: string

2 番目のパラメーターで指定されたパターンを反映させて再形式設定された最初のパラメーター。

パターンには、接頭部、接尾部、またはその両方として定数テキストを含めることができます。 一般的には、通貨記号または何らかの単位を指定するために使用されます。

例 1

$#,##0.00 - ドル記号、コンマ (分離文字)、および 1 桁以上のドルと 2 桁のセントを使用して、米国ドルの標準形式で数値を形式設定します。

format-number(12345.6789,'$#,##0.00') = '$12,345.67'
例 2

#0.000% - 小数点以下が 3 桁以上のパーセンテージとして、10 進数を形式設定します。

format-number(.67890123,'#0.000%') = '67.890%'

パーセント記号があると、入力数値に 100 が乗算されます。

例 3

#,##0.00;(#,##0.00) - 負の数値を小括弧を使用して形式設定します。 この形式は一般に会計で使用されます。

format-number(-12345.6789,'#,##0.00;(#,##0.00)') = '(12,345.67)'