自然语言日期

功能的

在日期比较后输入 last wed at 3、november 或 ytd,SQLly 会写出准确的字面值或范围,并让它保持最新。

日期过滤是 SQL 不太容易处理的地方。月份的最后一天是 30 号还是 31 号? BETWEEN 会涵盖最后一天的下午吗?“上周三”到底是哪一天?SQLly 允许你像说话那样输入日期,并替你写出精确的字面值,采用该列自身的精度和引擎自己的拼写。

用日常语言输入日期

在日期列上开始比较,例如 WHERE OrderDate = 或者 AND created_at >=,然后按 Ctrl+Shift+Space。一行下方会打开一张卡片。它不列出建议,而是告诉你能输入什么。输入一个短语,卡片就会显示它的含义以及它将变成的 SQL。按 输入 (或者 标签页)来写入,或者 ESC 来取消。

SELECT *
FROM Sales.Orders AS o
WHERE o.OrderDate = last wed at 3

变为

WHERE o.OrderDate = '2026-10-21T15:00:00' --sqlly date:last wed at 3
SQLly
WHERE 比较下方的日期卡片:用通俗文字输入的短语、它的含义,以及它将变成的 SQL 字面量。WHERE 比较下方的日期卡片:用通俗文字输入的短语、它的含义,以及它将变成的 SQL 字面量。
WHERE 比较下方的日期卡片:用通俗文字输入的短语、它的含义,以及它将变成的 SQL 字面量。

你也可以先输入短语,然后再按 Ctrl+Shift+Space 之后再解析;卡片打开时它已被读取。在不是日期比较的其他地方,这个快捷方式仍会像以前一样查找列的真实值。

时期会变成范围

命名整个时期的短语,例如 今天, 十一月, 上周 或者 今年以来,会被转换成一个范围,让比较覆盖其全部。具体怎么转由运算符决定:

=
整个期间: OrderDate BETWEEN '2025-11-01' AND '2025-11-30'.
<>
它之外的一切: NOT BETWEEN.
> 和 <=
与该时间段的最后一个时刻相比,所以 > november 表示在 11 月之后。
>= 和 <
与该时间段的第一个时刻相比,所以 < november 表示在 11 月之前。

一个 BETWEEN 会写成该列所能存下的最后一个时刻,因此不会漏掉任何东西: '2025-11-30' 对于一个 date 列, '2025-11-30T23:59:59.997' 适用于 SQL Server datetime, '2025-11-30T23:59:59.9999999' 用于 datetime2,以及 PostgreSQL、MySQL、SQLite 和 Oracle 的匹配精度(Oracle 还会得到它的 DATE/TIMESTAMP 字面量关键字)。想要精确的半开区间?切换区间样式,然后 = november 变为 (OrderDate >= '2025-11-01' AND OrderDate < '2025-12-01').

你可以输入的内容

天数
now, today, yesterday, tomorrow, the day before yesterday, wed, last friday, next monday, monday last week
时间
at 3、3pm、15:30、noon、midnight、yesterday at noon、tomorrow morning、last night、end of day
期间
本周,上个月,下季度,今年,上周末,2025 年第三季度,十一月,2024 年 11 月,2024 年
至日期
ytd、mtd、qtd、wtd、year to date、this month so far、since march
滚动窗口
过去 7 天、过去 3 个月、过去 24 小时、最近几天、未来 2 周
偏移量
3 天前、一周前、2 周后、10 天后、圣诞节前 3 天
日期
nov 5, november 5th 2024, 5th of november, the 5th, 2024-11-05, 11/5/2024, nov 5 at 3:15pm
边界
本周第一天、上个月月底、下个月第一天、本月最后一个周五
范围
从周一到周五, 2024年1月至3月之间, 1月, 3月, 10月1日至10月15日
财政年度
this fiscal year, last fiscal year, fytd, fy2025
假期
圣诞节、元旦、感恩节、劳动节、阵亡将士纪念日、7 月 4 日、万圣节

如果卡片无法读取你输入的内容,它会提示并显示示例; 输入 等待直到短语被识别为日期。

让日期保持最新

这 --sqlly date: 注释会把你的原话留在字面值旁边。这对已保存的查询很重要:你为“昨天”写的查询,每次打开时都应该仍表示昨天。

SQLly
写下的日期字面值及其尾随的 --sqlly date: 注释,以及将它按今天重新求值的刷新按钮。写下的日期字面值及其尾随的 --sqlly date: 注释,以及将它按今天重新求值的刷新按钮。
写下的日期字面值及其尾随的 --sqlly date: 注释,以及将它按今天重新求值的刷新按钮。
  • 点击 ↻ 之后加一条注释,即可对照今天重新计算那一个日期。
  • 包含这些日期之一的语句会显示一个 ↻ 刷新日期 按钮在其第一行,这会在一次可撤销的编辑中重新评估所有日期。
  • 运行 刷新自然语言日期 从命令面板选择,即可更新查询里的每个日期。
  • 或者开启 每次运行查询时刷新日期 之后就不用再操心了。

因为一个 -- 注释会延伸到行尾,同一行中该短语后面的内容会移到下一行,并保持相同缩进。

设置

所有内容都位于 设置 › 编辑器 › IntelliSense › 日期和时间便捷功能:

读取用日常文字输入的日期
开启或关闭该功能。关闭, Ctrl+Shift+Space 总是查找列值。
将时间段转换为范围
关闭时,一个时间段表示它的第一个时刻(= november 变为 = '2025-11-01').
范围样式
BETWEEN start AND end (默认)或确切的 (>= start AND < next).
单独一天或一个月
是否 星期三 或者 十一月 表示最近的一个(默认)、下一个或本周/今年的。
每周起始日
星期日(默认)或星期一,适用于本周和上周。
没有上午/下午的时间
工作时间(默认: 在3点 是下午 3:00,1 到 7 表示下午)或 24 小时制。
至今类期间的结束时间
今天结束时(默认)或立即,适用于年初至今、过去 7 天这类范围。
财政年度开始于
你的财政年度从哪个月开始。财政年度以其结束的日历年命名。
保留我在 --sqlly date: comment 中输入的内容
关闭时,只写入字面量,之后无法刷新。
显示刷新按钮
每条注释后的 ↻ 以及语句上的“刷新日期”按钮。
每次运行查询时刷新日期
在查询运行之前重新评估每个标记的日期。默认关闭。
将名称类似日期的列视为日期
当数据模型不知道某列的类型(例如尚未连接时),诸如 OrderDate, created_at 或者 ModifiedOn 的名称会被视为日期。