datenum

(권장되지 않음, datetime 또는 duration 사용) 날짜/시간을 날짜 일련 번호 값으로 변환

datenum은 권장되지 않습니다. 특정 시점을 나타내려면 datetime 배열을 사용하십시오. 경과 시간을 나타내려면 duration형 배열이나 calendarDuration형 배열을 사용하십시오. 코드 업데이트에 대한 자세한 내용은 버전 내역 또는 Replace Discouraged Instances of Serial Date Numbers and Date Strings 항목을 참조하십시오.

구문

DateNumber = datenum(t)

DateNumber = datenum(DateString)

DateNumber = datenum(DateString,formatIn)

DateNumber = datenum(DateString,PivotYear)

DateNumber = datenum(DateString,formatIn,PivotYear)

DateNumber = datenum(DateVector)

DateNumber = datenum(Y,M,D)

DateNumber = datenum(Y,M,D,H,MN,S)

설명

DateNumber = datenum(t)는 입력 배열 t에 있는 datetime형 값 또는 duration형 값을 날짜 일련 번호 값으로 변환합니다.

날짜 일련 번호 값은 역산 ISO 달력의 미리 설정된 고정 날짜(January 0, 0000)로부터의 일수를 정수 및 소수로 나타냅니다.

DateNumber = datenum(DateString)은 날짜/시간을 나타내는 텍스트를 날짜 일련 번호 값으로 변환합니다. 텍스트에 사용된 형식을 미리 알고 있는 경우에는 형식을 formatIn으로 지정하십시오. formatIn이 지정되지 않은 구문은 formatIn이 포함된 구문보다 상당히 느립니다.

DateNumber = datenum(DateString,formatIn)은 formatIn을 사용하여 DateString으로 표현된 시간/날짜를 해석합니다.

DateNumber = datenum(DateString,PivotYear)는 연도를 명시하는 두 자리 텍스트를 PivotYear를 기준으로 사용하여 해석합니다. 텍스트에 사용된 형식을 미리 알고 있는 경우에는 형식을 formatIn으로 지정하십시오. formatIn이 지정되지 않은 구문은 formatIn이 포함된 구문보다 상당히 느립니다.

DateNumber = datenum(DateString,formatIn,PivotYear)는 formatIn을 사용하여 DateString으로 표현된 날짜/시간을 해석하고, 연도를 명시하는 두 자리 텍스트를 PivotYear를 기준으로 사용하여 해석합니다. formatIn과 PivotYear는 순서에 관계없이 지정할 수 있습니다.

DateNumber = datenum(DateVector)는 날짜 벡터를 날짜 일련 번호 값으로 변환하고 m개의 날짜 번호 값으로 구성된 열 벡터를 반환합니다. 여기서 m은 DateVector의 총 날짜 벡터 개수입니다.

DateNumber = datenum(Y,M,D)는 Y, M, D(연, 월, 일) 배열의 대응하는 요소에 대한 날짜 일련 번호 값을 반환합니다. 어떤 값이든 스칼라일 수 있으며, 배열인 경우 서로 크기가 동일해야 합니다. 입력 인수를 날짜 벡터 [Y,M,D]로 지정할 수도 있습니다.

DateNumber = datenum(Y,M,D,H,MN,S)는 H, MN, S(시, 분, 초) 배열의 대응하는 요소에 대한 날짜 일련 번호 값을 추가로 반환합니다. 어떤 값이든 스칼라일 수 있으며, 배열인 경우 서로 크기가 동일해야 합니다. 입력 인수를 날짜 벡터 [Y,M,D,H,MN,S]로 지정할 수도 있습니다.

예제

datetime형 배열을 날짜 번호 값으로 변환하기

format long 

t = [datetime('now');datetime('tomorrow')]

t = 2×1 datetime
   13-Jul-2025 18:34:02
   14-Jul-2025 00:00:00

DateNumber = datenum(t)

DateNumber = 2×1
105 ×

   7.398117736392009
   7.398120000000000

날짜를 나타내는 텍스트를 날짜 번호 값으로 변환하기

DateString = '19-May-2001';
formatIn = 'dd-mmm-yyyy';
datenum(DateString,formatIn)

ans = 
730990

datenum은 'dd-mmm-yyyy' 형식을 사용하여 날짜를 나타낸 텍스트에 대한 날짜 번호 값을 반환합니다.

여러 날짜가 포함된 텍스트를 날짜 번호 값으로 변환하기

