Main Content

NaT

설명

NaT는 Not-a-Time에 대한 표현으로, datetime형 배열에 알 수 없는 값이나 누락값을 나타내는 datetime형을 저장할 때 사용할 수 있는 값입니다.

datetime 함수는 텍스트를 datetime형 값으로 변환할 수 없는 경우 또는 datetime형 배열 요소의 Year, Month, Day, Hour, Minute 또는 Second 속성이 NaN으로 설정된 경우 자동으로 NaT 값을 생성합니다. 기존 datetime형 배열의 요소에 문자형 벡터 'NaT'를 할당할 수도 있습니다. NaT 값만 포함하는 새 datetime형 배열을 만들려면 NaT 함수를 사용합니다.

예제

NaT는 스칼라 Not-a-Time(NaT) datetime형 값을 반환합니다.

t = NaT(n)NaT 값으로 구성된 n×n 행렬을 반환합니다.

t = NaT(sz1,...,szN)NaT 값으로 구성된 sz1×...×szN 배열을 반환합니다. 여기서 sz1,...,szN은 각 차원의 크기를 나타냅니다. 예를 들어, NaT(3,4)NaT 값으로 구성된 3×4 배열을 반환합니다.

t = NaT(sz)는 크기 벡터 szsize(t)를 정의하는 NaT 값으로 구성된 배열을 반환합니다. 예를 들어, NaT([3,4])NaT 값으로 구성된 3×4 배열을 반환합니다.

예제

t = NaT(___,'Format',fmt)는 지정된 표시 형식의 datetime형 배열을 반환합니다. 이 구문을 사용하여 datetime형 배열을 초기화합니다. Not-a-Time 값은 항상 NaT로 표시되지만 배열에서 NaT가 아닌 값은 지정된 형식을 사용하여 표시됩니다.

t = NaT(___,'TimeZone',tz)tz로 지정된 표준 시간대의 NaT 값으로 구성된 배열을 반환합니다.

예제

모두 축소

NaT 값으로 구성된 3×3 행렬을 만듭니다.

t = NaT(3)
t = 3x3 datetime
   NaT   NaT   NaT
   NaT   NaT   NaT
   NaT   NaT   NaT

NaT 값으로 구성된 2×3 배열을 만들고 날짜 형식을 지정합니다.

t = NaT(2,3,'Format','dd/MM/yyyy')
t = 2x3 datetime
   NaT   NaT   NaT
   NaT   NaT   NaT

t의 요소에 datetime형 값을 할당합니다.

t(1,2) = datetime('today')
t = 2x3 datetime
   NaT          25/01/2024   NaT       
   NaT          NaT          NaT       

입력 인수

모두 축소

정사각 행렬의 크기로, 정수로 지정됩니다.

  • n0이면 t는 빈 행렬이 됩니다.

  • n이 음수이면 0으로 처리됩니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

각 차원의 크기로, 정수 값으로 구성된 개별 인수로 지정됩니다.

  • 크기가 0인 차원이 있을 경우 t는 빈 배열이 됩니다.

  • 크기가 음수인 차원이 있을 경우 0으로 처리됩니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

각 차원의 크기로, 정수 값으로 구성된 행 벡터로 지정됩니다. 이 벡터의 요소는 각각 해당하는 차원의 크기를 나타냅니다.

  • 크기가 0인 차원이 있을 경우 t는 빈 배열이 됩니다.

  • 크기가 음수인 차원이 있을 경우 0으로 처리됩니다.

예: sz = [2,3,4]는 2×3×4 배열을 생성합니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

날짜 형식으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 문자 A-Za-z를 사용하여 형식을 정의합니다. 유효한 문자 식별자의 전체 목록을 보려면 datetime형 배열의 Format 속성을 참조하십시오.

또는 다음 문자형 벡터 중 하나를 사용하여 디폴트 형식을 지정합니다.

fmt의 값설명

'default'

디폴트 표시 형식을 사용합니다.

'defaultdate'

시간 성분 없이 생성된 datetime형 값의 디폴트 표시 형식을 사용합니다.

예: 'yyyy MMM dd'

데이터형: char | string

표준 시간대 지역으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

tz의 값은 다음이 될 수 있습니다.

  • ''. 특정 표준 시간대에 속하지 않는, “표준 시간대가 지정되지 않은” datetime형 배열을 만들려는 경우 사용합니다.

  • IANA 표준 시간대 데이터베이스에 제공된 표준 시간대 지역 이름(예: 'America/Los_Angeles'). 표준 시간대 지역의 이름은 지리적 지역에서 준수하는, UTC와의 표준 오프셋 및 일광 절약 시간제 오프셋에 대한 현재 규칙과 이전 규칙을 고려합니다.

  • +HH:mm 또는 -HH:mm 형식의 ISO 8601 문자형 벡터(예: '+01:00'). UTC와의 고정 오프셋인 표준 시간대를 지정하려는 경우 사용합니다.

  • 'UTC'. UTC(협정 세계시)의 datetime형 배열을 만들려는 경우 사용합니다.

  • 'UTCLeapSeconds'. 윤초를 고려하는 UTC(협정 세계시)의 datetime형 배열을 만들려는 경우 사용합니다. datetime 데이터형에서 지원하는 윤초 목록은 leapseconds를 참조하십시오.

  • 'local'. 시스템 표준 시간대의 datetime형 배열을 만들려는 경우 사용합니다.

다음 표에는 IANA 표준 시간대 데이터베이스에 제공된 표준 시간대 지역의 일반적인 이름이 나와 있습니다.

TimeZone의 값UTC 오프셋UTC DST 오프셋
'Africa/Johannesburg'+02:00+02:00
'America/Chicago'−06:00−05:00
'America/Denver'−07:00−06:00
'America/Los_Angeles'−08:00−07:00
'America/New_York'−05:00−04:00
'America/Sao_Paulo'−03:00−02:00
'Asia/Hong_Kong'+08:00+08:00
'Asia/Kolkata'+05:30+05:30
'Asia/Tokyo'+09:00+09:00
'Australia/Sydney'+10:00+11:00
'Europe/London'+00:00+01:00
'Europe/Zurich'+01:00+02:00

데이터형: char | string

확장 기능

C/C++ 코드 생성
MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

버전 내역

R2015b에 개발됨

참고 항목

| | |