DATEPART (Transact-SQL)
适用于：
SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)
此函数返回表示指定 date 的指定 datepart 的整数 。
有关所有 Transact-SQL 日期和时间数据类型及函数的概述，请参阅日期和时间数据类型及函数 (Transact-SQL)。
语法
DATEPART ( datepart , date )
参数
datepart
DATEPART 将返回表示 date 参数的特定部分的整数 。 此表列出了所有有效的 datepart 参数 。
注意
对于 datepart 参数，DATEPART 不接受用户定义的变量等效项 。
| datepart | 缩写形式 |
|---|---|
| year | yy, yyyy |
| quarter | qq, q |
| month | mm, m |
| dayofyear | dy, y |
| day | dd, d |
| week | wk, ww |
| weekday | dw |
| hour | hh |
| minute | mi, n |
| second | ss, s |
| millisecond | ms |
| microsecond | mcs |
| nanosecond | ns |
| tzoffset | tz |
| iso_week | isowk, isoww |
date
解析为下列某种数据类型的表达式：
- date
- datetime
- datetimeoffset
- datetime2
- smalldatetime
- time
对于 date，DATEPART 接受列表达式、表达式、字符串文本或用户定义的变量 。 使用四位数年份可避免含糊不清问题。 有关两位数年份的信息，请参阅配置两位数年份截止服务器配置选项。
返回类型
int
返回值
每个 datepart 及其缩写都返回相同的值 。
返回值取决于 SET LANGUAGE 和登录时选择的配置默认语言服务器配置选项设定的语言环境。 如果 date 是某些格式的字符串文本，则返回值取决于 SET DATEFORMAT 。 当 date 为日期或时间数据类型的列表达式时，SET DATEFORMAT 不更改返回值。
此表列出了所有 datepart 参数以及 SELECT DATEPART(datepart,'2007-10-30 12:15:32.1234567 +05:10') 语句相应的返回值 。 date 参数具有 datetimeoffset(7) 数据类型 。 nanosecond datepart 返回值的最后两位始终为 00，并且此值的小数位数为 9 位：
.123456700
| datepart | 返回值 |
|---|---|
| year, yyyy, yy | 2007 |
| quarter, qq, q | 4 |
| month, mm, m | 10 |
| dayofyear, dy, y | 303 |
| day, dd, d | 30 |
| week, wk, ww | 44 |
| weekday, dw | 3 |
| hour, hh | 12 |
| minute, n | 15 |
| second, ss, s | 32 |
| millisecond, ms | 123 |
| microsecond, mcs | 123456 |
| nanosecond, ns | 123456700 |
| tzoffset, tz | 310 |
| iso_week, isowk, isoww | 44 |
周和工作日日期部分参数
对于 week (wk, ww) 或 weekday (dw) datepart，DATEPART 返回值取决于 SET DATEFIRST 设置的值 。
任何年份的 1 月 1 日都用来定义 week datepart 的起始数字。 例如：
DATEPART (wk, 'Jan 1, xxxx') = 1
其中，xxxx 为任何年份 。
下表列出了每个 SET DATEFIRST 参数的“2007-04-21”的 week 和 weekday datepart 返回值。 2007 年 1 月 1 日为星期一。 2007 年 4 月 21 日为星期六。 对于美式英语，
SET DATEFIRST 7 -- ( Sunday )
用作默认值。 设置 DATEFIRST 后，请将此建议的 SQL 语句用于 datepart 表值：
SELECT DATEPART(week, '2007-04-21 '), DATEPART(weekday, '2007-04-21 ')
| SET DATEFIRST 参数 |
week 返回 |
weekday 返回 |
|---|---|---|
| 1 | 16 | 6 |
| 2 | 17 | 5 |
| 3 | 17 | 4 |
| 4 | 17 | 3 |
| 5 | 17 | 2 |
| 6 | 17 | 1 |
| 7 | 16 | 7 |
年、月和日日期部分参数
DATEPART (year, date)、DATEPART (month, date) 和 DATEPART (day, date) 的返回值分别与函数 YEAR、MONTH 和 DAY 的返回值相同 。
iso_week datepart
ISO 8601 包括 ISO 周-日期系统，即周的编号系统。 每周都与该周内星期四所在的年份关联。 例如，2004 年的第一周 (2004W01) 包括 2003 年 12 月 29 日（星期一）到 2004 年 1 月 4 日（星期日）。 欧洲国家/地区通常使用此编号样式。 非欧洲国家/地区则通常不使用。
注意：一年中的最多周数可能是 52 或 53。
不同的国家/地区的编号系统可能不符合 ISO 标准。 此表显示六种可能情况：
| 每周的第一天 | 一年的第一周包含 | 分配两次的周 | 使用的国家/地区 |
|---|---|---|---|
| 星期日 | 1 月 1 日， 第一个星期六， 其中有 1–7 天属于此年 |
是 | United States |
| 星期一 | 1 月 1 日， 第一个星期日， 其中有 1–7 天属于此年 |
是 | 大多数欧洲国家地区和英国 |
| 星期一 | 1 月 4 日 第一个星期四， 其中有 4–7 天属于此年 |
否 | ISO 8601，挪威和瑞典 |
| 星期一 | 1 月 7 日 第一个星期一， 每年的某七天 |
否 | |
| 星期三 | 1 月 1 日， 第一个星期二， 其中有 1–7 天属于此年 |
是 | |
| 星期六 | 1 月 1 日， 第一个星期五， 其中有 1–7 天属于此年 |
是 |
tzoffset
DATEPART 返回以分钟数表示的 tzoffset (tz) 值（带有签名） 。 此语句返回了 310 分钟的时区偏移量：
SELECT DATEPART (tzoffset, '2007-05-10 00:00:01.1234567 +05:10');
DATEPART 呈现的 tzoffset 值如下所示：
- 对于 datetimeoffset 和 datetime2，tzoffset 返回的时间偏移量以分钟为单位，其中 datetime2 的偏移量始终为 0 分钟。
- 对于可隐式转换为 datetimeoffset 或 datetime2 的数据类型，
DATEPART返回以分钟数表示的时间偏移量 。 异常：其他 date/time 数据类型。 - 所有其他类型的参数都会导致错误。
smalldatetime 日期参数
对于 smalldatetime date 值，DATEPART 返回的秒数为 00。
对不在 date 参数中的 datepart 返回默认值
如果 date 参数数据类型不具有特定的 datepart，则仅当为 date 指定文本时，DATEPART 才返回该 datepart 的默认值。
例如，任意 date 数据类型的默认年-月-日都为 1900-01-01 。 此语句具有 datepart 的日期部分参数、date 的时间参数，并且返回 1900, 1, 1, 1, 2 。
SELECT DATEPART(year, '12:10:30.123')
,DATEPART(month, '12:10:30.123')
,DATEPART(day, '12:10:30.123')
,DATEPART(dayofyear, '12:10:30.123')
,DATEPART(weekday, '12:10:30.123');
如果将 date 指定为变量或表列，并且该变量或列的数据类型没有指定的 datepart，DATEPART 将返回错误 9810。 在此示例中，变量 @t 具有 time 数据类型。 示例失败，因为日期部分年份对于 time 数据类型无效 ：
DECLARE @t time = '12:10:30.123';
SELECT DATEPART(year, @t);
秒的小数形式
这些语句显示 DATEPART 返回了秒的小数形式：
SELECT DATEPART(millisecond, '00:00:01.1234567'); -- Returns 123
SELECT DATEPART(microsecond, '00:00:01.1234567'); -- Returns 123456
SELECT DATEPART(nanosecond, '00:00:01.1234567'); -- Returns 123456700
备注
DATEPART 可用在 select list、WHERE、HAVING、GROUP BY 和 ORDER BY 子句中。
在 SQL Server 2008 (10.0.x) 及更高版本中，DATEPART 将字符串文字隐式强制转换为 datetime2 类型。 这就意味着，日期在作为字符串传递时，DATENAME 不会支持 YDM 格式。 必须先将字符串显式转换为 datetime 或 smalldatetime 类型，然后才能使用 YDM 格式 。
示例
此示例返回基准年。 基准年有助于进行日期计算。 该示例用数字指定日期。 请注意，SQL Server 将 0 解释为 1900 年 1 月 1 日。
SELECT DATEPART(year, 0), DATEPART(month, 0), DATEPART(day, 0);
-- Returns: 1900 1 1
此示例返回日期 12/20/1974 的日期部分。
-- Uses AdventureWorks
SELECT TOP(1) DATEPART (day,'12/20/1974') FROM dbo.DimCustomer;
-- Returns: 20
此示例返回日期 12/20/1974 的年份部分。
-- Uses AdventureWorks
SELECT TOP(1) DATEPART (year,'12/20/1974') FROM dbo.DimCustomer;
-- Returns: 1974