NaT

Not-a-Time

구문

NaT

t = NaT(n)

t = NaT(sz1,...,szN)

t = NaT(sz)

t = NaT(___,'Format',fmt)

t = NaT(___,'TimeZone',tz)

설명

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

datetime 함수는 텍스트를 datetime형 값으로 변환할 수 없는 경우 또는 datetime형 배열 요소의 Year, Month, Day, Hour, Minute 또는 Second 속성이 NaN으로 설정된 경우 자동으로 NaT 값을 생성합니다. 기존 datetime형 배열의 요소에 missing 값을 할당할 수도 있습니다. 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)는 크기 벡터 sz가 size(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 정사각 행렬

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

t = NaT(3)

t = 3×3 datetime
   NaT   NaT   NaT
   NaT   NaT   NaT
   NaT   NaT   NaT

datetime형 사각형 배열 초기화 및 형식 지정하기

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

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

t = 2×3 datetime
   NaT   NaT   NaT
   NaT   NaT   NaT

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

t(1,2) = datetime('today')

t = 2×3 datetime
   NaT          13/07/2025   NaT       
   NaT          NaT          NaT       

입력 인수

n — 정사각 행렬의 크기

정수

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

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

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

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

sz1,...,szN — 각 차원의 크기(개별 인수)

정수 값

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

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

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

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

sz — 각 차원의 크기(행 벡터)

정수 값

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

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

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

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

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

fmt — 날짜 형식

'default' (디폴트 값) | 'defaultdate' | 문자형 벡터 | string형 스칼라

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

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

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

예: 'yyyy MMM dd'

데이터형: char | string

tz — 표준 시간대 지역

'' (디폴트 값) | 문자형 벡터 | 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++ 코드를 생성할 수 있습니다.

스레드 기반 환경

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

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

버전 내역

R2015b에 개발됨

참고 항목

isnat | datetime | NaN | leapseconds