日期和时间数据类型
下表列出了 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 是 是
备注
rowversion 数据类型不是日期或时间数据类型。 SQL timestamp 是 rowversion 的已弃用同义词。
日期和时间函数
下表列出了 SQL 的日期和时间函数。 有关确定性的详细信息,请参阅确定性函数和非确定性函数 。
返回系统日期和时间值的函数
SQL transact-sql 从运行 SQL Server 实例的计算机的操作系统中派生所有系统日期和时间值。
精度较高的系统日期和时间函数
SQL Server 2019 () 通过使用 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 返回一个 日期/时间值,该值包含运行实例的计算机的SQL Server时间。 返回值不包括时区偏移量。 datetime 不具有确定性 GETDATE GETDATE ( ) 返回一个 日期/时间值,该值包含运行实例的计算机的SQL Server时间。 返回值不包括时区偏移量。 datetime 不具有确定性 GETUTCDATE GETUTCDATE ( ) 返回一个 日期/时间值,该值包含运行实例的计算机的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 ) 具有确定性
返回日期和时间差异值的函数
函数 语法 返回值 返回数据类型 确定性 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 设置 DATEFIRST { number @ @ } 将一周的第一天设置为从 1 到 7 的一个数字。 不适用 不适用 SET DATEFORMAT 设置 DATEFORMAT { format @ @ } 设置用于输入 datetime 或 smalldatetime 数据的日期各部分(月/日/年)的顺序。 不适用 不适用 @@LANGUAGE @@LANGUAGE 返回当前所用语言的名称。 @@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 函数一起使用时才是确定的。