日期和时间数据类型及函数 - SQL Server (Transact-SQL)

日期和时间数据类型

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

存储大小（字节）用户定义的秒的小数部分精度时区偏移量 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 日期和时间函数。有关确定性的详细信息，请参阅确定性函数和非确定性函数。

返回系统日期和时间值的函数

Transact-SQL 从运行 SQL Server 实例的计算机的操作系统派生所有系统日期和时间值。

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

自 SQL Server 2008 (10.0.x) 起，数据库引擎使用 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 返回包含计算机的日期和时间的 datetime 值，SQL Server 的实例在该计算机上运行。返回值不包括时区偏移量。 datetime 不具有确定性 GETDATE GETDATE ( ) 返回包含计算机的日期和时间的 datetime 值，SQL Server 的实例在该计算机上运行。返回值不包括时区偏移量。 datetime 不具有确定性 GETUTCDATE GETUTCDATE ( ) 返回包含计算机的日期和时间的 datetime 值，SQL Server 的实例在该计算机上运行。该函数返回日期和时间作为 UTC 时间（协调世界时）。 datetime 不具有确定性
返回日期和时间部分的函数
返回数据类型 DATE_BUCKET DATE_BUCKET ( datepart, number, date, origin ) 从 origin 参数定义的时间戳或默认原始值 1900-01-01 00:00:00.000 （如果未指定 origin 参数）返回与每个日期/时间 Bucket 的起始值相对应的日期/时间值。返回类型取决于为 date 提供的参数。不具有确定性 DATENAME DATENAME ( datepart , date ) 返回表示指定 date 的指定 datepart 的字符串。 nvarchar 不具有确定性 DATEPART DATEPART ( datepart , date ) 返回表示指定 date 的指定 datepart 的整数。不具有确定性 DATETRUNC DATETRUNC ( datepart, date ) 返回截断为指定 datepart 的输入 date。返回类型取决于为 date 提供的参数。不具有确定性 DAY ( date ) 返回表示指定 date 的“日”部分的整数。 Deterministic MONTH MONTH ( date ) 返回表示指定 date 的“月”部分的整数。 Deterministic YEAR ( date ) 返回表示指定 date 的“年”部分的整数。 Deterministic
从相应部分返回日期和时间值的函数
返回数据类型 DATETIME2FROMPARTS DATETIME2FROMPARTS ( year, month, day, hour, minute, seconds, fractions, precision) 对指定的日期和时间返回 datetime2 值（具有指定精度）。 datetime2( precision ) Deterministic DATETIMEFROMPARTS DATETIMEFROMPARTS ( year, month, day, hour, minute, seconds, milliseconds) 为指定的日期和时间返回 datetime 值。 datetime Deterministic DATETIMEOFFSETFROMPARTS DATETIMEOFFSETFROMPARTS ( year, month, day, hour, minute, seconds, fractions, hour_offset, minute_offset, precision) 对指定的日期和时间返回 datetimeoffset 值（具有指定的偏移量和精度）。 datetimeoffset( precision ) Deterministic SMALLDATETIMEFROMPARTS SMALLDATETIMEFROMPARTS ( year, month, day, hour, minute ) 为指定的日期和时间返回 smalldatetime 值。 smalldatetime Deterministic TIMEFROMPARTS TIMEFROMPARTS ( hour, minute, seconds, fractions, precision ) 对指定的时间返回 time 值（具有指定精度）。 time( precision ) Deterministic
返回日期和时间差异值的函数
返回数据类型 DATEDIFF_BIG DATEDIFF_BIG ( datepart, startdate, enddate ) 返回两个指定日期之间所跨的日期或时间 datepart 边界数。 bigint Deterministic
修改日期和时间值的函数
返回数据类型 DATEADD DATEADD (datepart, number, date ) 通过将一个时间间隔与指定 date 的指定 datepart 相加，返回一个新的 datetime 值。 date 参数的数据类型 Deterministic EOMONTH EOMONTH ( start_date [, month_to_add ] ) 返回包含指定日期的月份的最后一天（具有可选偏移量）。返回类型为 start_date 参数类型或 date 数据类型。 Deterministic SWITCHOFFSET SWITCHOFFSET (DATETIMEOFFSET, time_zone) SWITCHOFFSET 更改 DATETIMEOFFSET 值的时区偏移量并保留 UTC 值。具有 DATETIMEOFFSET 小数精度的 datetimeoffset Deterministic TODATETIMEOFFSET TODATETIMEOFFSET (expression, time_zone) TODATETIMEOFFSET 将 datetime2 值转换为 datetimeoffset 值。 TODATETIMEOFFSET 针对指定 time_zone 解释本地时间的 datetime2 值。具有 datetime 参数小数精度的 datetimeoffset Deterministic
设置或返回会话格式函数的函数
返回数据类型 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 不是日期或时间存储过程。但是，语言设置会影响日期函数的输出。
验证日期和时间值的函数
返回数据类型编写国际化 Transact-SQL 语句提供使用 Transact-SQL 语句的数据库和数据库应用程序在不同语言之间的可移植性准则，或支持多种语言的数据库和数据库应用程序的可移植性准则。 ODBC 标量函数 (Transact-SQL) 提供有关可在 Transact-SQL 语句中使用的 ODBC 标量函数的信息。这包括 ODBC 日期和时间函数。 AT TIME ZONE (Transact-SQL) 提供时区转换。
数据类型 (Transact-SQL)