calyears

달력 기간(단위: 연)

구문

Y = calyears(X)

설명

calyears 함수는 달력상의 연수를 나타내는 배열을 반환합니다. 달력 계산에 calendarDuration 데이터형이 있는 배열을 사용하는 경우 이 계산은 윤년, 일광 절약 시간제 변동, 그리고 월의 길이가 다른 것을 고려합니다. 정확한 고정 길이의 연수를 대신 생성하려면 years 함수를 사용하십시오. 고정 길이의 1년은 365.2425일입니다.

Y = calyears(X)는 X의 값을 달력상의 연수(calendar years)로 나타내는 배열을 반환합니다.

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

• X가 calendarDuration형 배열이면, calyears는 X 요소의 달력상의 온전한 연수(whole calendar years)를 반환합니다.

예제

달력상의 연수로 구성된 배열 생성

X = magic(4);
Y = calyears(X)

Y = 4×4 calendarDuration
   16y    2y    3y   13y
    5y   11y   10y    8y
    9y    7y    6y   12y
    4y   14y   15y    1y

달력 기간을 달력상의 연수로 변환

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

X = calmonths(21:25) + caldays(8)

X = 1×5 calendarDuration
    1y 9mo 8d   1y 10mo 8d   1y 11mo 8d        2y 8d    2y 1mo 8d

Y = calyears(X)

Y = 1×5

     1     1     1     2     2

입력 인수

X — 입력 배열

숫자형 배열 | calendarDuration형 배열 | 논리형 배열

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

출력 인수

Y — 달력상의 연수

스칼라 | 벡터 | 행렬 | 다차원 배열

달력상의 연수(calendar years)로, 스칼라, 벡터, 행렬, 다차원 배열 중 하나로 반환됩니다. Y는 X와 크기가 동일합니다. Y의 데이터형은 X에 따라 달라집니다.

• X가 숫자형 배열이면, Y는 X 요소의 달력상의 연수를 나타내는, 가변 길이의 calendarDuration형 배열입니다.

• X가 calendarDuration형 배열이면, Y는 X 요소의 달력상의 온전한 연수(whole calendar years)를 나타내는, 정수 값으로 구성된 double형 배열입니다.

팁

• calyears는 달력 계산에 사용될 때 윤일(Leap Day)을 고려한 연수를 생성합니다. 정확한 고정 길이(365.2425일)의 연수를 만들려면 years 함수를 사용하십시오.

확장 기능

tall형 배열

메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

calyears 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

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

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

이 함수는 분산 배열을 완전히 지원합니다. 자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2014b에 개발됨

참고 항목

calendarDuration | years | calmonths