格式化

進行中

每當查詢執行時,自動為每個欄位安排它該有的呈現方式與寬度。

格式化指令描述一個欄位該如何顯示——數字、日期、布林值、文字等等,而且每次查詢執行時都會套用。以滑鼠右鍵點擊欄位標題,然後選擇 格式 › 設定格式覆寫… 讓 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;
SQLly
套用至結果欄位的 SQLly 格式化指令套用至結果欄位的 SQLly 格式化指令
套用到欄位的格式化指令,網格中會顯示格式化後的值。

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