Форматирование

в процессе

Задавайте каждому столбцу то оформление и ту ширину, которых он заслуживает, автоматически при каждом выполнении запроса.

Директивы форматирования задают, как должен выглядеть отдельный столбец — числа, даты, логические значения, текст и так далее, — и применяются при каждом запуске запроса. Щелкните правой кнопкой мыши по заголовку столбца и выберите Формат › Переопределить форматирование… чтобы 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;
SQLly
Директива форматирования SQLly, применённая к столбцу результатаДиректива форматирования SQLly, применённая к столбцу результата
Директива форматирования, применяемая к столбцу, с отображением отформатированных значений в сетке.

Каждое правило, кроме 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;