몇몇 날짜를 셀형 배열에 포함된 문자형 벡터로 전달합니다. 모든 입력 날짜는 형식이 동일해야 합니다.

DateString = {'09/16/2007';'05/14/1996';'11/29/2010'};
formatIn = 'mm/dd/yyyy';
datenum(DateString,formatIn)

ans = 3×1

      733301
      729159
      734471

피벗 연도를 사용하여 날짜를 나타내는 텍스트를 날짜 번호 값으로 변환하기

디폴트 피벗 연도를 사용하여 날짜를 나타내는 텍스트를 날짜 일련 번호 값으로 변환합니다.

n = datenum('12-jun-17','dd-mmm-yy')

n = 
736858

이 날짜 번호 값을 나타내는 텍스트는 '12-Jun-2017'입니다.

1400을 피벗 연도로 사용하여 동일한 텍스트를 날짜 일련 번호 값으로 변환합니다.

n = datenum('12-jun-17','dd-mmm-yy',1400)

n = 
517712

이 날짜 번호 값을 나타내는 텍스트는 '12-Jun-1417'입니다.

날짜 벡터를 날짜 번호 값으로 변환하기

datenum([2009,4,2,11,7,18])

ans = 
7.3387e+05

연, 월, 일을 날짜 번호 값으로 변환하기

연, 월, 일 값으로 지정된 날짜를 날짜 일련 번호 값으로 변환합니다.

n = datenum(2001,12,19)

n = 
731204

입력 인수

t — 날짜/시간

datetime형 값 또는 duration형 값으로 구성된 배열

날짜/시간으로, datetime형 값 또는 duration형 값으로 구성된 배열로 지정됩니다. datenum 함수는 t의 표준 시간대 정보를 고려하지 않으며 일광 절약 시간제 동안 발생하는 datetime형 값을 조정하지 않습니다. 즉, datenum은 datetime형 배열의 TimeZone 속성을 빈 항목으로 처리하고 나머지 날짜/시간 정보를 날짜 일련 번호 값으로 변환합니다.

t의 요소가 NaT 또는 NaN인 경우 datenum에서 반환된 대응하는 값은 NaN이 됩니다. t의 요소가 Inf 또는 -Inf인 경우 datenum에서 반환된 대응하는 값은 Inf 또는 -Inf가 됩니다.

데이터형: datetime | duration

DateVector — 날짜 벡터

행렬

날짜 벡터로, m 전체 날짜 벡터 또는 부분 날짜 벡터를 각각 포함하는 m×6 또는 m×3 행렬로 지정됩니다. 전체 날짜 벡터는 연, 월, 일, 시, 분, 초를 순서대로 지정하는 6개 요소를 가집니다. 부분 날짜 벡터는 연, 월, 일을 순서대로 지정하는 3개 요소를 가집니다. DateVector의 각 요소는 양의 정수 값이나 음의 정수 값이어야 합니다(단, 초를 나타내는 요소는 예외적으로 소수일 수 있음). 요소가 정상 범위를 벗어나는 경우 datenum은 날짜 벡터 요소와 이전 요소를 모두 조정합니다. 예를 들어, 분 요소가 70인 경우 datenum은 시간 요소를 1로 조정하고 분 요소를 10으로 설정합니다. 분 요소가 -15인 경우 datevec은 시간 요소를 1 감소시키고 분 요소를 45로 설정합니다. 월 값은 예외입니다. datenum 함수는 1보다 작은 월 값은 1로 설정합니다.

DateVector의 요소가 NaT 또는 NaN인 경우 datenum에서 반환된 대응하는 값은 NaN이 됩니다. DateVector의 요소가 Inf 또는 -Inf인 경우 datenum에서 반환된 대응하는 값은 Inf 또는 -Inf가 됩니다.

예: [2003,10,24,12,45,07]

데이터형: double

DateString — 날짜/시간을 나타내는 텍스트

문자형 배열 | 문자형 벡터로 구성된 셀형 벡터 | string형 벡터

날짜/시간을 나타내는 텍스트로, 문자형 배열로 지정되거나(이 경우 각 행이 특정 시점을 나타내는 텍스트를 포함함), 문자형 벡터로 구성된 셀형 벡터 또는 string형 벡터로 지정됩니다. 문자형 배열의 모든 행, 또는 셀형 벡터나 string형 벡터의 모든 요소는 형식이 동일해야 합니다.

예: '24-Oct-2003 12:45:07'

예: ['19-Sep-2013';'20-Sep-2013';'21-Sep-2013']

