Formatação

em andamento

Dê a cada coluna a apresentação e a largura que merece, automaticamente sempre que a consulta for executada.

As diretivas de formatação descrevem como uma coluna deve ser exibida - números, datas, booleanos, texto e mais, e se aplicam toda vez que a consulta é executada. Clique com o botão direito no cabeçalho de uma coluna e escolha Formatar › Definir substituição de formatação… para que o SQLly escreva o comentário para você, ou digite manualmente quando preferir.

Sintaxe

-- sqlly format: column=<name>; <rule>[; <option>...][; width=<n>dp]
-- sqlly format: column=<name>; width=<n>dp
A ortografia é rigorosa aqui. Diferentemente das outras diretivas, a formatação precisa do prefixo exato -- sqlly format:: um espaço depois -- e dois-pontos imediatamente depois format. --sqlly format: não se aplicarão, e o editor irá avisá-lo.

O primeiro segmento é sempre column=<name>. O segundo é a regra de formatação, um width=, ou ambos:

RegraEfeitoExemplo
number=NPonto fixo com N casas decimais (respeita thousands=, style=). Os caracteres decimal e de milhares, formato de negativo e alinhamento ainda vêm das Configurações, e a coluna nunca é abreviada.number=2
date=PRenderiza um valor de data, datetime ou texto semelhante a data com o padrão strftime P, no fuso horário de exibição da coluna. Valores que não podem ser lidos como datas, e padrões com tokens desconhecidos, deixam a célula como enviada.date=%Y-%m-%d
boolean=T/FTexto para valores verdadeiro / falso.boolean=Yes/No
binary=Renderiza valores binários como hex ou base64.binary=hex
text=Capitalização: upper, lower, title, none.text=upper
mask=P/SMascarar o meio, mantendo P caracteres iniciais e S caracteres finais. Aplica-se também a cópias e exportações enquanto Aplicar formatação de máscara em cópias e exportações está ativado.mask=0/4
epoch=Inteiro de época para data: auto, s, ou ms.epoch=s
json=PExtraia um caminho JSON da célula.json=$.customer.name
template=TCélula com modelos usando auxiliares pipe.template={value|upper}

Opções adicionais: thousands=true|false e style=fixed|percent|bytes refinar uma number= regra. zone= define o fuso horário de exibição para uma date= ou epoch= regra (ou para a exibição de data comum da coluna quando for a única configuração): UTC, local, stored (como o banco de dados enviou; UTC para épocas), ou um nome de fuso horário como Europe/Berlin. Ele prevalece sobre a substituição da coluna, a conexão e a configuração global. Um nome de fuso que o SQLly não reconhece faz a linha inteira ser ignorada.

-- sqlly format: column=created_at; epoch=s; zone=America/New_York

Largura da coluna

width= define a largura da coluna. Pode ser a única configuração na linha ou ficar ao lado de uma regra:

-- sqlly format: column=Notes; width=60dp
-- sqlly format: column=Total; number=2; width=40dp

A unidade é dp, e segue a fonte da grade: 1 dp é um quarto do tamanho da fonte da grade de resultados. Com uma fonte de grade de 10 pt, 20dp é 50 pixels; com 12 pt, o mesmo 20dp é 60 pixels. Então, quando você muda o tamanho da fonte ou o zoom, a coluna cresce ou encolhe junto com o texto e continua mostrando aproximadamente os mesmos caracteres - cerca de 2,5 dp por caractere. É uma boa aproximação, não uma contagem exata, porque as letras de uma fonte proporcional não têm todas a mesma largura. O dp sufixo é opcional: width=40 significa width=40dp.

Uma largura em uma diretiva prevalece sobre uma largura que você arrastou e que o SQLly lembrou, e sobre o ajuste automático: ajuste automático deixa aquela coluna sozinha. Se você arrastar a coluna para uma nova largura, a diretiva a coloca de volta na próxima execução; para manter a nova largura, clique no bloquear e o SQLly reescreve o width= para você.

Várias linhas para uma coluna

Você pode escrever mais de uma format: linha para a mesma coluna, e elas se mesclam. Uma regra posterior substitui uma regra anterior, e uma largura posterior substitui uma largura anterior, então essas duas linhas dão Total dois decimais e uma largura de 40 dp:

-- sqlly format: column=Total; number=2
-- sqlly format: column=Total; width=40dp

Exemplos

-- 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
Uma diretiva de formatação do SQLly aplicada a uma coluna de resultadoUma diretiva de formatação do SQLly aplicada a uma coluna de resultado
Uma diretiva de formatação aplicada a uma coluna, com os valores formatados exibidos na grade.

Todas as regras, exceto mask= alteram apenas o que a grade exibe: copiar e exportar levam os valores originais do banco de dados. Veja mascaração.

Formatação condicional

format: determina como cada valor de uma coluna é escrito. Para colorir células por seus valores - texto vermelho para Failed, um preenchimento para saldos negativos, uma escala de cores ou uma barra de dados, use o conditional: diretiva, uma regra por linha ao lado de suas format: linhas. O guia completo, incluindo a caixa de diálogo de Formatação Condicional, está Resultados › Formatação condicional.

-- sqlly format: column=Balance; number=2; width=36dp
-- sqlly conditional: column=Balance; when=< 0; fill=#FDE7E9
SELECT Account, Balance FROM ledger;