Main Content

caldiff

달력의 수학적 연속 차분

설명

예제

dt = caldiff(t)t의 인접한 datetime형 값 사이의 시간 차이를 달력 성분인 연도, 월, 일, 시간 측면에서 계산합니다. caldiff는 크기가 1이 아닌 첫 번째 배열 차원을 따라 차분을 계산합니다.

  • t가 길이가 m인 벡터인 경우 dt = caldiff(t)는 길이가 m-1인 벡터를 반환합니다. dt의 요소는 t의 인접 요소 간의 차분입니다.

    dt = [between(t(1),t(2)), between(t(2),t(3)),..., between(t(m-1),t(m))]
  • t가 벡터가 아닌 p×m 행렬인 경우 dt = caldiff(t)는 크기가 (p-1)×m인 행렬을 반환합니다. 이 행렬의 요소는 t의 행 간의 차분입니다.

    dt(:,I) = [between(t(1,I),t(2,I), between(t(2,I),t(3,I)), ..., 
    between(t(p-1,I),t(p,I))]

예제

dt = caldiff(t,components)t의 연속된 datetime형 값 사이의 차분을 지정된 달력 또는 시간 성분의 측면에서 구합니다.

dt = caldiff(t,components,dim)dim으로 지정된 차원을 따라 연속된 datetime형 값 사이의 차분을 구합니다.

예제

모두 축소

datetime형 배열을 만든 다음 값 사이의 차분을 달력 성분으로 계산합니다.

t = [datetime('yesterday');datetime('today');datetime('tomorrow')]
t = 3x1 datetime
   24-Jan-2024
   25-Jan-2024
   26-Jan-2024

D = caldiff(t)
D = 2x1 calendarDuration
   1d
   1d

datetime형 배열을 만든 다음 값 사이의 차분을 일수로 계산합니다.

t = datetime('now') + calmonths(0:3)
t = 1x4 datetime
   25-Jan-2024 22:20:09   25-Feb-2024 22:20:09   25-Mar-2024 22:20:09   25-Apr-2024 22:20:09

D = caldiff(t,'days')
D = 1x3 calendarDuration
   31d   29d   31d

datetime형 값 사이의 차분을 주수와 일수로 계산합니다.

D = caldiff(t,{'weeks','days'})
D = 1x3 calendarDuration
   4w 3d   4w 1d   4w 3d

입력 인수

모두 축소

날짜/시간 입력값으로, datetime형 배열로 지정됩니다.

달력 또는 시간 성분으로, 다음 문자형 벡터 중 하나 또는 다음 문자형 벡터가 하나 이상 포함된 셀형 배열 또는 string형 배열로 지정됩니다.

  • 'years'

  • 'quarters'

  • 'months'

  • 'weeks'

  • 'days'

  • 'time'

위의 성분 중 'time'을 제외한 나머지는 가변 길이의 시간입니다. 예를 들어, 1month는 1월의 날짜/시간에 더했을 때와 2월의 날짜/시간에 더했을 때 다른 시간 길이를 나타냅니다.

caldiff는 달력 또는 시간 성분에 대해 가장 큰 성분부터 시작하여 내림차순으로 동작을 수행합니다.

일반적으로, components'time'을 포함하지 않는 한 t(2:m)t(1:m-1) + dt와 같지 않습니다.

예: {'years','quarters'}

데이터형: char | cell | string

연산을 수행할 차원으로, 양의 정수로 지정됩니다. 값이 지정되지 않은 경우 디폴트는 크기가 1이 아닌 첫 번째 배열 차원입니다.

출력 인수

모두 축소

차분 배열로, 스칼라, 벡터, 행렬, 다차원 calendarDuration형 배열 중 하나로 반환됩니다.

  • t1t2의 datetime형 값 사이의 연속 차분을 시간, 분, 초의 정확한 고정 길이 단위로 계산하려면 diff(t)를 사용하십시오.

확장 기능

버전 내역

R2014b에 개발됨

참고 항목

| | |