FORMAT_NUMBER

説明

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

構文

FORMAT_NUMBER(<val>)

パラメータ

パラメータ	説明
<val>	フォーマットする数値。型: DOUBLE

戻り値

VARCHAR型を返し、単位記号付きでフォーマットされた文字列を表します。

特殊なケース:

• パラメータがNULLの場合、NULLを返します
• 1000未満の数値は単位なしでそのまま返されます
• 単位変換ルール:
  • K: 千 (1,000)
  • M: 百万 (1,000,000)
  • B: 十億 (1,000,000,000)
  • T: 一兆 (1,000,000,000,000)
  • Q: 千兆 (1,000,000,000,000,000)

例

1. 基本的な使用法: 千 (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                |
+---------------------+