addtodate

(권장되지 않음, duration형 또는 calendarDuration형 사용) 날짜 일련 번호 값에 시간 추가

addtodate는 권장되지 않습니다. datetime 데이터형을 사용하여 특정 시점을 나타내고 duration형 또는 calendarDuration형 값을 사용하여 시간을 datetime형 값에 추가하십시오. 코드 업데이트에 대한 자세한 내용은 버전 내역 또는 Replace Discouraged Instances of Serial Date Numbers and Date Strings 항목을 참조하십시오.

구문

dt = addtodate(d,t,timeUnit)

설명

dt = addtodate(d,t,timeUnit)은 날짜 일련 번호 값 d에 시간 길이 t를 추가하고 결과를 다른 날짜 일련 번호 값 dt로 반환합니다. 입력 인수 timeUnit은 t의 시간 단위를 지정합니다. 예를 들어, addtodate(d,12,"hours")는 d로 표현된 날짜와 시간에 12시간을 추가합니다.

예제

날짜 일련 번호 값에 시간 추가하기

2022년 1월 1일을 나타내는 날짜 일련 번호 값을 만듭니다.

d = datenum("2022-01-01")

d = 738522

d에 14일을 추가합니다. 표시를 위해 날짜 번호 값을 datetime형 값으로 변환합니다.

dt = addtodate(d,14,"day")

dt = 738536

datetime(dt,"ConvertFrom","datenum")

ans = datetime
   15-Jan-2022

두 번째 입력 인수를 음수로 지정하여 dt에서 12시간을 뺍니다.

dt = addtodate(dt,-12,"hour")

dt = 7.3854e+05

datetime(dt,"ConvertFrom","datenum")

ans = datetime
   14-Jan-2022 12:00:00

만약 추가된 시간 길이가 충분히 길다면, dt는 앞이나 뒤의 적절한 기간으로 이동합니다. 예를 들어, dt에 30일을 추가하면 날짜가 2월로 바뀝니다.

dt = addtodate(dt,30,"day");
datetime(dt,"ConvertFrom","datenum")

ans = datetime
   13-Feb-2022 12:00:00

입력 인수

d — 날짜/시간 입력값

날짜 일련 번호 값

날짜/시간 입력값으로, 날짜 일련 번호 값으로 지정됩니다.

t — 시간 길이

정수

d에 추가할 시간 길이로, –10¹⁶과 10¹⁶ 사이(구간의 끝점 포함)의 정수로 지정됩니다.

timeUnit — t의 시간 단위

"year" | "month" | "day" | "hour" | "minute" | "second" | "millisecond"

t의 시간 단위로, 나열된 값 중 하나로 지정됩니다.

버전 내역

R2006a 이전에 개발됨

R2022b: 권장되지 않음

addtodate를 제거할 계획은 없습니다. 하지만 그 대신 datetime, duration, calendarDuration 데이터형이 권장됩니다. datetime 데이터형은 유연한 날짜/시간 형식과 나노초 정밀도로 표현하기 위한 저장공간, 표준 시간대와 일광 절약 시간제를 고려하기 위한 속성을 제공합니다. duration형 값(시, 분, 초에 대해) 또는 calendarDuration형 값(달력상의 연수, 분기, 월, 주, 일에 대해)을 사용하여 시간의 길이를 datetime형 값에 추가할 수 있습니다.

예를 들어 날짜 일련 번호 값을 datetime형 값으로 변환합니다. 그런 다음 hours 함수로 4시간씩 증가하는 시간으로 구성된 배열을 추가하여 duration형 값의 배열을 만듭니다. 그 결과는 datetime형 값으로 구성된 배열입니다.

d = 738522;
d = datetime(d,"ConvertFrom","datenum")

d = datetime
   01-Jan-2022

d = d + hours(0:4:12)

d = 1x4 datetime array
   01-Jan-2022 00:00:00   01-Jan-2022 04:00:00   01-Jan-2022 08:00:00   01-Jan-2022 12:00:00

calmonths 및 calweeks 함수로 2022년 1월 1일 오후 12시를 나타내는 datetime형 값에 달력상의 월수 3개월과 달력상의 주수 2주를 추가하여 calendarDuration형 값을 만듭니다. 결과는 2022년 4월 15일 오후 12시를 나타내는 datetime형 값입니다.

d = datetime("01-Jan-2022 12:00:00");
d = d + calmonths(3) + calweeks(2)

d = datetime
   15-Apr-2022 12:00:00

참고 항목

datetime | dateshift | datevec | duration | calendarDuration | eomday

도움말 항목

• 날짜/시간 시퀀스 생성하기
• datetime형 배열의 날짜/시간 성분 추출 또는 할당하기
• 별도의 변수에서 날짜/시간 결합하기
• 날짜/시간 산술 연산