DATEADD(Transact-SQL)
date의 지정된 datepart에 특정 number 간격(부호 있는 정수)이 추가된 date를 반환합니다.
모든 Transact-SQL 날짜/시간 데이터 형식 및 함수에 대한 개요는 날짜 및 시간 데이터 형식 및 함수(Transact-SQL)를 참조하십시오.
적용 대상: SQL Server(SQL Server 2008 - current version), Windows Azure SQL 데이터베이스(최초 릴리스 - 현재 릴리스) |
.gif "항목 링크 아이콘")
구문
DATEADD (datepart , number , date )
인수
datepart
integer number가 추가되는 date 부분입니다. 다음 표에서는 올바른 모든 datepart 인수를 보여 줍니다. 해당하는 사용자 정의 변수는 사용할 수 없습니다.datepart
약어
year
yy, yyyy
quarter
qq, q
month
mm, m
dayofyear
dy, y
day
dd, d
week
wk, ww
weekday
dw, w
hour
hh
minute
mi, n
second
ss, s
millisecond
ms
microsecond
mcs
nanosecond
ns
number
date의 datepart에 추가된 int로 확인될 수 있는 식입니다. 사용자 정의 변수는 유효합니다.소수점 이하가 포함된 값을 지정할 경우 소수점 이하는 반올림되지 않고 잘립니다.
date
time, date, smalldatetime, datetime, datetime2 또는 datetimeoffset 값으로 확인될 수 있는 식입니다. date는 식, 열 식, 사용자 정의 변수 또는 문자열 리터럴일 수 있습니다 식이 문자열 리터럴인 경우 datetime으로 확인되어야 합니다. 모호성을 피하려면 4자리 연도를 사용하십시오. 2자리 연도에 대한 자세한 내용은 두 자리 연도 구분 서버 구성 옵션 구성을 참조하십시오.
반환 형식
문자열 리터럴을 제외하고 반환 데이터 형식은 date 인수의 데이터 형식입니다.
문자열 리터럴의 반환 데이터 형식은 datetime입니다. 문자열 리터럴 초의 소수 자릿수가 세 자리(.nnn)를 초과하거나 표준 시간대 오프셋 부분을 포함할 경우 오류가 발생합니다.
datepart 인수
dayofyear, day 및 weekday는 같은 값을 반환합니다.
각 datepart와 해당 약어는 동일한 값을 반환합니다.
datepart가 month이고 date 월의 일 수가 반환 월보다 많고 반환 월에 date 일이 없을 경우 반환 월의 마지막 일이 반환됩니다. 예를 들어 9월에는 30일이 있으므로 다음 두 가지 문은 2006-09-30 00:00:00.000을 반환합니다.
SELECT DATEADD(month, 1, '2006-08-30');
SELECT DATEADD(month, 1, '2006-08-31');
number 인수는 int 범위를 초과할 수 없습니다. 다음 문에서 number에 대한 인수는 int 범위를 1만큼 초과합니다. 이 경우 오류 메시지가 반환됩니다. "Msg 8115, Level 16, State 2, Line 1. Arithmetic overflow error converting expression to data type int."
SELECT DATEADD(year,2147483648, '2006-07-31');
SELECT DATEADD(year,-2147483649, '2006-07-31');
date 인수는 해당 데이터 형식 범위를 벗어나는 값으로 증가할 수 없습니다. 다음 문에서는 date 값에 추가된 number 값이 date 데이터 형식의 범위를 초과합니다. 이 경우 오류 메시지가 반환됩니다. "Msg 517, Level 16, State 1, Line 1 Adding a value to a 'datetime' column caused overflow."
SELECT DATEADD(year,2147483647, '2006-07-31');
SELECT DATEADD(year,-2147483647, '2006-07-31');
smalldatetime 값의 초 부분은 항상 00입니다. date가 smalldatetime일 경우 다음이 적용됩니다.
datepart가 second이고 number가 -30에서 +29 사이일 경우 추가되지 않습니다.
datepart가 second이고 number가 -30보다 작거나 +29보다 클 경우 1분부터 추가됩니다.
datepart가 millisecond이고 number가 -30001에서 +29998 사이일 경우 추가되지 않습니다.
datepart가 millisecond이고 number가 -30001보다 작거나 +29998보다 클 경우 1분부터 추가됩니다.
주의
DATEADD는 SELECT <목록>, WHERE, HAVING, GROUP BY 및 ORDER BY 절에서 사용할 수 있습니다.
소수 자릿수 초의 전체 자릿수
date 데이터 형식 smalldatetime, date 및 datetime에 대한 microsecond 또는 nanosecond의 datepart 추가는 허용되지 않습니다.
밀리초의 소수 자릿수는 세 자리이며(.123) 마이크로초는 6자리(.123456), 나노초는 9자리(.123456789)입니다. time, datetime2 및 datetimeoffset 데이터 형식의 최대 소수 자릿수는 7자리입니다(.1234567). datepart가 nanosecond일 경우 date의 소수 자릿수 초가 증가하려면 number가 100이어야 합니다. number가 1에서 49 사이일 경우 0으로 버려지며 50에서 99 사이일 경우 100으로 반올림됩니다.
다음 문에서는 millisecond, microsecond 또는 nanosecond의 datepart를 추가합니다.
DECLARE @datetime2 datetime2 = '2007-01-01 13:10:10.1111111';
SELECT '1 millisecond', DATEADD(millisecond,1,@datetime2)
UNION ALL
SELECT '2 milliseconds', DATEADD(millisecond,2,@datetime2)
UNION ALL
SELECT '1 microsecond', DATEADD(microsecond,1,@datetime2)
UNION ALL
SELECT '2 microseconds', DATEADD(microsecond,2,@datetime2)
UNION ALL
SELECT '49 nanoseconds', DATEADD(nanosecond,49,@datetime2)
UNION ALL
SELECT '50 nanoseconds', DATEADD(nanosecond,50,@datetime2)
UNION ALL
SELECT '150 nanoseconds', DATEADD(nanosecond,150,@datetime2);
결과 집합은 다음과 같습니다.
1 millisecond 2007-01-01 13:10:10.1121111
2 milliseconds 2007-01-01 13:10:10.1131111
1 microsecond 2007-01-01 13:10:10.1111121
2 microseconds 2007-01-01 13:10:10.1111131
49 nanoseconds 2007-01-01 13:10:10.1111111
50 nanoseconds 2007-01-01 13:10:10.1111112
150 nanoseconds 2007-01-01 13:10:10.1111113
표준 시간대 오프셋
표준 시간대 오프셋에 대한 추가는 허용되지 않습니다.
예
1.1씩 datepart 증가
다음 각 문은 datepart를 1씩 증가시킵니다.
DECLARE @datetime2 datetime2 = '2007-01-01 13:10:10.1111111';
SELECT 'year', DATEADD(year,1,@datetime2)
UNION ALL
SELECT 'quarter',DATEADD(quarter,1,@datetime2)
UNION ALL
SELECT 'month',DATEADD(month,1,@datetime2)
UNION ALL
SELECT 'dayofyear',DATEADD(dayofyear,1,@datetime2)
UNION ALL
SELECT 'day',DATEADD(day,1,@datetime2)
UNION ALL
SELECT 'week',DATEADD(week,1,@datetime2)
UNION ALL
SELECT 'weekday',DATEADD(weekday,1,@datetime2)
UNION ALL
SELECT 'hour',DATEADD(hour,1,@datetime2)
UNION ALL
SELECT 'minute',DATEADD(minute,1,@datetime2)
UNION ALL
SELECT 'second',DATEADD(second,1,@datetime2)
UNION ALL
SELECT 'millisecond',DATEADD(millisecond,1,@datetime2)
UNION ALL
SELECT 'microsecond',DATEADD(microsecond,1,@datetime2)
UNION ALL
SELECT 'nanosecond',DATEADD(nanosecond,1,@datetime2);
결과 집합은 다음과 같습니다.
Year 2008-01-01 13:10:10.1111111
quarter 2007-04-01 13:10:10.1111111
month 2007-02-01 13:10:10.1111111
dayofyear 2007-01-02 13:10:10.1111111
day 2007-01-02 13:10:10.1111111
week 2007-01-08 13:10:10.1111111
weekday 2007-01-02 13:10:10.1111111
hour 2007-01-01 14:10:10.1111111
minute 2007-01-01 13:11:10.1111111
second 2007-01-01 13:10:11.1111111
millisecond 2007-01-01 13:10:10.1121111
microsecond 2007-01-01 13:10:10.1111121
nanosecond 2007-01-01 13:10:10.1111111
2.하나의 문에서 datepart를 두 수준 이상 증가
다음 각 문은 datepart를 number만큼 증가시키며 이로 인해 date에서 한 수준 높은 datepart도 증가하게 됩니다.
DECLARE @datetime2 datetime2;
SET @datetime2 = '2007-01-01 01:01:01.1111111';
--Statement Result
-------------------------------------------------------------------
SELECT DATEADD(quarter,4,@datetime2); --2008-01-01 01:01:01.110
SELECT DATEADD(month,13,@datetime2); --2008-02-01 01:01:01.110
SELECT DATEADD(dayofyear,365,@datetime2); --2008-01-01 01:01:01.110
SELECT DATEADD(day,365,@datetime2); --2008-01-01 01:01:01.110
SELECT DATEADD(week,5,@datetime2); --2007-02-05 01:01:01.110
SELECT DATEADD(weekday,31,@datetime2); --2007-02-01 01:01:01.110
SELECT DATEADD(hour,23,@datetime2); --2007-01-02 00:01:01.110
SELECT DATEADD(minute,59,@datetime2); --2007-01-01 02:00:01.110
SELECT DATEADD(second,59,@datetime2); --2007-01-01 01:02:00.110
SELECT DATEADD(millisecond,1,@datetime2); --2007-01-01 01:01:01.110
3.식을 숫자 및 날짜 매개 변수에 대한 인수로 사용
다음 예에서는 여러 유형의 식을 number 및 date 매개 변수에 대한 인수로 사용합니다.
열을 날짜로 지정
다음 예제에서는 2 일수를 OrderDate 열의 각 값에 추가하여 이름이 PromisedShipDate인 새 열을 파생시킵니다.
USE AdventureWorks2012;
GO
SELECT SalesOrderID
,OrderDate
,DATEADD(day,2,OrderDate) AS PromisedShipDate
FROM Sales.SalesOrderHeader;
다음은 결과 집합의 일부입니다.
SalesOrderID OrderDate PromisedShipDate
------------ ----------------------- -----------------------
43659 2005-07-01 00:00:00.000 2005-07-03 00:00:00.000
43660 2005-07-01 00:00:00.000 2005-07-03 00:00:00.000
43661 2005-07-01 00:00:00.000 2005-07-03 00:00:00.000
...
43702 2005-07-02 00:00:00.000 2005-07-04 00:00:00.000
43703 2005-07-02 00:00:00.000 2005-07-04 00:00:00.000
43704 2005-07-02 00:00:00.000 2005-07-04 00:00:00.000
43705 2005-07-02 00:00:00.000 2005-07-04 00:00:00.000
43706 2005-07-03 00:00:00.000 2005-07-05 00:00:00.000
...
43711 2005-07-04 00:00:00.000 2005-07-06 00:00:00.000
43712 2005-07-04 00:00:00.000 2005-07-06 00:00:00.000
...
43740 2005-07-11 00:00:00.000 2005-07-13 00:00:00.000
43741 2005-07-12 00:00:00.000 2005-07-14 00:00:00.000
사용자 정의 변수를 숫자 및 날짜로 지정
다음 예에서는 사용자 정의 변수를 number 및 date에 대한 인수로 지정합니다.
DECLARE @days int = 365,
@datetime datetime = '2000-01-01 01:01:01.111'; /* 2000 was a leap year */;
SELECT DATEADD(day, @days, @datetime);
결과 집합은 다음과 같습니다.
-----------------------
2000-12-31 01:01:01.110
(1 row(s) affected)
스칼라 시스템 함수를 날짜로 지정
다음 예에서는 date에 대한 SYSDATETIME을 지정합니다.
SELECT DATEADD(month, 1, SYSDATETIME());
결과 집합은 다음과 같습니다.
---------------------------
2013-02-06 14:29:59.6727944
(1 row(s) affected)
스칼라 하위 쿼리 및 스칼라 함수를 숫자 및 날짜로 지정
다음 예에서는 스칼라 하위 쿼리인 MAX(ModifiedDate)를 number 및 date에 대한 인수로 사용합니다. (SELECT TOP 1 BusinessEntityID FROM Person.Person)은 값 목록에서 number 인수를 선택하는 방법을 보여 주기 위하여 만든 숫자 매개 변수에 대한 인수입니다.
USE AdventureWorks2012;
GO
SELECT DATEADD(month,(SELECT TOP 1 BusinessEntityID FROM Person.Person),
(SELECT MAX(ModifiedDate) FROM Person.Person));
숫자 식 및 스칼라 시스템 함수를 숫자 및 날짜로 지정
다음 예에서는 숫자 식(-(10/2)), 단항 연산자(-), 산술 연산자(/), 스칼라 시스템 함수(SYSDATETIME)를 number 및 date에 대한 인수로 사용합니다.
SELECT DATEADD(month,-(10/2), SYSDATETIME());
순위 함수를 숫자로 지정
다음 예에서는 순위 함수를 number에 대한 인수로 사용합니다.
USE AdventureWorks2012;
GO
SELECT p.FirstName, p.LastName
,DATEADD(day,ROW_NUMBER() OVER (ORDER BY
a.PostalCode),SYSDATETIME()) AS 'Row Number'
FROM Sales.SalesPerson AS s
INNER JOIN Person.Person AS p
ON s.BusinessEntityID = p.BusinessEntityID
INNER JOIN Person.Address AS a
ON a.AddressID = p.BusinessEntityID
WHERE TerritoryID IS NOT NULL
AND SalesYTD <> 0;
집계 창 함수를 숫자로 지정
다음 예에서는 집계 창 함수를 number 인수로 사용합니다.
USE AdventureWorks2012;
GO
SELECT SalesOrderID, ProductID, OrderQty
,DATEADD(day,SUM(OrderQty)
OVER(PARTITION BY SalesOrderID),SYSDATETIME()) AS 'Total'
FROM Sales.SalesOrderDetail
WHERE SalesOrderID IN(43659,43664);
GO