Перейти к содержимому
Последнее обновление

FORMAT

Описание​

Функция FORMAT возвращает строку, отформатированную с использованием указанной строки формата и параметров. Правила форматирования соответствуют спецификации формата fmt.

Синтаксис​

FORMAT(<format>, <args>[, ...])

Параметры​

ПараметрОписание
<format>Строка формата, содержащая заполнители. Тип: VARCHAR
<args>Параметры для форматирования (может быть несколько). Тип: ANY

Возвращаемое значение​

Возвращает значение типа VARCHAR, представляющее результат форматирования согласно строке формата.

Особые случаи:

  • Если хотя бы один параметр равен NULL, возвращается NULL
  • В строке формата в качестве заполнителя используется {}
  • Поддерживаются позиционные параметры (например, {0}, {1}) и именованные параметры
  • Поддерживаются различные настройки форматирования (выравнивание, точность, заполнение и т. д.)

Примеры​

  1. Базовое использование: форматирование числа с заданной точностью
SELECT format('{:.2}', pi());
+-----------------------+
| format('{:.2}', pi()) |
+-----------------------+
| 3.1                   |
+-----------------------+
  1. Форматирование нескольких параметров
SELECT format('{0}-{1}', 'hello', 'world');
+-------------------------------------+
| format('{0}-{1}', 'hello', 'world') |
+-------------------------------------+
| hello-world                         |
+-------------------------------------+
  1. Выравнивание и заполнение
SELECT format('{:>10}', 123);
+-----------------------+
| format('{:>10}', 123) |
+-----------------------+
|        123            |
+-----------------------+
  1. Обработка значения NULL
SELECT format('{:.2}', NULL);
+-----------------------+
| format('{:.2}', NULL) |
+-----------------------+
| NULL                  |
+-----------------------+
  1. Обработка строк UTF-8
SELECT format('{0}-{1}', 'ṭṛṭṛ', 'ṭṛ');
+---------------------------------------------+
| format('{0}-{1}', 'ṭṛṭṛ', 'ṭṛ')             |
+---------------------------------------------+
| ṭṛṭṛ-ṭṛ                                     |
+---------------------------------------------+
Report issue