calmonths

달력 기간(단위: 월)

페이지 내 모두 축소

구문

M = calmonths(X)

설명

calmonths 함수는 달력상의 월수를 나타내는 배열을 반환합니다. 달력 계산에 calendarDuration 데이터형이 있는 배열을 사용하는 경우 이 계산은 윤년, 일광 절약 시간제 변동, 그리고 월의 길이가 다른 것을 고려합니다. 고정된 길이의 시간을 포함하는 계산의 경우 duration 데이터형을 사용하십시오.

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

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

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

예제

예제

모두 축소

라이브 스크립트 열기
X = magic(4);
M = calmonths(X)
M = 4×4 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 = 1×3 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 = 1×3 datetime
   28-Feb-2021   28-Mar-2021   28-Apr-2021

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

D2 = dateshift(D2,'end','month')
D2 = 1×3 datetime
   28-Feb-2021   31-Mar-2021   30-Apr-2021
라이브 스크립트 열기

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

X = calmonths(15:17) + caldays(8) + hours(1.2345)
X = 1×3 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에 개발됨

참고 항목

| | |

도움말 항목