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. Миллионы (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                |
+---------------------+