Formatierung
in ArbeitGib jeder Spalte die Darstellung und Breite, die sie verdient, automatisch jedes Mal, wenn die Abfrage läuft.
Formatierungsdirektiven beschreiben, wie eine einzelne Spalte aussehen soll - Zahlen, Datumsangaben, Boolesche Werte, Text und mehr, und sie gelten bei jeder Ausführung der Abfrage. Klicke mit der rechten Maustaste auf einen Spaltenkopf und wähle Format › Formatierungsüberschreibung festlegen… um SQLly den Kommentar für dich schreiben zu lassen, oder tipp selbst einen ein, wenn du das lieber magst.
Syntax
-- sqlly format: column=<name>; <rule>[; <option>...][; width=<n>dp]
-- sqlly format: column=<name>; width=<n>dp
-- sqlly format:: ein Leerzeichen danach -- und ein Doppelpunkt unmittelbar danach format. --sqlly format: werden nicht angewendet, und der Editor weist dich darauf hin.Das erste Segment ist immer column=<name>. Das zweite ist die Formatregel, ein width=, oder beides:
| Regel | Effekt | Beispiel |
|---|---|---|
number=N | Festkommazahl mit N Dezimalstellen (beachtet thousands=, style=). Dezimal- und Tausendertrennzeichen, das Format für negative Zahlen und die Ausrichtung kommen weiterhin aus den Einstellungen, und die Spalte wird nie abgekürzt. | number=2 |
date=P | Gibt einen Datums-, Datumszeit- oder datumsähnlichen Textwert mit dem strftime-Muster P in der Anzeigezeitzone der Spalte wieder. Werte, die nicht als Datum gelesen werden können, und Muster mit unbekannten Tokens lassen die Zelle unverändert. | date=%Y-%m-%d |
boolean=T/F | Text für Wahr / Falsch-Werte. | boolean=Yes/No |
binary= | Gibt Binärwerte wieder als hex oder base64. | binary=hex |
text= | Groß-/Kleinschreibung: upper, lower, title, none. | text=upper |
mask=P/S | Maskiere die Mitte, wobei die ersten P und die letzten S Zeichen erhalten bleiben. Gilt auch für Kopien und Exporte, während Maskierungsformatierungen auf Kopien und Exporte anwenden aktiviert ist. | mask=0/4 |
epoch= | Epoch-Integer zu Datum: auto, s, oder ms. | epoch=s |
json=P | Extrahiere einen JSON-Pfad aus der Zelle. | json=$.customer.name |
template=T | Zelle mit Vorlage und Pipe-Helfern. | template={value|upper} |
Weitere Optionen: thousands=true|false und style=fixed|percent|bytes verfeinere eine number= Regel. zone= setzt die Anzeigezeitzone für eine date= oder epoch= Regel (oder für die normale Datumsanzeige der Spalte, wenn sie die einzige Einstellung ist): UTC, local, stored (wie sie von der Datenbank gesendet wurde; UTC für Epochen), oder einen Zeitzonennamen wie Europe/Berlin. Es hat Vorrang vor der Spaltenüberschreibung, der Verbindung und der globalen Einstellung. Ein Zonenname, den SQLly nicht erkennt, sorgt dafür, dass die gesamte Zeile ignoriert wird.
-- sqlly format: column=created_at; epoch=s; zone=America/New_York
Spaltenbreite
width= legt fest, wie breit die Spalte ist. Es kann die einzige Einstellung in der Zeile sein oder neben einer Regel stehen:
-- sqlly format: column=Notes; width=60dp
-- sqlly format: column=Total; number=2; width=40dp
Die Einheit ist dp, und sie folgt der Schrift des Rasters: 1 dp entspricht einem Viertel der Schriftgröße des Ergebnisrasters. Bei einer Rasterschriftgröße von 10 pt 20dp ist es 50 Pixel; bei 12 pt ist dasselbe
20dp 60 Pixel. Wenn du also die Schriftgröße oder die Zoomstufe änderst, wächst oder schrumpft die Spalte mit dem Text mit und zeigt ungefähr dieselbe Zeichenanzahl - rund 2,5 dp pro Zeichen. Das ist eine gute Näherung statt einer exakten Zählung, denn die Buchstaben einer Proportionalschrift sind nicht alle gleich breit. Das dp Suffix ist optional:
width=40 bedeutet width=40dp.
Eine Breite in einer Direktive hat Vorrang vor einer Breite, die du gezogen hast und die SQLly sich gemerkt hat, und vor Auto-Größe: Auto-Größe lässt diese Spalte in Ruhe. Wenn du die Spalte auf eine neue Breite ziehst, setzt die Direktive sie beim nächsten Durchlauf zurück; um die neue Breite zu behalten, klicke auf den sperren
und SQLly schreibt den width= für dich.
Mehrere Zeilen für eine Spalte
Du kannst mehr als eine format: Zeile für dieselbe Spalte schreiben, und sie werden zusammengeführt. Eine spätere Regel ersetzt eine frühere Regel, und eine spätere Breite ersetzt eine frühere Breite, sodass diese beiden Zeilen Total zwei Dezimalstellen und eine Breite von 40 dp:
-- sqlly format: column=Total; number=2
-- sqlly format: column=Total; width=40dp
Beispiele
-- 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;


Jede Regel außer mask= ändert nur die Anzeige im Raster: Kopieren und Export nutzen die Werte der Datenbank. Siehe Maskierung.
Bedingte Formatierung
format: entscheidet, wie jeder Wert in einer Spalte geschrieben wird. Um Zellen nach
ihren Werte zu färben - roter Text für Failed, eine Füllung für negative Salden, eine Farbskala oder einen Datenbalken, verwende das conditional: Direktive, eine Regel pro Zeile neben deinen format: Zeilen. Der vollständige Leitfaden, einschließlich des Dialogs für die bedingte Formatierung, ist Ergebnisse › Bedingte Formatierung.
-- sqlly format: column=Balance; number=2; width=36dp
-- sqlly conditional: column=Balance; when=< 0; fill=#FDE7E9
SELECT Account, Balance FROM ledger;