SQL Server 函数参考手册（SQL Server 日期函数）

目录

SQL Server CURRENT_TIMESTAMP 函数

SQL Server DATEADD() 函数

SQL Server DATEDIFF() 函数

SQL Server DATEFROMPARTS() 函数

SQL Server DATENAME() 函数

SQL Server DATEPART() 函数

SQL Server DAY() 函数

SQL Server GETDATE() 函数

SQL Server GETUTCDATE() 函数

SQL Server ISDATE() 函数

SQL Server MONTH() 函数

SQL Server SYSDATETIME() 函数

SQL Server YEAR() 函数

---

SQL Server CURRENT_TIMESTAMP 函数

【实例】

返回当前日期和时间：

SELECT CURRENT_TIMESTAMP;

【定义和用法】

CURRENT_TIMESTAMP 函数以 'YYYY-MM-DD hh:mm:ss.mmm' 格式返回当前日期和时间。

注：同时查看 GETDATE() 函数。

【语法】

CURRENT_TIMESTAMP

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

SQL Server DATEADD() 函数

【实例】

给日期加上一年，然后返回日期：

SELECT DATEADD(year, 1, '2017/08/25') AS DateAdd;

【定义和用法】

DATEADD() 函数将时间/日期间隔添加到日期，然后返回日期。

【语法】

DATEADD(interval, number, date)

【参数值】

参数	描述
interval	必需。要添加的时间/日期间隔。 可以是以下值之一： year, yyyy, yy = Year quarter, qq, q = Quarter month, mm, m = month dayofyear, dy, y = Day of the year day, dd, d = Day week, ww, wk = Week weekday, dw, w = Weekday hour, hh = hour minute, mi, n = Minute second, ss, s = Second millisecond, ms = Millisecond
number	必需。添加到日期的interval数。 可以是正数（获取未来的日期）或负数（获取过去的日期）
date	必需。修改日期

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

【实例】

给一个日期加上两个月，然后返回日期：

SELECT DATEADD(month, 2, '2017/08/25') AS DateAdd;

【实例】

从一个日期减去两个月，然后返回日期：

SELECT DATEADD(month, -2, '2017/08/25') AS DateAdd;

【实例】

将 BirthDate 列中的日期加上 18 年，然后返回日期：

SELECT LastName, BirthDate, DATEADD(year, 18, BirthDate) AS DateAdd FROM Employees;

SQL Server DATEDIFF() 函数

【实例】

返回两个日期值之间的差，以年为单位：

SELECT DATEDIFF(year, '2017/08/25', '2011/08/25') AS DateDiff;

【定义和用法】

DATEDIFF() 函数返回两个日期之间的差值。

【语法】

DATEDIFF(interval, date1, date2)

【参数值】

参数	描述
interval	必需。要返回的部分。 可以是以下值之一： year, yyyy, yy = Year quarter, qq, q = Quarter month, mm, m = month dayofyear = Day of the year day, dy, y = Day week, ww, wk = Week weekday, dw, w = Weekday hour, hh = hour minute, mi, n = Minute second, ss, s = Second millisecond, ms = Millisecond
date1, date2	必需。计算两个日期之间的差异

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

【实例】

返回两个日期值之间的差，以月为单位：

SELECT DATEDIFF(month, '2017/08/25', '2011/08/25') AS DateDiff;

【实例】

返回两个日期值之间的差异，以小时为单位：

SELECT DATEDIFF(hour, '2017/08/25 07:00', '2017/08/25 12:45') AS DateDiff;

SQL Server DATEFROMPARTS() 函数

【实例】

从它的部分返回一个日期：

SELECT DATEFROMPARTS(2018, 10, 31) AS DateFromParts;

【定义和用法】

DATEFROMPARTS() 函数从指定部分（年、月和日值）返回日期。

【语法】

DATEFROMPARTS(year, month, day)

【参数值】

参数	描述
year	必需。指定年份（4 位）
month	必需。指定一个月（从1到12）
day	必需。指定一天（从1到31）

【技术细节】

适用于:	SQL Server (starting with 2012), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

SQL Server DATENAME() 函数

【实例】

返回日期的指定部分：

SELECT DATENAME(year, '2017/08/25') AS DatePartString;

【定义和用法】

DATENAME() 函数返回日期的指定部分。

此函数将结果作为字符串值返回。

【语法】

DATENAME(interval, date)

【参数值】

参数	描述
interval	必需。要返回的部分。 可以是以下值之一： year, yyyy, yy = Year quarter, qq, q = Quarter month, mm, m = month dayofyear = Day of the year day, dy, y = Day week, ww, wk = Week weekday, dw, w = Weekday hour, hh = hour minute, mi, n = Minute second, ss, s = Second millisecond, ms = Millisecond
date	必需。 The date to use

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

