日期
功能的按你的方式读取日期:自选格式和时区,或把时间戳数字转换为真实日期。
当日期的格式和时区都清楚明了时,日期才更值得信赖。两者都可以在 设置 › 结果 › 日期.
| 选项 | 选项 | 默认 |
|---|---|---|
| 格式模式 | 自由文本模式(yyyy, MM, dd, HH, mm, ss) | yyyy-MM-dd HH:mm:ss |
| 时区 | 始终 UTC / 原生(按存储原样) / 始终本地 / 指定时区 | 始终使用 UTC |
| 时区 ID | 可搜索的 IANA 时区选择器,当选择“特定时区”时显示——在输入时验证时区,并显示其当前 UTC 偏移的实时预览 | UTC |
| 对齐 | 左 / 中 / 右 | 左 |
| 将整数时间戳显示为日期 | 关闭 / 按列名 / 按名称和值范围 | 关闭 |
日期使用你选择的模式;没有“2 小时前”这种相对模式。要把整数纪元转换为日期,请使用 epoch= 格式覆盖.


编写匹配模式
该模式识别六个标记: yyyy (四位年份),
MM (月), dd (日), HH (24 小时制的小时),
mm (分钟),以及 ss (秒)。其他所有字符——破折号、斜杠、点、空格、字面值 T - 按原样复制。对于一个值为
2026-03-14 09:05:07:
| 模式 | 网格显示 |
|---|---|
yyyy-MM-dd HH:mm:ss | 2026-03-14 09:05:07 |
dd/MM/yyyy HH:mm | 14/03/2026 09:05 |
MM.dd.yyyy | 03.14.2026 |
yyyy-MM-ddTHH:mm:ss | 2026-03-14T09:05:07 |
月份名称、两位数年份和 12 小时制并不是格式符。小数秒永远不会被丢弃:当值本身带有小数秒而你的模式包含
ss,它们会被追加,所以 12:00:00.500 保持不变
12:00:00.500.
时区
取一个 timestamptz 值为 2026-01-01T12:00:00+00:00 使用默认模式:
| 时区设置 | 网格显示 |
|---|---|
| 始终使用 UTC | 2026-01-01 12:00:00 |
特定时区: Europe/Berlin | 2026-01-01 13:00:00 |
特定时区: Asia/Tokyo | 2026-01-01 21:00:00 |
| 始终使用本地时间 | 你电脑时区中的同一时刻 |
| 原生(按存储原样) | 与数据库发送内容完全一致的文本 |
- 带偏移量的值 (
timestamptz,datetimeoffset)会精确转换,时刻不变,只有时钟读数改变。 - 不带偏移量的值 (
datetime,datetime2,timestamp)在转换前会按 UTC 处理。如果你的数据库在这些列中存储的是本地时钟时间,请选择 始终使用 UTC 或者 原生(按存储原样) 这样它们就不会错位。 - 原生(按存储原样) 也会跳过该模式:你看到的是引擎自己的文本,原封未动。
- 未知的时区 ID 会在设置中被标记出来,网格会回退到 UTC。在浏览器预览中,“始终使用本地时间”显示的也是 UTC。
每列和每个连接各自的时区
上面的设置是默认值。还有两个地方可以选择时区,其中最具体的设置会生效:
- A
zone=选项 在查询的 格式指令. - 列覆盖。 日期和纪元覆盖具有 设置 › 结果 › 列覆盖 可以选择时区:跟随全局设置(新覆盖项的默认值)、始终用 UTC、始终用本地时间、原生(按存储原样,仅日期),或从同一个可搜索列表中挑选具体时区。
- 连接。 在连接编辑器中, 显示时区 可以是使用应用设置(默认)、UTC、本地时间或任何命名时区。来自该连接的网格会在原本应用此页设置的地方使用它;当一台服务器保存本地时钟时间、另一台保存 UTC 时很方便。
- 此页面的时区设置。
保持不变的内容
- 仅日期和仅时间的列 (
date,time)会按数据库发来的原样显示,绝不会因设置中的格式模式而偏移或重新排版,因为把一个纯日期跨时区移动,日期就会变。date=覆盖(见下)仍能为纯日期列重新套用模式。 - 文本列 恰好存储日期的文本保持为文本。格式遵循声明的列类型;
CAST在查询中将列转换为日期/时间类型,或者给该列一个date=覆盖,如果你希望它被当作日期时间。 - 空值 显示为斜体
NULL.
一次一列
右键点击日期或时间列的标题并选择 格式 › 设置格式覆盖… 来单独为该列设置模式。这个选择会作为 date= 指令,它使用 strftime 令牌,例如 %Y, %m,
%d, %H, %M, %S, %b
(月份缩写),以及 %:z (UTC 偏移)。对于
datetimeoffset 值为 2026-07-14T09:30:15+02:00 在默认的“始终使用 UTC”设置下:
| 选择 | 指令 | 网格显示 |
|---|---|---|
| 日期 (2026-07-14) | date=%Y-%m-%d | 2026-07-14 |
| 日期和时间 | date=%Y-%m-%d %H:%M:%S | 2026-07-14 07:30:15 |
| 日期、时间和偏移量 | date=%Y-%m-%d %H:%M:%S %:z | 2026-07-14 07:30:15 +00:00 |
| 手动输入 | date=%d/%m/%Y %H:%M | 14/07/2026 07:30 |
- 时区设置仍然适用。 指令决定模式;时刻值会按列的显示时区显示,如上所述。在 原生(按存储原样) 带偏移量的值会保留自己的偏移,因此“偏移”选项显示为
2026-07-14 09:30:15 +02:00. - 仅日期值 也会重新套用模式(
date=%d.%m.%Y变成2026-07-14变为14.07.2026),但从不跨时区移动。 - 出错了也无妨。 无法识别为日期的值,或含有 SQLly 不认识的记号的模式,都会让单元格保持数据库发来的原样。
- 仅显示。 复制和导出会保留数据库自身的值,而不是重新格式化后的文本。
-- sqlly format: column=OrderDate; date=%d %b %Y
SELECT OrderID, OrderDate FROM dbo.Orders;
Epoch 数字
以整数存储的 Unix 时间戳可以按列显示为日期。右击表头,选择 格式 › 设置格式覆盖…,并选择它在哪里打开——一个 Epoch 秒 → 日期/时间 或者 Epoch 毫秒 → 日期/时间,或者自己编写:
-- sqlly format: column=created_at; epoch=auto
SELECT id, created_at FROM events;
有了这一行, 1767268800 显示为 2026-01-01 12:00:00
(UTC)。 auto 会把 100,000,000,000 及以上的值视为毫秒,更小的值视为秒。落点超出 1-9999 年范围的值——通常说明单位弄错了——则保留为普通数字。想要不同的输出格式,可为该列添加 Epoch 覆盖,位置在 设置 › 结果 › 列覆盖,你可以在那里选择单位、日期时间模式和时区。
Epoch 列在显示时使用与日期相同的显示时区(见上文),而不总是 UTC。要跳过逐列设置,请设置 将整数时间戳显示为日期:
按列名 会把整型列中名称类似 created_at,
updated_ts, login_time, signup_epoch,或
timestamp 的整数列作为日期(像 response_time 或者
elapsed_time 这样的持续时间保持不变); 按名称和数值范围
也会把 2000-2100 之外的任何值(以秒或毫秒计)保留为普通数字。列覆盖或格式指令始终优先,复制、编辑和导出都保留原始数字。