Formato
en cursoAsigna 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
-- 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.
| Regla | Efecto | Ejemplo |
|---|---|---|
number=N | Punto 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=P | Renderiza 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/F | Texto 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/S | Enmascarar 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=P | Extraer una ruta JSON de la celda. | json=$.customer.name |
template=T | Celda 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;


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;