Main Content

calmonths

달력 기간(단위: 월)

설명

예제

M = calmonths(X)X의 값을 달력상의 월수(calendar months)로 나타내는 배열을 반환합니다.

  • X가 숫자형 배열이면 McalendarDuration형 배열입니다. 이 배열의 각 요소는 대응하는 X 요소의 달력상의 월수를 나타냅니다.

  • XcalendarDuration형 배열이면, Mdouble형 배열입니다. 이 배열의 각 요소는 대응하는 X 요소의 달력상의 온전한 월수(whole calendar months)를 나타냅니다.

calmonths 함수는 달력 계산에 사용될 때 월의 길이가 다른 것을 고려할 수 있는 월을 생성합니다.

예제

모두 축소

X = magic(4);
M = calmonths(X)
M = 4x4 calendarDuration
   1y 4mo      2mo      3mo   1y 1mo
      5mo     11mo     10mo      8mo
      9mo      7mo      6mo       1y
      4mo   1y 2mo   1y 3mo      1mo

날짜 성분이 1월의 마지막 날인 datetime형 값을 생성합니다.

D = datetime('2021-01-31')
D = datetime
   31-Jan-2021

calmonths 함수를 사용하여 달력상의 월수로 구성된 배열을 D에 더합니다. 2월은 1월보다 일수가 적고 2021년이 윤년도 아니므로, 1월 31일에 달력상의 한 달을 더하면 당연히 2월 28일이라는 날짜를 얻게 됩니다.

D = D + calmonths(0:2)
D = 1x3 datetime
   31-Jan-2021   28-Feb-2021   31-Mar-2021

이제 날짜 성분이 2월의 마지막 날인 datetime형 값을 생성합니다.

D2 = datetime('2021-02-28')
D2 = datetime
   28-Feb-2021

달력상의 월들은 길이가 각각 다릅니다. 하지만 어쨌든 3월과 4월은 2월보다 일수가 많습니다. 따라서, 달력상의 월수를 2월 28일에 더하면 3월 28일과 4월 28일이라는 날짜를 얻게 됩니다.

D2 = D2 + calmonths(0:2)
D2 = 1x3 datetime
   28-Feb-2021   28-Mar-2021   28-Apr-2021

D2가 월 마지막 날짜 값을 갖도록 하려면 dateshift 함수를 사용하십시오.

D2 = dateshift(D2,'end','month')
D2 = 1x3 datetime
   28-Feb-2021   31-Mar-2021   30-Apr-2021

달력 기간으로 구성된 배열을 만듭니다. 그런 다음, 각 값을 달력상의 온전한 월수(whole calendar months) 값으로 변환합니다.

X = calmonths(15:17) + caldays(8) + hours(1.2345)
X = 1x3 calendarDuration
   1y 3mo 8d 1h 14m 4.2s   1y 4mo 8d 1h 14m 4.2s   1y 5mo 8d 1h 14m 4.2s

M = calmonths(X)
M = 1×3

    15    16    17

입력 인수

모두 축소

입력 배열로, 숫자형 배열, calendarDuration형 배열, 논리형 배열 중 하나로 지정됩니다. X가 숫자형 배열이면 정수 값만 포함해야 합니다. 즉, 소수 달력 단위를 만들 수 없습니다.

확장 기능

스레드 기반 환경
MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

버전 내역

R2014b에 개발됨