Форматирование
в процессеЗадавайте каждому столбцу то оформление и ту ширину, которых он заслуживает, автоматически при каждом выполнении запроса.
Директивы форматирования задают, как должен выглядеть отдельный столбец — числа, даты, логические значения, текст и так далее, — и применяются при каждом запуске запроса. Щелкните правой кнопкой мыши по заголовку столбца и выберите Формат › Переопределить форматирование… чтобы SQLly написал комментарий за вас, или введите его вручную, если предпочитаете.
Синтаксис
-- sqlly format: column=<name>; <rule>[; <option>...][; width=<n>dp]
-- sqlly format: column=<name>; width=<n>dp
-- sqlly format:: пробел после -- и двоеточие сразу после format. --sqlly format: не будет применяться, и редактор уведомит вас об этом.Первый сегмент всегда column=<name>. Второй — правило форматирования, width=, или оба:
| Правило | Эффект | Пример |
|---|---|---|
number=N | Фиксированная запятая с N десятичными знаками (учитывает thousands=, style=). Символы десятичного и тысячного разделителей, формат отрицательных чисел и выравнивание по-прежнему берутся из настроек, а столбец никогда не сокращается. | number=2 |
date=P | Отображает значение даты, даты со временем или похожий на дату текст по шаблону strftime P в часовом поясе отображения столбца. Значения, которые не распознаются как даты, и шаблоны с неизвестными токенами оставляют ячейку как есть. | date=%Y-%m-%d |
boolean=T/F | Текст для значений true / false. | boolean=Yes/No |
binary= | Отображать двоичные значения как hex или base64. | binary=hex |
text= | Регистр: upper, lower, title, none. | text=upper |
mask=P/S | Скрыть средние символы, оставив P первых и S последних символов. Применяется также к копиям и экспорту, когда Применять форматирование масок к копиям и экспорту включено. | mask=0/4 |
epoch= | Целое число эпохи → дата: auto, s, или ms. | epoch=s |
json=P | Извлекает из ячейки значение по JSON-пути. | json=$.customer.name |
template=T | Шаблонная ячейка с pipe-хелперами. | template={value|upper} |
Дополнительные параметры: thousands=true|false и style=fixed|percent|bytes уточняют number= правило. zone= устанавливает часовой пояс отображения для date= или epoch= правило (или для обычного отображения даты в столбце, когда оно — единственная настройка): UTC, local, stored (как его вернула база данных; UTC для эпох), или название часового пояса, например Europe/Berlin. Оно приоритетнее переопределения столбца, настройки подключения и глобальной настройки. Если SQLly не распознаёт имя зоны, вся строка игнорируется.
-- sqlly format: column=created_at; epoch=s; zone=America/New_York
Ширина столбца
width= задаёт ширину столбца. Это может быть единственная настройка на строке или стоять рядом с правилом:
-- sqlly format: column=Notes; width=60dp
-- sqlly format: column=Total; number=2; width=40dp
Единица измерения — dp, и она повторяет шрифт сетки: 1 dp — четверть размера шрифта сетки результатов. При шрифте сетки 10 pt, 20dp равно 50 пикселям; при шрифте 12 pt то же самое
20dp равно 60 пикселям. Поэтому при изменении размера шрифта или масштаба колонка растёт или сжимается вместе с текстом и показывает примерно одинаковое число символов — около 2,5 dp на символ. Это близкое приближение, а не точный подсчёт: у пропорционального шрифта буквы разной ширины. dp необязательный:
width=40 означает width=40dp.
Ширина в директиве имеет приоритет над шириной, которую вы перетаскивали и которую SQLly запомнил, а также над авторазмером: авторазмер оставляет этот столбец без изменений. Если вы перетащите столбец на новую ширину, директива восстановит его при следующем запуске; чтобы сохранить новую ширину, нажмите заблокировать
и SQLly перепишет width= для вас.
Несколько строк для одного столбца
Вы можете написать более одной format: строку для того же столбца, и они объединяются: позднее правило заменяет более раннее, поздняя ширина — более раннюю, так что эти две строки дают Total два знака после запятой и ширину 40 dp:
-- sqlly format: column=Total; number=2
-- sqlly format: column=Total; width=40dp
Примеры
-- sqlly format: column=Total; number=2
-- sqlly format: column=Qty; number=0; thousands=false
-- sqlly format: column=Created; date=%Y-%m-%d
-- sqlly format: column=IsActive; boolean=Yes/No
-- sqlly format: column=rate; number=1; style=percent
-- sqlly format: column=Card; mask=0/4
-- sqlly format: column=Notes; width=80dp
SELECT * FROM orders;


Каждое правило, кроме mask= изменяет только то, как сетка отображает данные: копирование и экспорт используют собственные значения базы данных. См. маскирование.
Условное форматирование
format: решает, как записано каждое значение в столбце. Чтобы окрашивать ячейки по
их значениям — красный текст для Failed, заливка для отрицательных балансов, цветовая шкала или полоска данных, используйте conditional: директива, одно правило на строку рядом с вашими format: строками. Полное руководство, включая диалоговое окно условного форматирования, находится в Результаты › Условное форматирование.
-- sqlly format: column=Balance; number=2; width=36dp
-- sqlly conditional: column=Balance; when=< 0; fill=#FDE7E9
SELECT Account, Balance FROM ledger;