SQL Server 日期和时间数据类型及函数

日期和时间数据类型

下表列出了 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 函数一起使用时才是确定的。

日期和时间相关主题

主题	说明
FORMAT	返回以指定的格式和可选的区域性格式化的值。 使用 FORMAT 函数将日期/时间和数字值格式化为识别区域设置的字符串。
CAST 和 CONVERT (Transact-SQL)	提供有关在日期和时间值与字符串文字及其他日期和时间格式之间进行相互转换的信息。
编写国际化 Transact-SQL 语句	提供一些指导原则，用于将使用 SQL transact-sql 语句的数据库和数据库应用程序从一种语言迁移到另一种语言，或支持多种语言。
ODBC 标量函数 (Transact-SQL)	提供有关可在 SQL transact-sql 语句中使用的 ODBC 标量函数的信息。 这包括 ODBC 日期和时间函数。
AT TIME ZONE (Transact-SQL)	提供时区转换。