NumberFormat 機能

構文

NumberFormat(number, pattern, [options])

パラメーター

• 数値：フォーマットされる数値。 つまり、リテラル値、カラム参照、他の関数の結果を指定することができる。 必須
• パターン：正の数の書式を指定する文字列で、セミコロンで区切られた負の数の書式を指定することもできる（例："#,###.#;(#,###.#)"）。オプション
• オプション：オプションの名前付き引数。 対応オプションは以下の通り：
  • compact:省略記法を適用する（サポートされる値については、以下の「コンパクト記法リファレンス」セクションを参照）
  • negSymbol:負の数の表示方法には、 dash、 parens、 none、 default を使用する
  • posColor negColor: HTMLの16進コード（例： ）を使ってフォントの色を設定する。 #FF0000
  • posBold negBold: 太字のスタイリングを適用 (, )true false
  • posItalic negItalic: イタリック体を適用 (, )true false
  • posUnderline negUnderline: アンダーライン・スタイルを適用 (, )true false
  • posPrefix negPrefix: 番号の前にHTML/テキストを追加する
  • posSuffix negSuffix: 番号の後にHTML/テキストを追加 オプション

動作

• 数値入力を、指定されたパターンに従ってフォーマットされた文字列に変換する。
• 丸め、通貨記号、パーセンテージ、指数表記、バイト/ビットのショートサンドをサポート。
• 継続時間（秒）を「2時間2分」のような書式付き文字列に変換できる。
• XA、XKなどのコードを使用したデータサイズのバイナリフォーマットを提供。
• ハーフアップ丸めを適用：1-4で終わる値は切り捨て、5-9は切り上げる。
• パターンが指定されない場合、数値は整数に丸められ、カンマ付きで表示される。

例

NumberFormat({Revenue}, "$#,##0.00"): {Revenue} 例えば、"$1, 234.56 " のように。

NumberFormat(7322, "s"):7322秒をフォーマットされた継続時間文字列に変換：「2時間2分2秒"。

NumberFormat(922, "MB"):922 MB を " 0.9 GB" のような人間が読める文字列に整形する。

NumberFormat(Percent, "00%"):例えば、 0.42 は "42%"となる。

NumberFormat($_, "#,###.#B", compact="XA"):例：" 1.0 GB"。

NumberFormat(-62619000.185, "#,###.#B;(#,###.##)"):正パターン #,###.#B と負パターン (#,###.##) を使って負数 -62,619, 000.185 を整形し、その結果 (62,619,000.19) が得られる。

NumberFormat({NetIncome}, "$#,##0.00", compact="M", negColor="#FF0000", posBold=true): {NetIncome} 列を百万通貨単位でフォーマットする。 マイナスの数字は赤で表示され、プラスの数字は太字で表示される。

ノート

• この関数は、ラベル・タイプの列、またはメトリック/レポート新規列のフォーマット式でのみ使用する。
• 数値列では書式設定は無視される。
• patternも negativePattern も指定されない場合、値は千区切りで最も近い整数に丸められます。
• HTMLを含むフォーマットでは、接頭辞/接尾辞タグがバランスよく有効であることを確認してください。

コンパクト記法リファレンス

以下の表は、サポートされているコンパクト記法の値を示しています。 表中、Codeの列は、compact=オプション・パラメーターの後に置くことができる値を示しています。 チャートのパターン」欄には、フォーマットパターンの最後に追加できる項目が表示されます。

標準速記法

以下の標準的な省略記法がサポートされている。 各標準速記フォーマットに表示される記号はロケールごとに異なり、プロジェクト設定ダイアログで再設定できる。 つまり、例えばこの数値フォーマット関数は、すべての標準的な省略記法を使うことになる：

=NumberFormat($_, "#.#", compact=A)

バイナリ速記法

以下の2進数の省略記法もサポートしている：

バイナリー・ショートハンドを使う場合、多くの場合、バイト数を要約することになる。 この場合、 NumberFormat ：

=NumberFormat($_, "#,###.#B", compact="XA")

同様に、これをチャートに表示するには、チャート番号の書式として次のように入力します：#, ###.#B{@Xa }

戻りの型

ストリング