【实例】

返回日期的指定部分：

SELECT DATENAME(yy, '2017/08/25') AS DatePartString;

【实例】

返回日期的指定部分：

SELECT DATENAME(month, '2017/08/25') AS DatePartString;

【实例】

返回日期的指定部分：

SELECT DATENAME(hour, '2017/08/25 08:36') AS DatePartString;

【实例】

返回日期的指定部分：

SELECT DATENAME(minute, '2017/08/25 08:36') AS DatePartString;

SQL Server DATEPART() 函数

【实例】

返回日期的指定部分：

SELECT DATEPART(year, '2017/08/25') AS DatePartInt;

【定义和用法】

DATEPART() 函数返回日期的指定部分。

此函数将结果作为整数值返回。

【语法】

DATEPART(interval, date)

【参数值】

参数	描述
interval	必需。要返回的部分。 可以是以下值之一： year, yyyy, yy = Year quarter, qq, q = Quarter month, mm, m = month dayofyear, dy, y = Day of the year day, dd, d = Day of the month week, ww, wk = Week weekday, dw, w = Weekday hour, hh = hour minute, mi, n = Minute second, ss, s = Second millisecond, ms = Millisecond
date	必需。 The date to use

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

【实例】

返回日期的指定部分：

SELECT DATEPART(yy, '2017/08/25') AS DatePartInt;

【实例】

返回日期的指定部分：

SELECT DATEPART(month, '2017/08/25') AS DatePartInt;

【实例】

返回日期的指定部分：

SELECT DATEPART(hour, '2017/08/25 08:36') AS DatePartInt;

【实例】

返回日期的指定部分：

SELECT DATEPART(minute, '2017/08/25 08:36') AS DatePartInt;

SQL Server DAY() 函数

【实例】

返回日期的月份日期：

SELECT DAY('2017/08/25') AS DayOfMonth;

【定义和用法】

DAY() 函数返回指定日期的月份中的第几天（从 1 到 31）。

【语法】

DAY(date)

【参数值】

参数	描述
date	必需。返回月份日期的日期

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

【实例】

返回日期的月份日期：

SELECT DAY('2017/08/13 09:08') AS DayOfMonth;

SQL Server GETDATE() 函数

【实例】

返回当前数据库系统日期和时间：

SELECT GETDATE();

【定义和用法】

GETDATE() 函数以 'YYYY-MM-DD hh:mm:ss.mmm' 格式返回当前数据库系统日期和时间。

注：同时查看 CURRENT_TIMESTAMP 函数。

【语法】

GETDATE()

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

SQL Server GETUTCDATE() 函数

【实例】

返回当前 UTC 日期和时间：

SELECT GETUTCDATE();

【定义和用法】

GETUTCDATE() 函数以 'YYYY-MM-DD hh:mm:ss.mmm' 格式返回当前数据库系统 UTC 日期和时间。

【语法】

GETUTCDATE()

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

SQL Server ISDATE() 函数

【实例】

检查表达式是否为有效日期：

SELECT ISDATE('2017-08-25');

【定义和用法】

ISDATE() 函数检查表达式，如果是有效日期则返回 1，否则返回 0。

【语法】

ISDATE(expression)

【参数值】

参数	描述
expression	必需。要测试的表达式

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

【实例】

检查表达式是否为有效日期：

SELECT ISDATE('2017');

【实例】

检查表达式是否为有效日期：

SELECT ISDATE('Hello world!');

SQL Server MONTH() 函数

【实例】

返回日期的月份部分：

SELECT MONTH('2017/08/25') AS Month;

【定义和用法】

MONTH() 函数返回指定日期的月份部分（从 1 到 12 的数字）。

【语法】

MONTH(date)

【参数值】

参数	描述
date	必需。从中提取月份的日期或日期时间

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

【实例】

返回日期的月份部分：

SELECT MONTH('2017/05/25 09:08') AS Month;

SQL Server SYSDATETIME() 函数

【实例】

返回 SQL Server 的日期和时间：

SELECT SYSDATETIME() AS SysDateTime;

【定义和用法】

SYSDATETIME() 函数返回运行 SQL Server 的计算机的日期和时间。

【语法】

SYSDATETIME()

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

SQL Server YEAR() 函数

【实例】

返回日期的年份部分：

SELECT YEAR('2017/08/25') AS Year;

【定义和用法】

YEAR() 函数返回指定日期的年份部分。

【语法】

YEAR(date)

【参数值】

参数	描述
date	必需。从中提取年份的日期或日期时间

【技术细节】

适用于:	SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

【实例】

返回日期的年份部分：

SELECT YEAR('1998/05/25 09:08') AS Year;