• 项目

日期和时间函数 (Transact-SQL)

本主题的以下各节对所有 Transact-SQL 日期和时间数据类型及函数作了概述。有关日期和时间数据类型及函数共有的信息和示例，请参阅使用日期和时间数据。

  • 日期和时间数据类型

  • 日期和时间函数

  • 用来获取系统日期和时间值的函数

  • 用来获取日期和时间部分的函数

  • 用来获取日期和时间差的函数

  • 用来修改日期和时间值的函数

  • 用来设置或获取会话格式的函数

  • 用来验证日期和时间值的函数

  • 日期和时间相关主题

日期和时间数据类型

下表列出了 Transact-SQL 的日期和时间数据类型。 

数据类型

格式

范围

精确度

存储大小（以字节为单位）

用户定义的秒的小数精度

时区偏移量

time

hh:mm:ss[.nnnnnnn]

00:00:00.0000000 到 23:59:59.9999999

100 纳秒

3 到 5

有

无

date

YYYY-MM-DD

0001-01-01 到 9999-12-31

1 天

3

无

无

smalldatetime

YYYY-MM-DD hh:mm:ss

1900-01-01 到 2079-06-06

1 分钟

4

无

无

datetime

YYYY-MM-DD hh:mm:ss[.nnn]

1753-01-01 到 9999-12-31

0.00333 秒

8

无

无

datetime2

YYYY-MM-DD hh:mm:ss[.nnnnnnn]

0001-01-01 00:00:00.0000000 到 9999-12-31 23:59:59.9999999

100 纳秒

6 到 8

有

无

datetimeoffset

YYYY-MM-DD hh:mm:ss[.nnnnnnn] [+|-]hh:mm

0001-01-01 00:00:00.0000000 到 9999-12-31 23:59:59.9999999（以 UTC 时间表示）

100 纳秒

8 到 10

有

有
注意注意

Transact-SQL rowversion 数据类型不是日期或时间数据类型。timestamp 是 rowversion 的同义词，但不推荐使用。

日期和时间函数

以下各表列出了 Transact-SQL 的日期和时间函数。有关确定性的详细信息，请参阅确定性函数和不确定性函数。

用来获取系统日期和时间值的函数

所有系统日期和时间值均得自运行 SQL Server 实例的计算机的操作系统。

精度较高的系统日期和时间函数

SQL Server 2008 R2 使用 GetSystemTimeAsFileTime() Windows API 来获取日期和时间值。精确程度取决于运行 SQL Server 实例的计算机硬件和 Windows 版本。此 API 的精度固定为 100 纳秒。可通过使用 GetSystemTimeAdjustment() Windows API 来确定该精确度。

函数

语法

返回值

返回数据类型

确定性

SYSDATETIME

SYSDATETIME ()

返回包含计算机的日期和时间的 datetime2(7) 值，SQL Server 的实例正在该计算机上运行。时区偏移量未包含在内。

datetime2(7)

不具有确定性

SYSDATETIMEOFFSET

SYSDATETIMEOFFSET ( )

返回包含计算机的日期和时间的 datetimeoffset(7) 值，SQL Server 的实例正在该计算机上运行。时区偏移量包含在内。

datetimeoffset(7)

不具有确定性

SYSUTCDATETIME

SYSUTCDATETIME ( )

返回包含计算机的日期和时间的 datetime2(7) 值，SQL Server 的实例正在该计算机上运行。日期和时间作为 UTC 时间（通用协调时间）返回。

datetime2(7)

不具有确定性

精度较低的系统日期和时间函数

函数

语法

返回值

返回数据类型

确定性

CURRENT_TIMESTAMP

CURRENT_TIMESTAMP

返回包含计算机的日期和时间的 datetime2(7) 值，SQL Server 的实例正在该计算机上运行。时区偏移量未包含在内。

datetime

不具有确定性

GETDATE

GETDATE ( )

返回包含计算机的日期和时间的 datetime2(7) 值，SQL Server 的实例正在该计算机上运行。时区偏移量未包含在内。

datetime

不具有确定性

GETUTCDATE

GETUTCDATE ( )

返回包含计算机的日期和时间的 datetime2(7) 值，SQL Server 的实例正在该计算机上运行。日期和时间作为 UTC 时间（通用协调时间）返回。

datetime

不具有确定性

用来获取日期和时间部分的函数

函数

