SQL Server DATEPART() 函数（千字长文）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
• 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在数据处理中，日期时间相关的操作是开发者常遇到的挑战。无论是统计订单的月份分布，还是计算用户的年龄，都需要精准提取日期的各个组成部分。SQL Server DATEPART() 函数正是为此设计的强大工具。它能够从日期、时间或日期时间类型的值中提取指定的部分（如年份、月份、星期几等），帮助开发者高效处理时间序列数据。本文将从基础语法到进阶用法，结合实际案例，深入解析这一函数的核心价值。

基础用法：快速入门

语法结构

DATEPART() 函数的基本语法如下：

DATEPART(datepart, date)  

其中，datepart是需要提取的日期部分（如年、月、日等），date是输入的日期值。

参数说明

参数详解：像剥洋葱一样拆解日期

日期部分的“洋葱模型”

想象日期是一个多层的洋葱，DATEPART()就像一把锋利的刀，能精准切开每一层。例如，日期 2023-10-05 14:30:00 可以分解为：

• 年份（year）：2023
• 月份（month）：10
• 日期（day）：5
• 小时（hour）：14

常见参数的使用场景

1. 提取年份：year 或 yy

-- 查询2023年的订单  
SELECT * FROM Orders  
WHERE DATEPART(yy, OrderDate) = 2023;  

2. 提取月份：month 或 mm

-- 统计每月的销售额  
SELECT  
    DATEPART(mm, OrderDate) AS Month,  
    SUM(Amount) AS Total_Sales  
FROM Orders  
GROUP BY DATEPART(mm, OrderDate);  

3. 提取星期几：weekday

-- 查找工作日（周一至周五）的订单  
SELECT * FROM Orders  
WHERE DATEPART(weekday, OrderDate) BETWEEN 2 AND 6;  

实战案例：解决真实场景中的问题

案例1：计算用户年龄

假设有一个用户表 Users，其中 BirthDate 字段存储用户的出生日期。要计算用户的当前年龄，可以结合 DATEPART() 和 GETDATE() 函数：

SELECT  
    Name,  
    DATEPART(yy, GETDATE()) - DATEPART(yy, BirthDate)  
        - CASE  
            WHEN DATEPART(mm, BirthDate) > DATEPART(mm, GETDATE()) THEN 1  
            WHEN DATEPART(mm, BirthDate) = DATEPART(mm, GETDATE())  
                AND DATEPART(dd, BirthDate) > DATEPART(dd, GETDATE()) THEN 1  
            ELSE 0  
          END AS Age  
FROM Users;  

解释：

• 先计算年份差，再通过月份和日期判断是否过了生日，避免直接年份相减导致的误差。

案例2：按季度统计销售额

假设需要将销售额按季度（Q1-Q4）分组：

SELECT  
    CASE  
        WHEN DATEPART(qq, OrderDate) = 1 THEN 'Q1'  
        WHEN DATEPART(qq, OrderDate) = 2 THEN 'Q2'  
        WHEN DATEPART(qq, OrderDate) = 3 THEN 'Q3'  
        ELSE 'Q4'  
    END AS Quarter,  
    SUM(Amount) AS Total_Sales  
FROM Orders  
GROUP BY DATEPART(qq, OrderDate);  

注意：qq 是季度的参数缩写，代表 quarter。

进阶技巧：与其它函数联动

结合 DATEADD() 实现时间偏移

-- 查询上个月的订单  
SELECT * FROM Orders  
WHERE OrderDate >= DATEADD(mm, -1, GETDATE())  
    AND DATEPART(mm, OrderDate) = DATEPART(mm, DATEADD(mm, -1, GETDATE()));  

处理跨年问题：week 参数的陷阱

-- 统计某年内的第40周订单  
SELECT * FROM Orders  
WHERE DATEPART(yy, OrderDate) = 2023  
    AND DATEPART(wk, OrderDate) = 40;  

警告：wk 的周计算规则可能因系统设置不同而变化，需提前验证。

常见问题解答

Q1：返回值的范围是多少？

• 年份（yy）：通常为4位数字，如2023。
• 月份（mm）：1-12。
• 日期（dd）：1-31（根据具体月份调整）。
• 星期几（weekday）：1（周日）到7（周六）。

Q2：能否直接使用缩写？

可以！例如 yy 等同于 year，mm 等同于 month。但建议使用完整参数名以提高代码可读性。

Q3：支持哪些日期格式？

支持所有日期、时间或日期时间类型的值，如 datetime, datetime2, date 等。

结论

SQL Server DATEPART() 函数是处理日期时间数据的利器，它通过直观的参数设计，让开发者能够像搭积木一样灵活提取日期的各个部分。无论是统计销售趋势、计算用户年龄，还是按周分析数据，它都能提供精准的解决方案。掌握这一函数后，开发者可以更高效地从时间维度洞察数据，为业务决策提供支持。

建议读者通过实际案例反复练习，结合 WHERE、GROUP BY 等子句，逐步探索其在复杂场景中的应用潜力。记住，时间的规律是数据的天然结构，善用 DATEPART()，你将解锁更多分析可能性！