예: {'15-Oct-2010' '20-Nov-2012'}

텍스트에 사용된 형식을 알 수 있는 경우에는 formatIn도 지정해야 합니다. formatIn을 지정하지 않으면 DateString은 다음 형식 중 하나여야 합니다.

날짜/시간을 나타내는 텍스트 형식	예
'dd-mmm-yyyy HH:MM:SS'	01-Mar-2000 15:45:17
'dd-mmm-yyyy'	01-Mar-2000
'mm/dd/yyyy'	03/01/2000
'mm/dd/yy'	03/01/00
'mm/dd'	03/01
'mmm.dd,yyyy HH:MM:SS'	Mar.01,2000 15:45:17
'mmm.dd,yyyy'	Mar.01,2000
'yyyy-mm-dd HH:MM:SS'	2000-03-01 15:45:17
'yyyy-mm-dd'	2000-03-01
'yyyy/mm/dd'	2000/03/01
'HH:MM:SS'	15:45:17
'HH:MM:SS PM'	3:45:17 PM
'HH:MM'	15:45
'HH:MM PM'	3:45 PM

참고

날짜/시간 형식을 설명하는 기호 식별자는 datetime형 배열의 표시 형식을 설명하는 기호 식별자와 다릅니다.

일부 형식은 날짜/시간을 나타낸 텍스트를 변환하는 데 필요한 정보가 충분하지 않을 수 있습니다. 그런 경우에는 기본적으로 시, 분, 초는 0으로 설정되고, 일은 1로, 월은 1월로, 연은 현재 연도로 설정됩니다. datevec 및 datenum은 두 자리 연도(예: '79')를 현재 연도를 기준으로 100년 범위 내에 해당하는 것으로 간주합니다.

formatIn을 지정하지 않는 경우 다음 사항에 주의하십시오.

• 월을 2자리 숫자로 지정하는 형식(mm)의 경우 월 값은 12보다 커서는 안 됩니다.

• 그러나 'mm/dd/yy' 형식의 경우, 텍스트의 첫 번째 항목이 12보다 크고 두 번째 항목이 12보다 작거나 같으면 datenum은 이 텍스트를 'yy/mm/dd' 형식으로 간주합니다.

formatIn — 날짜/시간을 나타내는 입력 텍스트 형식

문자형 벡터 | string형 스칼라

날짜/시간을 나타내는 입력 텍스트 형식으로, 기호 식별자로 구성된 문자형 벡터나 string형 스칼라로 지정됩니다.

예: 'dddd, mmm dd, yyyy'

다음 표는 formatIn 문자형 벡터를 생성하는 데 사용할 수 있는 기호 식별자를 보여줍니다. 하이픈, 공백 또는 콜론과 같은 문자를 포함하여 필드를 구분할 수 있습니다.

참고

날짜/시간 형식을 설명하는 기호 식별자는 datetime형 배열의 표시 형식을 설명하는 기호 식별자와 다릅니다.

기호 식별자	설명	예
yyyy	전체 연도	1990, 2002
yy	2자리 숫자로 된 연도	90, 02
QQ	Q 문자와 1자리 숫자를 사용한 한 해의 사분기	Q1
mmmm	전체 이름을 사용한 월	March, December
mmm	처음 세 자리 문자를 사용한 월	Mar, Dec
mm	1자리나 2자리 숫자로 된 월	3, 06, 12
m	첫 대문자 문자를 사용한 월	M, D
dddd	전체 이름을 사용한 요일	Monday, Tuesday
ddd	처음 세 문자를 사용한 요일	Mon, Tue
dd	1자리나 2자리 숫자로 된 날짜	5, 09, 20
d	첫 대문자 문자를 사용한 요일	M, T
HH	2자리 숫자로 된 시간 (기호 식별자 AM 또는 PM을 사용하는 경우 앞에 0 표시 안 됨)	05, 5 AM
MM	2자리 숫자로 된 분	12, 02
SS	2자리 숫자로 된 초	07, 59
FFF	3자리 숫자로 된 밀리초	057
AM or PM	시간을 나타내는 텍스트에 삽입되는 AM이나 PM	3:45:02 PM

formatIn 값은 다음 지침을 준수해야 합니다.

• 필드를 두 번 이상 지정할 수 없습니다. 예를 들어, 'yy-mmm-dd-m'은 월 식별자가 두 개이므로 사용할 수 없습니다. 예외적으로 dd의 한 인스턴스를 다른 일 식별자의 한 인스턴스와 결합시킬 수 있습니다. 예를 들어, 'dddd mmm dd yyyy'는 유효한 입력값입니다.

