Formato

en curso

Asigna a cada columna la presentación y el ancho que merece, automáticamente cada vez que se ejecute la consulta.

Las directivas de formato describen cómo debe verse una columna: números, fechas, booleanos, texto y más, y se aplican cada vez que se ejecuta la consulta. Haz clic derecho en un encabezado de columna y elige Formato › Definir anulación de formato… para que SQLly escriba el comentario por ti, o escribe uno a mano cuando lo prefieras.

Sintaxis

-- sqlly format: column=<name>; <rule>[; <option>...][; width=<n>dp]
-- sqlly format: column=<name>; width=<n>dp
La ortografía es estricta aquí. A diferencia de las demás directivas, el formato necesita el prefijo exacto -- sqlly format:: un espacio después -- y dos puntos inmediatamente después format. --sqlly format: no se aplicará, y el editor te avisará.

El primer segmento siempre es column=<name>. El segundo es la regla de formato, un width=, o ambos.

ReglaEfectoEjemplo
number=NPunto fijo con N decimales (respeta thousands=, style=). Los caracteres decimales y de miles, el formato de los números negativos y la alineación siguen tomándose de Ajustes, y la columna nunca se abrevia.number=2
date=PRenderiza un valor de fecha, fecha y hora, o texto con formato de fecha con el patrón strftime P, en la zona horaria de visualización de la columna. Los valores que no se leen como fechas, y los patrones con tokens desconocidos, dejan la celda tal cual.date=%Y-%m-%d
boolean=T/FTexto para valores verdadero / falso.boolean=Yes/No
binary=Renderizar valores binarios como hex o base64.binary=hex
text=Uso de mayúsculas: upper, lower, title, none.text=upper
mask=P/SEnmascarar la parte central, manteniendo P caracteres iniciales y S caracteres finales. Se aplica también a copias y exportaciones mientras Aplicar el formato de máscara a copias y exportaciones está activado.mask=0/4
epoch=Entero de época a fecha: auto, s, o ms.epoch=s
json=PExtraer una ruta JSON de la celda.json=$.customer.name
template=TCelda con plantilla y helpers de pipe.template={value|upper}

Opciones finales: thousands=true|false y style=fixed|percent|bytes refinar una number= regla. zone= establece la zona horaria de visualización para una date= o epoch= regla (o para la visualización normal de la fecha de la columna cuando es la única configuración): UTC, local, stored (tal como la envía la base de datos; UTC para valores epoch), o un nombre de zona horaria como Europe/Berlin. Tiene prioridad sobre la anulación de la columna, la conexión y el ajuste global. Un nombre de zona que SQLly no reconozca hace que se ignore la línea entera.

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

Ancho de columna

width= establece el ancho de la columna. Puede ser el único ajuste de la línea o ir junto a una regla:

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

La unidad es dp, y sigue la fuente de la cuadrícula: 1 dp es una cuarta parte del tamaño de la fuente de la cuadrícula de resultados. Con una fuente de cuadrícula de 10 pt, 20dp es 50 píxeles; con 12 pt, lo mismo 20dp es 60 píxeles. Así que cuando cambias el tamaño de la fuente o el zoom, la columna crece o se encoge con el texto y sigue mostrando más o menos los mismos caracteres, unos 2,5 dp por carácter. Es una aproximación, no un recuento exacto, porque las letras de una fuente proporcional no tienen todas el mismo ancho. El sufijo dp es opcional: width=40 significa width=40dp.

Un ancho definido en una directiva prevalece sobre el ancho que arrastraste y SQLly recordó, y sobre el tamaño automático: el tamaño automático deja esa columna tal cual. Si arrastras la columna a un nuevo ancho, la directiva lo restablece en la siguiente ejecución; para conservar el nuevo ancho, haz clic en el bloqueo y SQLly reescribe el width= por ti.

Varias líneas para una columna

Puedes escribir más de una format: línea para la misma columna, y se combinan. Una regla posterior reemplaza a una regla anterior, y un ancho posterior reemplaza a un ancho anterior, así que estas dos líneas dan Total dos decimales y un ancho de 40 dp:

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

Ejemplos

-- 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
Una directiva de formato de SQLly aplicada a una columna de resultadoUna directiva de formato de SQLly aplicada a una columna de resultado
Una directiva de formato aplicada a una columna, con los valores formateados mostrados en la cuadrícula.

Cada regla excepto mask= cambia solo lo que dibuja la cuadrícula: copiar y exportar llevan los valores reales de la base de datos. Ver enmascaramiento.

Formato condicional

format: decide cómo se escribe cada valor en una columna. Para colorear las celdas por sus valores - texto rojo para Failed, un relleno para saldos negativos, una escala de colores o una barra de datos, usa el conditional: directiva, una regla por línea junto a tus format: líneas. La guía completa, incluido el cuadro de diálogo de Formato condicional, está Resultados › Formato condicional.

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