格式化
進行中每當查詢執行時,自動為每個欄位安排它該有的呈現方式與寬度。
格式化指令描述一個欄位該如何顯示——數字、日期、布林值、文字等等,而且每次查詢執行時都會套用。以滑鼠右鍵點擊欄位標題,然後選擇 格式 › 設定格式覆寫… 讓 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 | 表示真 / 假值的文字。 | 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 | 帶有管道輔助功能的範本儲存格。 | template={value|upper} |
尾端選項: thousands=true|false 和 style=fixed|percent|bytes 可用來微調 number= 規則。 zone= 會設定顯示時區,作用於 date= 或 epoch= 規則(或在僅有此設定時,用於該欄位的一般日期顯示): UTC, local, stored (以資料庫送來的原樣;epoch 用 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 記住的寬度,也優先於自動調整大小:自動調整不會更動該欄位。如果你把欄位拖曳成新寬度,指令會在下一次執行時改回來;想保留新寬度,請按一下 lock
而 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;


除了 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;