语法

返回值

返回数据类型

确定性

DATENAME

DATENAME ( datepart , date )

返回表示指定日期的指定 datepart 的字符串。

nvarchar

不具有确定性

DATEPART

DATEPART ( datepart , date )

返回表示指定 date 的指定 datepart 的整数。

int

不具有确定性

DAY

DAY ( date )

返回表示指定 date 的“日”部分的整数。

int

具有确定性

MONTH

MONTH ( date )

返回表示指定 date 的“月”部分的整数。

int

具有确定性

YEAR

YEAR ( date )

返回表示指定 date 的“年”部分的整数。

int

具有确定性

用来获取日期和时间差的函数

函数

语法

返回值

返回数据类型

确定性

DATEDIFF

DATEDIFF ( datepart , startdate , enddate )

返回两个指定日期之间所跨的日期或时间 datepart 边界的数目。

int

具有确定性

用来修改日期和时间值的函数

函数

语法

返回值

返回数据类型

确定性

DATEADD

DATEADD (datepart , number , date )

通过将一个时间间隔与指定 date 的指定 datepart 相加，返回一个新的 datetime 值。

date 参数的数据类型。

具有确定性

SWITCHOFFSET

SWITCHOFFSET (DATETIMEOFFSET , time_zone)

SWITCH OFFSET 更改 DATETIMEOFFSET 值的时区偏移量并保留 UTC 值。

datetimeoffset 具有 的小数精度的DATETIMEOFFSET

具有确定性

TODATETIMEOFFSET

TODATETIMEOFFSET (expression , time_zone)

TODATETIMEOFFSET 将 datetime2 值转换为 datetimeoffset 值。datetime2 值被解释为指定 time_zone 的本地时间。

具有 datetime 参数的小数精度的 datetimeoffset

具有确定性

用来设置或获取会话格式的函数

函数

语法

返回值

返回数据类型

确定性

@@DATEFIRST

@@DATEFIRST

返回对会话进行 SET DATEFIRST 操作所得结果的当前值。

tinyint

不具有确定性

SET DATEFIRST

SET DATEFIRST { number | @number_var }

将一周的第一天设置为从 1 到 7 的一个数字。

不适用

不适用

SET DATEFORMAT

SET DATEFORMAT { format | @format_var }

设置用于输入 datetime 或 smalldatetime 数据的日期各部分（月/日/年）的顺序。

不适用

不适用

@@LANGUAGE

@@LANGUAGE

返回当前使用的语言的名称。@@LANGUAGE 不是日期或时间函数。但是，语言设置会影响日期函数的输出。

不适用

不适用

SET LANGUAGE

SET LANGUAGE { [ N ] 'language' | @language_var }

设置会话和系统消息的语言环境。SET LANGUAGE 不是日期或时间函数。但是，语言设置会影响日期函数的输出。

不适用

不适用

sp_helplanguage

sp_helplanguage [ [ @language = ] 'language' ]

返回有关所有支持语言日期格式的信息。sp_helplanguage 不是日期或时间存储过程。但是，语言设置会影响日期函数的输出。

不适用

不适用

用来验证日期和时间值的函数

函数

语法

返回值

返回数据类型

确定性

ISDATE

ISDATE ( expression )

确定 datetime 或 smalldatetime 输入表达式是否为有效的日期或时间值。

int

只有与 CONVERT 函数一起使用，同时指定了 CONVERT 样式参数且样式不等于 0、100、9 或 109 时，ISDATE 才是确定的。

日期和时间相关主题

主题

说明

使用日期和时间数据

提供通用于日期和时间数据类型及函数的信息和示例。

CAST 和 CONVERT (Transact-SQL)

提供有关在日期和时间值与字符串文字及其他日期和时间格式之间进行相互转换的信息。

编写国际化 Transact-SQL 语句

提供使用 Transact-SQL 语句的数据库和数据库应用程序在不同语言之间的可移植性准则，或支持多种语言的数据库和数据库应用程序的可移植性准则。

ODBC 标量函数 (Transact-SQL)

提供有关可在 Transact-SQL 语句中使用的 ODBC 标量函数的信息。这包括 ODBC 日期和时间函数。

分布式查询的数据类型映射

提供有关以下方面的信息：日期和时间数据类型对具有不同版本的 SQL Server 或不同访问接口的服务器之间的分布式查询有何影响。