Main Content

이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

datenum

날짜/시간을 날짜 일련 번호 값(Serial Date Number)으로 변환

설명

예제

참고

날짜 일련 번호 값으로 날짜와 시간을 나타낼 수 있지만, 특정 시점을 나타낼 때는 datetime 값을 사용하고 경과 시간을 나타낼 때는 duration 또는 calendarDuration 값을 사용하는 것이 좋습니다.

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
   03-Aug-2020 20:28:27
   04-Aug-2020 00:00:00

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

   7.380068531014156
   7.380070000000000

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 이전에 개발됨