• AM 또는 PM을 사용하는 경우 HH 필드도 필요합니다.

• QQ는 단독으로 사용하거나 연도 지정자와 함께 사용할 수 있습니다.

PivotYear — 100년 날짜 범위의 시작 연도

현재 연도 - 50년 (디폴트 값) | 정수

100년 날짜 범위의 시작 연도로, 두 문자로 된 연도가 여기에 속하게 되며, 정수로 지정됩니다. 피벗 연도를 사용하여, 연도를 명시하는 두 문자로 된 날짜를 해석합니다.

formatIn에 날짜의 시간이 포함되어 있는 경우 피벗 연도는 현재 일, 월, 연의 현재 시간에서부터 계산합니다. 그렇지 않은 경우에는 현재 일, 월, 연의 자정에서부터 계산합니다.

예: 2000

참고

입력 날짜 형식이 네 문자로 된 연도를 명시하는 경우 마지막 두 문자는 잘리고 처음 두 문자로 연도가 명시됩니다. 예를 들어, 날짜와 피벗 연도가 ('25122015','ddmmyyyy',2000)으로 지정된 경우 결과로 생성되는 날짜는 25-12-2015가 아니라 25-12-2020입니다.

데이터형: double

Y,M,D — 연, 월, 일 배열

숫자형 배열

연, 월, 일 배열로, 숫자형 배열로 지정됩니다. 어떤 값이든 스칼라일 수 있으며, 배열인 경우 서로 크기가 동일해야 합니다. Y,M,D의 값은 정수 값이어야 합니다.

Y,M,D가 모두 스칼라이거나 모두 열 벡터인 경우 입력 인수를 날짜 벡터 [Y,M,D]로 지정할 수 있습니다.

예: 2003,10,24

데이터형: double

Y,M,D,H,MN,S — 연, 월, 일, 시, 분, 초 배열

숫자형 배열

연, 월, 일, 시, 분, 초 배열로, 숫자형 배열로 지정됩니다. 어떤 값이든 스칼라일 수 있으며, 배열인 경우 서로 크기가 동일해야 합니다. datenum은 밀리초를 개별 입력값으로 받지 않고 초 입력값 S의 소수부로 받습니다. Y,M,D,H,MN의 값은 정수 값이어야 합니다.

Y,M,D,H,MN,S가 모두 스칼라이거나 모두 열 벡터인 경우 입력 인수를 날짜 벡터 [Y,M,D,H,MN,S]로 지정할 수 있습니다.

예: 2003,10,24,12,45,07.451

데이터형: double

출력 인수

DateNumber — 날짜 일련 번호 값

스칼라 | 벡터

날짜 일련 번호 값으로, 길이가 m인 열 벡터로 반환됩니다. 여기서 m은 입력 날짜 벡터나 날짜/시간을 나타내는 문자형 벡터의 총 개수입니다.

팁

• 출력값을 원하는 형태로 만들려면 datenum(Y,M,D) 구문과 datenum(Y,M,D,H,MN,S) 구문을 사용하십시오. datenum(DateVector) 구문은 날짜 번호 값으로 구성된 열 벡터만 생성합니다.

  datenum(2013,[1 3; 2 4],ones(2,2))

  ans =
  
        735235      735294
        735266      735325

확장 기능

tall형 배열

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

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

스레드 기반 환경

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

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

분산 배열

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

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

버전 내역

R2006a 이전에 개발됨

R2022b: 권장되지 않음

datenum을 제거할 계획은 없습니다. 하지만 그 대신 datetime, duration, calendarDuration 데이터형이 권장됩니다. datetime 데이터형은 유연한 날짜/시간 형식과 나노초 정밀도로 표현하기 위한 저장공간, 표준 시간대와 일광 절약 시간제를 고려하기 위한 속성을 제공합니다. 날짜 일련 번호 값을 입력값으로 받는 MATLAB^® 함수는 datetime형 배열도 입력값으로 받습니다.

날짜 일련 번호 값을 datetime형 값으로 변환하려면 ConvertFrom 이름-값 인수를 "datenum"으로 설정하여 datetime을 호출하십시오.

d = 738522;
d = datetime(d,"ConvertFrom","datenum")

d = datetime
   01-Jan-2022

참고 항목

datetime | datevec

도움말 항목

• MATLAB에서 날짜/시간 표시하기
• 날짜 벡터와 날짜 문자열의 이월