DATEPART (Transact-SQL)

返回表示指定日期的指定日期部分的整数。

Transact-SQL 语法约定

语法

DATEPART ( datepart , date )

参数

• datepart
  指定要返回的日期部分的参数。下表列出了 Microsoft SQL Server 2005 可识别的日期部分及其缩写。

  日期部分	缩写
  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

  week (wk, ww) 日期部分反映对 SET DATEFIRST 所做的更改。任意一年的 1 月 1 日均定义 week 日期部分的开头数字，例如：DATEPART(wk,'Jan 1, xxxx') = 1，其中，xxxx 是任意一年。

  weekday (dw) 日期部分返回与一周的某一天对应的数字，例如：Sunday = 1, Saturday = 7。weekday 日期部分生成的数字取决于 SET DATEFIRST 所设置的值。这设置一周中的第一天。

• date
  表达式，用于返回 datetime 或 smalldatetime 值，或日期格式的字符串。仅对 1753 年 1 月 1 日之后的日期使用 datetime 数据类型。将之前的日期存储为字符数据。当输入 datetime 值时，应始终将其放入引号中。由于 smalldatetime 只精确到分钟，所以在使用 smalldatetime 值时，秒和毫秒始终为 0。

  如果只指定年份的后两位数字，则小于或等于 two-digit year cutoff 配置选项值的后两位数字的值将与截止年份处于同一世纪中。比此选项值的后两位数字大的值先于截止年份的世纪。例如，如果 two-digit year cutoff 是 2049（默认值），则 49 将被解释为 2049，而 50 则将被解释为 1950。为了避免产生歧义，请使用四位年份。

  有关指定时间值的详细信息，请参阅时间格式。有关指定日期的详细信息，请参阅 日期和时间 (Transact-SQL)。

返回类型

int

备注

DAY、MONTH、和 YEAR 函数分别是 DATEPART(**dd,**date)、DATEPART(mm,date) 和 DATEPART(yy, date) 的同义词。

示例

GETDATE 函数返回当前日期。但是，进行比较时并不总是需要提供完整日期；通常，只对日期的一部分进行比较。以下示例显示 GETDATE 和 DATEPART 的输出。

SELECT GETDATE() AS 'Current Date'
GO

下面是结果集：

Current Date                
--------------------------- 
Feb 18 1998 11:46PM         

SELECT DATEPART(month, GETDATE()) AS 'Month Number'
GO

下面是结果集：

Month Number 
------------ 
2            

以下示例假设日期为 5 月 29 日。

SELECT DATEPART(month, GETDATE())
GO

下面是结果集：

----------- 
5           
(1 row(s) affected)

在下面的示例中，日期被指定为数字。请注意，SQL Server 将 0 解释为 1900 年 1 月 1 日。

SELECT DATEPART(m, 0), DATEPART(d, 0), DATEPART(yy, 0)

下面是结果集：

----- ------ ------
1     1      1900

请参阅

参考

CAST 和 CONVERT (Transact-SQL)
数据类型 (Transact-SQL)
日期和时间函数 (Transact-SQL)

其他资源

ISO 8601 格式
字母日期格式
数值日期格式
ODBC 日期时间格式
时间格式
未分隔字符串格式

帮助和信息

获取 SQL Server 2005 帮助