FORMAT_NUMBER

説明

FORMAT_NUMBER関数は数値を単位記号付きの文字列にフォーマットします。サポートされている単位は以下の通りです：K（千）、M（百万）、B（十億）、T（兆）、Q（千兆）。

構文

FORMAT_NUMBER(<val>)

パラメータ

Parameter	デスクリプション
<val>	フォーマットする数値。型: DOUBLE

Return Value

VARCHAR型を返す。単位記号付きのフォーマット済み文字列を表す。

特殊なケース:

• パラメータがNULLの場合、NULLを返す
• 1000未満の数値は単位なしでそのまま返される
• 単位変換ルール:
  • K: thousand (1,000)
  • M: million (1,000,000)
  • B: billion (1,000,000,000)
  • T: trillion (1,000,000,000,000)
  • Q: quadrillion (1,000,000,000,000,000)

Examples

1. 基本的な使用法: thousand (K)

SELECT format_number(1500);

+---------------------+
| format_number(1500) |
+---------------------+
| 1.50K               |
+---------------------+

2. Million (M)

SELECT format_number(5000000);

+------------------------+
| format_number(5000000) |
+------------------------+
| 5.00M                  |
+------------------------+

3. 千未満の数値

SELECT format_number(999);

+----------------------------------+
| format_number(cast(999 as DOUBLE))|
+----------------------------------+
| 999                              |
+----------------------------------+

4. NULL値の処理

SELECT format_number(NULL);

+---------------------+
| format_number(NULL) |
+---------------------+
| NULL                |
+---------------------+