日期

功能的

按你的方式读取日期:自选格式和时区,或把时间戳数字转换为真实日期。

当日期的格式和时区都清楚明了时,日期才更值得信赖。两者都可以在 设置 › 结果 › 日期.

选项选项默认
格式模式自由文本模式(yyyy, MM, dd, HH, mm, ss)yyyy-MM-dd HH:mm:ss
时区始终 UTC / 原生(按存储原样) / 始终本地 / 指定时区始终使用 UTC
时区 ID可搜索的 IANA 时区选择器,当选择“特定时区”时显示——在输入时验证时区,并显示其当前 UTC 偏移的实时预览UTC
对齐左 / 中 / 右左
将整数时间戳显示为日期关闭 / 按列名 / 按名称和值范围关闭

日期使用你选择的模式;没有“2 小时前”这种相对模式。要把整数纪元转换为日期,请使用 epoch= 格式覆盖.

SQLly
SQLly 日期格式配置面板SQLly 日期格式配置面板
设置中的日期/时间格式面板。

编写匹配模式

该模式识别六个标记: yyyy (四位年份), MM (月), dd (日), HH (24 小时制的小时), mm (分钟),以及 ss (秒)。其他所有字符——破折号、斜杠、点、空格、字面值 T - 按原样复制。对于一个值为 2026-03-14 09:05:07:

模式网格显示
yyyy-MM-dd HH:mm:ss2026-03-14 09:05:07
dd/MM/yyyy HH:mm14/03/2026 09:05
MM.dd.yyyy03.14.2026
yyyy-MM-ddTHH:mm:ss2026-03-14T09:05:07

月份名称、两位数年份和 12 小时制并不是格式符。小数秒永远不会被丢弃:当值本身带有小数秒而你的模式包含 ss,它们会被追加,所以 12:00:00.500 保持不变 12:00:00.500.

时区

取一个 timestamptz 值为 2026-01-01T12:00:00+00:00 使用默认模式:

时区设置网格显示
始终使用 UTC2026-01-01 12:00:00
特定时区: Europe/Berlin2026-01-01 13:00:00
特定时区: Asia/Tokyo2026-01-01 21:00:00
始终使用本地时间你电脑时区中的同一时刻
原生(按存储原样)与数据库发送内容完全一致的文本
  • 带偏移量的值 (timestamptz, datetimeoffset)会精确转换,时刻不变,只有时钟读数改变。
  • 不带偏移量的值 (datetime, datetime2, timestamp)在转换前会按 UTC 处理。如果你的数据库在这些列中存储的是本地时钟时间,请选择 始终使用 UTC 或者 原生(按存储原样) 这样它们就不会错位。
  • 原生(按存储原样) 也会跳过该模式:你看到的是引擎自己的文本,原封未动。
  • 未知的时区 ID 会在设置中被标记出来,网格会回退到 UTC。在浏览器预览中,“始终使用本地时间”显示的也是 UTC。

每列和每个连接各自的时区

上面的设置是默认值。还有两个地方可以选择时区,其中最具体的设置会生效:

  1. A zone= 选项 在查询的 格式指令.
  2. 列覆盖。 日期和纪元覆盖具有 设置 › 结果 › 列覆盖 可以选择时区:跟随全局设置(新覆盖项的默认值)、始终用 UTC、始终用本地时间、原生(按存储原样,仅日期),或从同一个可搜索列表中挑选具体时区。
  3. 连接。 在连接编辑器中, 显示时区 可以是使用应用设置(默认)、UTC、本地时间或任何命名时区。来自该连接的网格会在原本应用此页设置的地方使用它;当一台服务器保存本地时钟时间、另一台保存 UTC 时很方便。
  4. 此页面的时区设置。

保持不变的内容

  • 仅日期和仅时间的列 (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-%d2026-07-14
日期和时间date=%Y-%m-%d %H:%M:%S2026-07-14 07:30:15
日期、时间和偏移量date=%Y-%m-%d %H:%M:%S %:z2026-07-14 07:30:15 +00:00
手动输入date=%d/%m/%Y %H:%M14/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 之外的任何值(以秒或毫秒计)保留为普通数字。列覆盖或格式指令始终优先,复制、编辑和导出都保留原始数字。