sqlserver 时间类型和函数

日期和时间数据类型

下表列出了 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 到 9999-12-31

1 天

无

smalldatetime

YYYY-MM-DD hh:mm:ss

1900-01-01 到 2079-06-06

1 分钟

datetime

YYYY-MM-DD hh:mm:ss[.nnn]

1753-01-01 到 9999-12-31

0.00333秒

datetime2

YYYY-MM-DD hh:mm:ss[.nnnnnnn]

0001-01-01 00:00:00.0000000 到9999-12-31 23:59:59.9999999

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 时间表示）

8 到10

有

注意:Transact-sql rowversion 数据类型不是日期或时间数据类型.timestamp 是 rowversion 的同义词,但不推荐使用.

日期和时间函数

用来获取系统日期和时间值的函数

所有系统日期和时间值均得自运行 sql Server 实例的计算机的操作系统.
精度较高的系统日期和时间函数

sql Server 2008 使用 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 ( )	sql Server 的实例正在该计算机上运行.日期和时间作为 UTC 时间（通用协调时间）返回.	不具有确定性

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

函数	语法	返回值	返回数据类型	确定性
CURRENT_TIMESTAMP	CURRENT_TIMESTAMP	返回包含计算机的日期和时间的datetime2(7) 值,sql Server的实例正在该计算机上运行.时区偏移量未包含在内.	datetime	不具有确定性
GETDATE	GETDATE ( )	GETUTCDATE	GETUTCDATE ( )	sql Server的实例正在该计算机上运行.日期和时间作为 UTC 时间（通用协调时间）返回.	datetime	不具有确定性

用来获取日期和时间部分的函数

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

用来获取日期和时间差的函数

@H_502_1134@返回数据类型

@H_502_1134@int

函数

语法

返回值

确定性

DATEDIFF

DATEDIFF ( datepart ,startdate , enddate )

返回两个指定日期之间所跨的日期或时间 datepart 边界的数目.

用来修改日期和时间值的函数

函数

语法

返回值

返回数据类型

确定性

DATEADD

DATEADD (datepart, number , date )

通过将一个时间间隔与指定date 的指定 datepart相加,返回一个新的datetime 值.

date 参数的数据类型.

具有确定性

SWITCHOFFSET

SWITCHOFFSET(DATETIMEOFFSET ,time_zone)

SWITCH OFFSET 更改DATETIMEOFFSET 值的时区偏移量并保留 UTC 值.

具有DATETIMEOFFSET的小数精度的datetimeoffset

TODATETIMEOFFSET

TODATETIMEOFFSET (expression ,courier">TODATETIMEOFFSET 将datetime2 值转换为datetimeoffset值.datetime2 值被解释为指定 time_zone 的本地时间.

具有 datetime 参数的小数精度的datetimeoffset

用来设置或获取会话格式的函数

函数	语法	返回值	返回数据类型	确定性
@@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 不是日期或时间函数.但是,courier">sp_helplanguage	sp_helplanguage [ [@language = ]'language' ]	返回有关所有支持语言日期格式的信息.sp_helplanguage 不是日期或时间存储过程.但是,courier">不适用

用来验证日期和时间值的函数

函数	语法	返回值	返回数据类型	确定性
ISDATE	ISDATE (expression )	确定 datetime 或smalldatetime 输入表达式是否为有效的日期或时间值.	int	只有与 CONVERT 函数一起使用,同时指定了 CONVERT 样式参数且样式不等于 0,100,9 或 109时,ISDATE 才是确定的.

日期和时间相关主题

主题	说明
使用日期和时间数据	提供通用于日期和时间数据类型及函数的信息和示例.
CAST 和 CONVERT (Transact-sql)	提供有关在日期和时间值与字符串文字及其他日期和时间格式之间进行相互转换的信息.
编写国际化 Transact-sql 语句	提供使用 Transact-sql 语句的数据库和数据库应用程序在不同语言之间的可移植性准则,或支持多种语言的数据库和数据库应用程序的可移植性准则.
ODBC 标量函数(Transact-sql)	提供有关可在 Transact-sql 语句中使用的 ODBC 标量函数的信息.这包括ODBC 日期和时间函数.
分布式查询的数据类型映射	提供有关以下方面的信息:日期和时间数据类型对具有不同版本的 sql Server 或不同访问接口的服务器之间的分布式查询有何影响.