Main Content

datenum

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

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

설명

예제

DateNumber = datenum(t)는 입력 배열 tdatetime형 또는 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를 사용하여 연도를 명시하는 두 문자로 된 텍스트를 해석합니다. formatInPivotYear는 순서에 관계없이 지정할 수 있습니다.

예제

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

예제

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

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

예제

모두 축소

format long 

t = [datetime('now');datetime('tomorrow')]
t = 2x1 datetime
   14-Aug-2023 23:33:26
   15-Aug-2023 00:00:00

DateNumber = datenum(t)
DateNumber = 2×1
105 ×

   7.391129815541299
   7.391130000000000

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

입력 인수

모두 축소

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

데이터형: datetime | duration

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

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

데이터형: double

날짜/시간을 나타내는 텍스트로, 각 행이 특정 시점을 나타내는 텍스트를 포함하는 문자형 배열로 지정되거나 문자형 벡터로 구성된 셀형 배열 또는 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월로, 연은 현재 연도로 합니다. datevecdatenum은 2자로 된 연도(예: '79')를 현재 연도를 중심으로 100년 범위 내에 해당하는 것으로 간주합니다.

formatIn을 지정하지 않은 경우 다음에 주의합니다.

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

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

날짜/시간을 나타내는 입력 텍스트 형식으로, 기호 식별자로 구성된 문자형 벡터나 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

2자리 숫자로 된 월

03, 12

m

첫 대문자 문자를 사용한 월

M, D

dddd

전체 이름을 사용한 요일

Monday, Tuesday

ddd

처음 세 문자를 사용한 요일

Mon, Tue

dd

2자리 숫자로 된 날짜

05, 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는 단독으로 사용하거나 연도 지정자와 함께 사용할 수 있습니다.

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

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

예: 2000

참고

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

데이터형: double

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

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

예: 2003,10,24

데이터형: double

연, 월, 일, 시, 분, 초 배열로, 숫자형 배열로 지정됩니다. 어떤 값이든 스칼라일 수 있으며, 배열인 경우 서로 크기가 동일해야 합니다. 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

출력 인수

모두 축소

날짜 일련 번호 값으로, 길이가 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

확장 기능

버전 내역

R2006a 이전에 개발됨

모두 확장