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

适用于: 是SQL Server(所有支持的版本) 是Azure SQL 数据库 是Azure SQL 托管实例 是Azure Synapse Analytics

本主题的各节涵盖了所有 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 到 31.12.99 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 日期和时间函数。 有关确定性的详细信息,请参阅确定性函数和非确定性函数

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

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

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

SQL Server 2019 (15.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 不具有确定性

返回日期和时间部分的函数

函数 语法 返回值 返回数据类型 确定性
DATENAME DATENAME ( datepart , date ) 返回表示指定 date 的指定 datepart 的字符串。 nvarchar 不具有确定性
DATEPART DATEPART ( datepart , date ) 返回表示指定 date 的指定 datepart 的整数。 int 不具有确定性
DAY DAY ( date ) 返回表示指定 date 的“日”部分的整数。 int Deterministic
MONTH MONTH ( date ) 返回表示指定 date 的“月”部分的整数。 int Deterministic
YEAR YEAR ( date ) 返回表示指定 date 的“年”部分的整数。 int Deterministic

从相应部分返回日期和时间值的函数

函数 语法 返回值 返回数据类型 确定性
DATEFROMPARTS DATEFROMPARTS ( year, month, day ) 返回表示指定年、月、日的 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 DATEDIFF ( datepart , startdate , enddate ) 返回两个指定日期之间所跨的日期或时间 datepart 边界数。 int 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

设置或返回会话格式函数的函数

函数 语法 返回值 返回数据类型 确定性
@@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 样式参数且样式不等于 0、100、9 或 109 时,ISDATE 只有在与 CONVERT 函数一起使用时才是确定的。
主题 说明
FORMAT 返回以指定的格式和可选的区域性格式化的值。 使用 FORMAT 函数将日期/时间和数字值格式化为识别区域设置的字符串。
CAST 和 CONVERT (Transact-SQL) 提供有关在日期和时间值与字符串文字及其他日期和时间格式之间进行相互转换的信息。
编写国际化 Transact-SQL 语句 提供使用 Transact-SQL 语句的数据库和数据库应用程序在不同语言之间的可移植性准则,或支持多种语言的数据库和数据库应用程序的可移植性准则。
ODBC 标量函数 (Transact-SQL) 提供有关可在 Transact-SQL 语句中使用的 ODBC 标量函数的信息。 这包括 ODBC 日期和时间函数。
AT TIME ZONE (Transact-SQL) 提供时区转换。

请参阅