Number.ToText

構文

Number.ToText(number as nullable number, optional format as nullable text, optional culture as nullable text) as nullable text

バージョン情報

format によって指定された形式に従って、数値 number をテキスト値の形式に設定します。 この形式は、単一文字コードであり、必要に応じて、数字の有効桁数指定子がその後ろに付けられます。 format には次の文字コードを使用できます。

  • "D" または "d": (10 進数) 結果の形式を整数の桁数として設定します。 有効桁数指定子によって出力の桁数が制御されます。
  • "E" または "e": (指数/科学的表記) 指数表記。 有効桁数指定子によって、小数点以下の最大桁数が制御されます (既定値は 6)。
  • "F" または "f": (固定小数点) 整数および小数点以下の桁数。
  • "G" または "g": (標準) 固定小数点または科学的表記のうち、最もコンパクトな形式。
  • "N" または "n": (数値) グループ区切りの記号および小数点の記号を含む整数および小数点以下の桁数。
  • "P" または "p": (パーセント) 100 を乗算し、パーセント記号付きで表示される数値。
  • "R" または "r": (ラウンドトリップ) 同一の数値をラウンドトリップできるテキスト値。 有効桁数指定子は無視されます。
  • "X" または "x": (16 進数) 16 進テキスト値。

オプションの culture を指定することもできます (例: "en-US")。

例 1

形式を指定せずに、数値をテキストの形式で設定します。

使用方法

Number.ToText(4)

出力

"4"

例 2

数値を指数形式のテキストの形式で設定します。

使用方法

Number.ToText(4, "e")

出力

"4.000000e+000"

例 3

数値を、有効桁数が制限された 10 進数形式のテキストの形式で設定します。

使用方法

Number.ToText(-0.1234, "P1")

出力

"-12.3 %"