日期和时间数据类型及函数 (Transact-SQL)
本主题的以下各节对所有 Transact-SQL 日期和时间数据类型及函数作了概述。
日期和时间数据类型
日期和时间函数
用来获取系统日期和时间值的函数
用来获取日期和时间部分的函数
用来从部件中获取日期和时间值的函数
用来获取日期和时间差的函数
用来修改日期和时间值的函数
用来设置或获取会话格式的函数
用来验证日期和时间值的函数
日期和时间相关主题
日期和时间数据类型
下表列出了 Transact-SQL 的日期和时间数据类型。
数据类型 |
格式 |
范围 |
精确度 |
存储大小（以字节为单位） |
用户定义的秒的小数精度 |
时区偏移量 |
|---|---|---|---|---|---|---|
hh:mm:ss[. nnnnnnn] |
00:00:00.0000000 到 23:59:59.9999999 |
100 纳秒 |
3 到 5 |
是 |
否 |
|
YYYY-MM-DD |
0001-01-01 到 9999-12-31 |
1 天 |
3 |
无 |
无 |
|
YYYY-MM-DD hh:mm:ss |
1900-01-01 到 2079-06-06 |
1 分钟 |
4 |
无 |
无 |
|
YYYY-MM-DD hh:mm:ss[. nnn] |
1753-01-01 到 9999-12-31 |
0.00333 秒 |
8 |
无 |
否 |
|
YYYY-MM-DD hh:mm:ss[. nnnnnnn] |
0001-01-01 00:00:00.0000000 到 9999-12-31 23:59:59.9999999 |
100 纳秒 |
6 到 8 |
有 |
无 |
|
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 |
有 |
有 |
.gif "注意") 注意 |
|---|
Transact-SQL rowversion 数据类型不是日期或时间数据类型。 timestamp 是 rowversion 的同义词，但不推荐使用。 |
日期和时间函数
以下各表列出了 Transact-SQL 的日期和时间函数。 有关确定性的详细信息，请参阅确定性函数和不确定性函数。
用来获取系统日期和时间值的函数
所有系统日期和时间值均得自运行 SQL Server 实例的计算机的操作系统。
精度较高的系统日期和时间函数
SQL Server 2012 使用 GetSystemTimeAsFileTime() Windows API 来获取日期和时间值。 精确程度取决于运行 SQL Server 实例的计算机硬件和 Windows 版本。 此 API 的精度固定为 100 纳秒。 可通过使用 GetSystemTimeAdjustment() Windows API 来确定该精确度。
函数 |
语法 |
返回值 |
返回数据类型 |
确定性 |
|---|---|---|---|---|
SYSDATETIME () |
返回包含计算机的日期和时间的 datetime2(7) 值，SQL Server 的实例正在该计算机上运行。 时区偏移量未包含在内。 |
datetime2(7) |
不具有确定性 |
|
SYSDATETIMEOFFSET ( ) |
返回包含计算机的日期和时间的 datetimeoffset(7) 值，SQL Server 的实例正在该计算机上运行。 时区偏移量包含在内。 |
datetimeoffset(7) |
不具有确定性 |
|
SYSUTCDATETIME ( ) |
返回包含计算机的日期和时间的 datetime2(7) 值，SQL Server 的实例正在该计算机上运行。 日期和时间作为 UTC 时间（通用协调时间）返回。 |
datetime2(7) |
不具有确定性 |
精度较低的系统日期和时间函数
函数 |
语法 |
返回值 |
返回数据类型 |
确定性 |
|---|---|---|---|---|
CURRENT_TIMESTAMP |
返回包含计算机的日期和时间的 datetime 值，SQL Server 的实例正在该计算机上运行。 时区偏移量未包含在内。 |
datetime |
不具有确定性 |
|
GETDATE ( ) |
返回包含计算机的日期和时间的 datetime 值，SQL Server 的实例正在该计算机上运行。 时区偏移量未包含在内。 |
datetime |
不具有确定性 |
|
GETUTCDATE ( ) |
返回包含计算机的日期和时间的 datetime 值，SQL Server 的实例正在该计算机上运行。 日期和时间作为 UTC 时间（通用协调时间）返回。 |
datetime |
不具有确定性 |
用来获取日期和时间部分的函数
函数 |
语法 |
返回值 |
返回数据类型 |
确定性 |
|---|---|---|---|---|
DATENAME ( datepart , date ) |
返回表示指定日期的指定 datepart 的字符串。 |
nvarchar |
不具有确定性 |
|
DATEPART ( datepart , date ) |
返回表示指定 date 的指定 datepart 的整数。 |
int |
不具有确定性 |
|
DAY ( date ) |
返回表示指定 date 的“日”部分的整数。 |
int |
具有确定性 |
|
MONTH ( date ) |
返回表示指定 date 的“月”部分的整数。 |
int |
具有确定性 |
|
YEAR ( date ) |
返回表示指定 date 的“年”部分的整数。 |
int |
具有确定性 |
用来从部件中获取日期和时间值的函数
函数 |
语法 |
返回值 |
返回数据类型 |
确定性 |
|---|---|---|---|---|
DATEFROMPARTS ( year, month, day ) |
返回表示指定年、月、日的 date 值。 |
date |
具有确定性 |
|
DATETIME2FROMPARTS (year, month, day, hour, minute, seconds, fractions, precision) |
对指定的日期和时间返回 datetime2 值（具有指定精度）。 |
datetime2 ( precision ) |
具有确定性 |
|
DATETIMEFROMPARTS ( year, month, day, hour, minute, seconds, milliseconds ) |
为指定的日期和时间返回 datetime 值。 |
datetime |
具有确定性 |
|
DATETIMEOFFSETFROMPARTS ( year, month, day, hour, minute, seconds, fractions, hour_offset, minute_offset, precision ) |
对指定的日期和时间返回 datetimeoffset 值，即具有指定的偏移量和精度。 |
datetime ( precision ) |
具有确定性 |
|
SMALLDATETIMEFROMPARTS ( year, month, day, hour, minute ) |
为指定的日期和时间返回 smalldatetime 值。 |
smalldatetime |
具有确定性 |
|
TIMEFROMPARTS ( hour, minute, seconds, fractions, precision ) |
对指定的时间返回 time 值（具有指定精度）。 |
time ( precision ) |
具有确定性 |
用来获取日期和时间差的函数
函数 |
语法 |
返回值 |
返回数据类型 |
确定性 |
|---|---|---|---|---|
DATEDIFF ( datepart , startdate , enddate ) |
返回两个指定日期之间所跨的日期或时间 datepart 边界的数目。 |
int |
具有确定性 |
用来修改日期和时间值的函数
函数 |
语法 |
返回值 |
返回数据类型 |
确定性 |
|---|---|---|---|---|
DATEADD (datepart , number , date ) |
通过将一个时间间隔与指定 date 的指定 datepart 相加，返回一个新的 datetime 值。 |
date 参数的数据类型。 |
具有确定性 |
|
EOMONTH ( start_date [, month_to_add ] ) |
返回包含指定日期的月份的最后一天（具有可选偏移量）。 |
返回类型为 start_date 的类型或 datetime2(7)。 |
具有确定性 |
|
SWITCHOFFSET (DATETIMEOFFSET , time_zone) |
SWITCH OFFSET 更改 DATETIMEOFFSET 值的时区偏移量并保留 UTC 值。 |
datetimeoffset 具有其小数精度：DATETIMEOFFSET |
具有确定性 |
|
TODATETIMEOFFSET (expression , time_zone) |
TODATETIMEOFFSET 将 datetime2 值转换为 datetimeoffset 值。 datetime2 值被解释为指定 time_zone 的本地时间。 |
具有 datetime 参数的小数精度的 datetimeoffset |
具有确定性 |
用来设置或获取会话格式的函数
函数 |
语法 |
返回值 |
返回数据类型 |
确定性 |
|---|---|---|---|---|
@@DATEFIRST |
返回对会话进行 SET DATEFIRST 操作所得结果的当前值。 |
tinyint |
不具有确定性 |
|
SET DATEFIRST { number |@number_var } |
将一周的第一天设置为从 1 到 7 的一个数字。 |
不适用 |
不适用 |
|
SET DATEFORMAT { format |@format_var } |
设置用于输入 datetime 或 smalldatetime 数据的日期各部分（月/日/年）的顺序。 |
不适用 |
不适用 |
|
@@LANGUAGE |
返回当前使用的语言的名称。 @@LANGUAGE 不是日期或时间函数。 但是，语言设置会影响日期函数的输出。 |
不适用 |
不适用 |
|
SET LANGUAGE { [ N ] 'language' |@language_var } |
设置会话和系统消息的语言环境。 SET LANGUAGE 不是日期或时间函数。 但是，语言设置会影响日期函数的输出。 |
不适用 |
不适用 |
|
sp_helplanguage [ [ @language = ] 'language' ] |
返回有关所有支持语言的日期格式的信息。 sp_helplanguage 不是日期或时间存储过程。 但是，语言设置会影响日期函数的输出。 |
不适用 |
不适用 |
用来验证日期和时间值的函数
函数 |
语法 |
返回值 |
返回数据类型 |
确定性 |
|---|---|---|---|---|
ISDATE ( expression ) |
确定 datetime 或 smalldatetime 输入表达式是否为有效的日期或时间值。 |
int |
只有与 CONVERT 函数一起使用，同时指定了 CONVERT 样式参数且样式不等于 0、100、9 或 109 时，ISDATE 才是确定的。 |
日期和时间相关主题
主题 |
说明 |
|---|---|
提供有关在日期和时间值与字符串文字及其他日期和时间格式之间进行相互转换的信息。 |
|
提供使用 Transact-SQL 语句的数据库和数据库应用程序在不同语言之间的可移植性准则，或支持多种语言的数据库和数据库应用程序的可移植性准则。 |
|
提供有关可在 Transact-SQL 语句中使用的 ODBC 标量函数的信息。 这包括 ODBC 日期和时间函数。 |