EOMONTH返回指定日期所在月份最后一天,支持偏移月数,返回date类型,NULL输入返回NULL,SQL Server 2012+可用,旧版本需用DATEADD替代。

SQL Server中EOMONTH函数的基本用法
EOMONTH 是 SQL Server 2012 及以上版本提供的内置日期函数,用于返回指定日期所在月份的最后一天。它不依赖于当前系统日期,而是以输入日期为基准计算,因此比拼接 DATEFROMPARTS 或字符串格式化更可靠。
最常见用法是传入一个日期表达式(如 GETDATE()),不带偏移量时默认返回当月最后一天:
SELECT EOMONTH(GETDATE()); -- 返回类似 '2024-06-30'
注意:返回值类型始终是 date(不含时间部分),即使输入是 datetime 或 datetime2,也会被截断为纯日期。
如何用EOMONTH获取其他月份的月末日期
第二个可选参数 month_to_add 控制偏移月数,正数向后、负数向前。这个参数必须是整数,不能是变量或表达式(除非在 SQL Server 2016+ 的某些执行上下文中,但稳妥起见仍建议用常量或参数化变量)。
-
EOMONTH(GETDATE(), 0)→ 当月最后一天(等价于不写第二参数) -
EOMONTH('2024-01-15', 1)→ 2024年2月最后一天('2024-02-29') -
EOMONTH('2024-03-10', -1)→ 2024年2月最后一天('2024-02-29')
跨年也自动处理,比如 EOMONTH('2023-12-01', 1) 返回 '2024-01-31',无需手动判断年份进位。
常见错误:NULL输入、无效日期、版本不兼容
如果第一个参数为 NULL,EOMONTH 直接返回 NULL,不会报错——这点容易被忽略,导致后续逻辑出错却难以定位。
输入非法日期(如 '2024-02-30')会触发运行时错误:Msg 241, Level 16, State 1, Line X Conversion failed when converting date and/or time from character string.
最关键的是版本限制:SQL Server 2008 R2 及更早版本不支持 EOMONTH。若遇到 Invalid column name 'EOMONTH' 或解析失败,先查版本:SELECT @@VERSION;。替代方案只能用 DATEADD + DAY 组合,例如:
SELECT DATEADD(DAY, -DAY(GETDATE()), DATEADD(MONTH, 1, GETDATE()));
和WHERE条件配合时的性能与写法陷阱
在查询中用 EOMONTH 过滤当月数据很常见,但要注意写法是否可利用索引。下面这种写法是安全的(假设 OrderDate 列有索引):
WHERE OrderDate >= DATEFROMPARTS(YEAR(GETDATE()), MONTH(GETDATE()), 1) AND OrderDate <p>而这样写会导致全表扫描:</p><pre class="brush:php;toolbar:false;">WHERE EOMONTH(OrderDate) = EOMONTH(GETDATE()) -- 函数作用于列,无法走索引
另外,避免在循环或大结果集里反复调用 EOMONTH(GETDATE())。应提前算好并存入变量,减少重复计算:
DECLARE @MonthEnd DATE = EOMONTH(GETDATE()); SELECT * FROM Sales WHERE SaleDate <p>闰年二月、大小月边界、时区无关性这些细节都由函数内部处理,你只需确认输入是合法日期且版本够新——其余交给 SQL Server 就行。</p>










