格式化
进行中让每一列都得到它应得的展示形式和宽度,每次查询运行时自动完成。
格式化指令描述某一列的显示方式——数字、日期、布尔值、文本等,并且每次查询运行时都会应用。右键点击列标题并选择 格式 › 设置格式覆盖… 来创建一个
语法
-- 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 | 表示 true / false 值的文本。 | boolean=Yes/No |
binary= | 将二进制值渲染为 hex 或者 base64. | binary=hex |
text= | 大小写: upper, lower, title, none. | text=upper |
mask=P/S | 遮住中间部分,保留开头 P 个和结尾 S 个字符。复制和导出时同样如此,前提是 在复制和导出时应用掩码格式 处于开启状态。 | mask=0/4 |
epoch= | 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 (按数据库发来的原样;Unix 时间戳用 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 记住的宽度,也优先于自动列宽:自动列宽不会改动这一列。如果你把列拖到新的宽度,指令会在下次运行时把它改回去;要保留新宽度,请点击 锁
并且 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;