日期和时间数据类型及函数 (Transact-SQL)
适用于:SQL Server Azure SQL 数据库 azure Synapse Analytics Azure 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 到 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 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 的整数。 | int | 不具有确定性 |
DATETRUNC | DATETRUNC ( datepart, date ) | 返回截断为指定 datepart 的输入 date。 | 返回类型取决于为 date 提供的参数。 | 不具有确定性 |
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) | 提供时区转换。 |
请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