이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.
특정 시점을 나타내는 배열
datetime
배열을 역산 ISO 달력을 사용하여 특정 시점을 나타냅니다. datetime
형 값은 최대 나노초 정밀도까지 허용되는 유연한 표시 형식을 가지며, 표준 시간대, 일광 절약 시간제, 윤초(Leap Second)를 고려하여 계산될 수 있습니다.
은 현재 날짜 및 시간을 스칼라 t
= datetimedatetime
형 배열로 반환합니다.
는 t
= datetime(relativeDay
)relativeDay
로 지정된 날짜를 사용합니다. relativeDay
입력값은 'today'
, 'tomorrow'
, 'yesterday'
, 'now'
중 하나가 될 수 있습니다.
는 시점을 나타내는 t
= datetime(DateStrings
)DateStrings
의 텍스트에서 datetime형 값으로 구성된 배열을 만듭니다.
는 t
= datetime(DateStrings
,'InputFormat',infmt
)infmt
로 지정된 형식을 사용하여 DateStrings
를 해석합니다. 입력 인수 DateStrings
의 모든 값은 형식이 동일해야 합니다.
유사한 형식 사이의 모호성을 방지하려면 'InputFormat'
과 그 대응값 infmt
를 지정하십시오.
t
의 표시 형식을 제어하려면 'Format'
이름-값 쌍 인수를 지정하거나 t
의 Format
속성을 설정하십시오.
는 t
= datetime(DateVectors
)DateVectors
의 날짜 벡터에서 datetime형 값의 열 벡터를 만듭니다.
는 t
= datetime(Y,M,D
)Y
, M
, D
(연, 월, 일) 배열의 각 요소로부터 datetime형 값으로 구성된 배열을 만듭니다. 어떤 값이든 스칼라일 수 있으며, 배열인 경우 서로 크기가 동일해야 합니다. 입력 인수를 날짜 벡터 [Y M D]
로 지정할 수도 있습니다.
는 t
= datetime(Y,M,D,H,MI,S
)H
, MI
, S
(시, 분, 초)도 포함한 배열을 만듭니다. 어떤 값이든 스칼라일 수 있으며, 모든 배열의 크기는 동일해야 합니다. 입력 인수를 날짜 벡터 [Y M D H MI S]
로 지정할 수도 있습니다.
는 t
= datetime(Y,M,D,H,MI,S,MS
)MS
(밀리초)도 배열에 추가합니다. 어떤 값이든 스칼라일 수 있으며, 모든 배열의 크기는 동일해야 합니다.
는 위에 열거된 구문의 입력 인수 외에, 이름-값 쌍의 인수를 하나 이상 사용하여 추가 옵션을 지정합니다. 예를 들어, t
= datetime(___,Name,Value
)'Format'
이름-값 쌍의 인수를 사용하여 t
의 표시 형식을 지정할 수 있습니다.
텍스트에서 datetime형 값을 생성할 때 최상의 성능을 구현하려면 'Format'
을 지정하거나 'InputFormat'
과 그 대응값 infmt
를 지정하십시오.
relativeDay
— 현재 날짜를 기준으로 한 날'yesterday'
| 'today'
| 'tomorrow'
| 'now'
현재 날짜를 기준으로 한 날로, 다음 값 중 하나로 지정됩니다.
relativeDay 의 값 | 설명 |
---|---|
'yesterday' | 전날의 날짜, 자정 |
'today' | 현재 날짜, 자정 |
'tomorrow' | 다음 날의 날짜, 자정 |
'now' | 현재 날짜와 시간 |
DateStrings
— 날짜/시간을 나타내는 텍스트날짜/시간을 나타내는 텍스트로, 문자형 배열, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다. datetime
함수는 먼저 DateStrings
의 형식을 일반적인 형식과 일치시키려고 시도합니다. 형식을 알고 있으면 'InputFormat'
과 그 대응값 infmt
를 지정하거나 'Format'
이름-값 쌍의 인수를 지정하십시오.
예: '24-Oct-2014 12:45:07'
예: {'15-Oct-2013','20-Nov-2014'}
예: ["11-Nov-2016","12-Dec-2016"]
데이터형: char
| cell
| string
infmt
— 입력 텍스트의 형식날짜/시간을 나타내는 입력 텍스트 형식으로, 다음 문자 식별자를 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.
infmt
가 날짜 지정자를 포함하지 않으면 datetime
은 DateStrings
의 값이 현재 날짜에 속하는 것으로 가정합니다.
infmt
가 시간 지정자를 포함하지 않으면 datetime
은 DateStrings
의 값이 자정에 해당하는 것으로 가정합니다.
다음 표에는 여러 가지 일반적인 입력 형식이 나와 있으며, 뉴욕 시의 날짜 2014년 4월 19일 토요일 9:41:06.12345 PM에 대해 형식이 지정된 입력값의 예를 포함합니다.
infmt 의 값 | 예제 |
---|---|
'yyyy-MM-dd' | 2014-04-19 |
'dd/MM/yyyy' | 19/04/2014 |
'dd.MM.yyyy' | 19.04.2014 |
'yyyy年 MM月
dd日' | 2014年 04月 19日 (일본어 로캘 ja_JP 의 문자) |
'MMMM d, yyyy' | April 19, 2014 |
'eeee, MMMM d, yyyy h:mm
a' | Saturday, April 19, 2014 9:41 PM |
'MMMM d, yyyy HH:mm:ss
Z' | April 19, 2014 21:41:06 -0400 |
'yyyy-MM-dd''T''HH:mmXXX' | 2014-04-19T21:41-04:00 |
'yyyy-MM-dd
HH:mm:ss.SSS' | 2014-04-19
21:41:06.123 |
소수 초(Fractional Second)를 나타내는 입력 텍스트의 경우, infmt
에 소수 초 자릿수를 나타내는 S
문자를 최대 9개까지 지정할 수 있습니다. 예를 들어, 'yyyy-MM-dd HH:mm:ss.SSS'
는 날짜/시간을 밀리초까지 나타내는 텍스트 형식입니다.
유효한 문자 식별자의 전체 목록을 보려면 datetime형 배열의 Format
속성을 참조하십시오.
참고
datetime
이 받는 문자 식별자는 datestr
함수, datenum
함수, datevec
함수가 사용하는 식별자와 다릅니다.
데이터형: char
| string
DateVectors
— 날짜 벡터날짜 벡터로, m
전체 날짜 벡터 또는 부분 날짜 벡터를 각각 포함하는 m
×6 또는 m
×3 행렬로 지정됩니다. 전체 날짜 벡터는 연, 월, 일, 시, 분, 초를 순서대로 지정하는 6개 요소를 가집니다. 부분 날짜 벡터는 연, 월, 일을 순서대로 지정하는 3개 요소를 가집니다. DateVector
의 각 요소는 양의 정수 값이나 음의 정수 값이어야 합니다(단, 초를 나타내는 요소는 예외적으로 소수일 수 있음). 요소가 정상 범위를 벗어나는 경우 datetime
은 날짜 벡터 요소와 이전 요소를 모두 조정합니다. 예를 들어, 분 요소가 70
인 경우 datetime
은 시간 요소를 1
로 조정하고 분 요소를 10
으로 설정합니다. 분 요소가 -15
인 경우 datetime
은 시간 요소를 1
감소시키고 분 요소를 45
로 설정합니다.
예: [2014 10 24 12 45 07]
예: [2014 10 24]
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
Y,M,D
— 연, 월, 일 배열연, 월, 일 배열로, 숫자형 배열로 지정됩니다. 어떤 값이든 스칼라일 수 있으며, 배열인 경우 서로 크기가 동일해야 합니다. Y,M,D
는 정수 값이어야 합니다.
Y,M,D
가 모두 스칼라이거나 모두 열 벡터인 경우 입력 인수를 날짜 벡터 [Y M D]
로 지정할 수 있습니다.
Y
, M
, D
입력값 중 하나의 요소가 정상 범위를 벗어나는 경우 datetime
은 해당 요소와 이전 입력값의 동일한 요소를 모두 조정합니다. 자세한 내용은 DateVectors
입력 인수에 대한 설명을 참조하십시오.
예: 2003,10,24
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
Y,M,D,H,MI,S
— 연, 월, 일, 시, 분, 초 배열연, 월, 일, 시, 분, 초 배열로, 숫자형 배열로 지정됩니다. 어떤 값이든 스칼라일 수 있으며, 배열인 경우 서로 크기가 동일해야 합니다. 소수 초(Fractional Second)를 초 입력 인수 S
의 일부로 지정합니다. Y,M,D,H,MI
배열은 정수 값을 포함해야 합니다.
Y,M,D,H,MI,S
가 모두 스칼라이거나 모두 열 벡터인 경우 입력 인수를 날짜 벡터 [Y M D H MI S]
로 지정할 수 있습니다.
Y
, M
, D
, H
, MI
, S
입력값 중 하나의 요소가 정상 범위를 벗어나는 경우 datetime
은 해당 요소와 이전 입력값의 동일한 요소를 모두 조정합니다. 자세한 내용은 DateVectors
입력 인수에 대한 설명을 참조하십시오.
예: 2003,10,24,12,45,07.451
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
Y,M,D,H,MI,S,MS
— 연, 월, 일, 시, 분, 초, 밀리초 배열연, 월, 일, 시, 분, 초, 밀리초 배열로, 숫자형 배열로 지정됩니다. 어떤 값이든 스칼라일 수 있으며, 배열인 경우 서로 크기가 동일해야 합니다. Y,M,D,H,MI,S
배열은 정수 값을 포함해야 합니다. MS
는 소수 밀리초를 포함할 수 있습니다.
Y
, M
, D
, H
, MI
, S
, MS
입력값 중 하나의 요소가 정상 범위를 벗어나는 경우 datetime
은 해당 요소와 이전 입력값의 동일한 요소를 모두 조정합니다. 자세한 내용은 DateVectors
입력 인수에 대한 설명을 참조하십시오.
예: 2003,10,24,12,45,07,10.52
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
X
— 숫자형 값숫자형 값으로, 배열로 지정됩니다.
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
dateType
— X
의 값 유형'datenum'
| 'excel'
| 'excel1904'
| 'juliandate'
| ...X
의 값 유형으로, 다음 값 중 하나로 지정됩니다.
|
|
---|---|
|
0-Jan-0000(0000년 1월 0일) 이후의 일수(역산 ISO 달력). |
| 0-Jan-1900(1900년 1월 0일) 이후의 일수. Excel®의 날짜 번호 값은 가장 가까운 마이크로초로 반올림됩니다. 참고: Excel은 1900년을 윤년으로 잘못 취급합니다. 따라서 Excel 날짜 번호 값을 계산할 때 1900년 2월 28일과 1900년 3월 1일 사이에 하루 단절이 있습니다. |
| 0-Jan-1904(1904년 1월 0일) 이후의 일수. Excel의 날짜 번호 값은 가장 가까운 마이크로초로 반올림됩니다. 참고: Excel은 1900년을 윤년으로 잘못 취급합니다. 따라서 Excel 날짜 번호 값을 계산할 때 1900년 2월 28일과 1900년 3월 1일 사이에 하루 단절이 있습니다. |
|
UTC 24-Nov-4714 BCE(기원전 4714년 11월 24일) 정오 이후의 일수(역산 그레고리력). 표준 시간대를 지정하지 않고 예: 뉴욕 표준 시간대를 사용하여 T = datetime(X,'ConvertFrom','juliandate',... 'TimeZone','America/New_York') 그런 다음 T.TimeZone = '' |
|
UTC 17-Nov-1858(1858년 11월 17일) 자정 이후의 일수. 표준 시간대를 지정하지 않고 예: 뉴욕 표준 시간대를 사용하여 T = datetime(X,'ConvertFrom','modifiedjuliandate',... 'TimeZone','America/New_York') 그런 다음 T.TimeZone = '' |
|
1-Jan-1970(1970년 1월 1일) 00:00:00 UTC 이후의 시간(초), 윤초(Leap Second)는 세지 않음. 표준 시간대를 지정하지 않고 예: 뉴욕 표준 시간대를 사용하여 T = datetime(X,'ConvertFrom','posixtime',... 'TimeZone','America/New_York') 그런 다음 T.TimeZone = '' |
|
YYYYMMDD 숫자형 값 형식의 날짜. 예를 들어, |
| 1-Jan-1900 00:00:00 UTC 이후의 "클록 틱" 수로, 각 클록 틱은 2^-32초입니다. |
| 1-Jan-0001 00:00:00 UTC 이후의 "클록 틱" 수 로, 각 클록 틱은 100나노초입니다. |
| 1-Jan-1601 00:00:00 UTC 이후의 "클록 틱" 수로, 각 클록 틱은 100나노초입니다. |
| Epoch 이후의 시간(초).
예: 2000년 1월 1일 이후의 일수를 반환합니다. T = datetime(X,'ConvertFrom',... 'epochtime','Epoch','2000-01-01') |
| Epoch 이후의 "클록 틱" 수.
예: 2000년 1월 1일 이후의 일수를 반환합니다. 여기서 T = datetime(X,'ConvertFrom',... 'epochtime','Epoch','2000-01-01','TicksPerSecond',1000) |
선택적으로 Name,Value
인수가 쉼표로 구분되어 지정됩니다. 여기서 Name
은 인수 이름이고 Value
는 대응값입니다. Name
은 따옴표 안에 표시해야 합니다. Name1,Value1,...,NameN,ValueN
과 같이 여러 개의 이름-값 쌍의 인수를 어떤 순서로든 지정할 수 있습니다.
'Format','eeee MMMM d, y','TimeZone','local'
은 표시 형식을 datetime형 값에 적용하고 현지 표준 시간대를 지정합니다.'Format'
— 표시 형식'default'
| 'preserveinput'
| 문자형 벡터 | string형 스칼라출력 배열에 있는 값의 표시 형식으로, 'Format'
과 함께 다음 값 중 하나가 쉼표로 구분되어 지정됩니다.
Format 의 값 | 설명 |
---|---|
|
디폴트 표시 형식을 사용합니다. |
|
입력 형식 |
문자형 벡터 또는 string형 스칼라 | 문자형 벡터 또는 string형 스칼라에 지정한 형식을 사용합니다. |
자신의 형식을 지정하려면 유효한 문자 식별자를 사용해야 합니다. 유효한 문자 식별자의 전체 목록을 보려면 Format
을 참조하십시오.
공장 초기값 형식은 시스템 로캘에 따라 다릅니다. 디폴트 표시 형식을 변경하려면 datetime형의 디폴트 형식 항목을 참조하십시오.
DateStrings
입력값을 지정한 반면 'InputFormat'
파라미터를 지정하지 않으면 datetime
은 Format
값을 사용하여 DateStrings
를 해석하려고 합니다.
예: 'Format','eeee, MMMM d, yyyy HH:mm:ss'
는 Wednesday, April 9, 2014 21:41:06
과 같이 날짜/시간을 표시합니다.
데이터형: char
| string
'Locale'
— DateStrings
의 로캘DateStrings
입력 인수 값의 로캘로, 'Locale'
과 함께 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. Locale
값에 따라 datetime
이 DateStrings
를 해석하는 방식이 결정됩니다. 하지만 출력값인 datetime
형 값이 표시되는 방식은 이에 따라 결정되지 않습니다.
Locale
값은 다음이 될 수 있습니다.
'system'
. 시스템 로캘을 지정하려는 경우 사용합니다.
형식의 문자형 벡터 또는 string형 스칼라. 여기서 xx
_YY
xx
는 언어를 지정하는 ISO 639-1 두 자리 코드(소문자)이고, YY
는 국가를 지정하는 ISO 3166-1 alpha-2 코드(대문자)입니다.
다음 표에는 로캘에 일반적으로 사용되는 일부 값이 나와 있습니다.
로캘 | 언어 | 국가 |
---|---|---|
'de_DE' | 독일어 | 독일 |
'en_GB' | 영어 | 영국 |
'en_US' | 영어 | 미국 |
'es_ES' | 스페인어 | 스페인 |
'fr_FR' | 프랑스어 | 프랑스 |
'it_IT' | 이탈리아어 | 이탈리아 |
'ja_JP' | 일본어 | 일본 |
'ko_KR' | 한국어 | 한국 |
'nl_NL' | 네덜란드어 | 네덜란드 |
'zh_CN' | 중국어(간체) | 중국 |
'Locale'
이름-값 쌍은 DateStrings
입력 인수를 사용할 때만 사용할 수 있습니다.
예: 'Locale','de_DE'
참고
Locale
값에 따라 입력 텍스트 값이 해석되는 방식이 결정됩니다. 출력값인 datetime형 값은 항상 기본 설정 패널의 날짜/시간 형식 섹션에 있는 로캘 옵션으로 지정된 언어로 표시됩니다.
표시할 디폴트 날짜/시간 로캘을 변경하려면 명령 창 기본 설정 지정하기 항목을 참조하십시오.
다른 로캘을 사용하여 datetime형 값을 텍스트로 변환하려면 char
, cellstr
또는 string
함수를 사용하십시오.
데이터형: char
| string
'PivotYear'
— 100년 날짜 범위의 시작 연도year(datetime('now'))-50
(디폴트 값) | 정수100년 날짜 범위의 시작 연도로, 두 문자로 된 연도가 여기에 속하게 되며, 'PivotYear'
와 함께 정수가 쉼표로 구분되어 지정됩니다. 피벗 연도를 사용하여, 연도를 명시하는 두 문자로 된 날짜를 해석합니다. 즉, 피벗 연도는 infmt
인수가 y
또는 yy
를 포함할 경우에만 영향을 미칩니다.
'PivotYear'
이름-값 쌍은 DateStrings
입력 인수를 사용할 때만 사용할 수 있습니다.
예: 'PivotYear',1900
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
'TimeZone'
— 표준 시간대''
(디폴트 값) | 문자형 벡터 | string형 스칼라표준 시간대로, 'TimeZone'
과 함께 표준 시간대를 지정하는 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다.
datetime
함수는 'TimeZone'
의 값을 사용하여 입력 데이터를 해석하고 출력 배열의 TimeZone
속성을 설정합니다. 입력 데이터가 표준 시간대를 포함하는 문자형 벡터 또는 string형이면 datetime
함수는 모든 값을 지정된 표준 시간대로 변환합니다.
표준 시간대에 대한 자세한 내용과 표준 시간대 목록은 TimeZone
속성을 참조하십시오.
데이터형: char
| string
Format
— 표시 형식'default'
| 문자형 벡터 | string형 스칼라표시 형식으로, 'default'
, 문자형 벡터 또는 string형 스칼라로 지정됩니다.
Format 의 값 | 설명 |
---|---|
|
디폴트 표시 형식을 사용합니다. |
문자형 벡터 또는 string형 스칼라 | 문자형 벡터 또는 string형 스칼라에 지정한 형식을 사용합니다. |
자신만의 고유한 형식을 지정하려면 날짜/시간에 Unicode® LDML(Locale Data Markup Language) 표준에 부합하는 유효한 문자 식별자를 사용해야 합니다.
예: 'eeee, MMMM d, yyyy HH:mm:ss'
는 Wednesday, April 9, 2014 21:41:06
과 같이 날짜/시간을 표시합니다.
하이픈, 공백, 콜론과 같은 비문자나 비ASCII 문자를 포함시켜 필드를 구분할 수 있습니다. 문자 A-Z
와 a-z
를 형식에 리터럴 문자로 포함하려면 문자를 작은따옴표로 묶으십시오.
예: 'uuuu-MM-dd''T''HH:mm:ss'
는 2014-04-09T21:41:06
과 같이 날짜/시간을 표시합니다.
참고
datetime
이 받는 문자 식별자는 datestr
함수, datenum
함수, datevec
함수가 사용하는 식별자와 다릅니다.
공장 초기값 형식은 시스템 로캘에 따라 다릅니다. 디폴트 표시 형식을 변경하려면 datetime형의 디폴트 형식 항목을 참조하십시오.
다음 표에는 일반 표시 형식이 나열되어 있습니다. 아래 예는 뉴욕 시의 날짜 2014년 4월 9일 수요일 9:41:06.12345 PM에 대해 형식이 지정된 출력값을 보여줍니다.
Format 의 값 | 예제 |
---|---|
'yyyy-MM-dd' | 2014-04-09 |
'dd/MM/yyyy' | 09/04/2014 |
'dd.MM.yyyy' | 09.04.2014 |
'yyyy年 MM月
dd日' | 2014年 04月 09日 (일본어 로캘 ja_JP 의 문자) |
'MMMM d, yyyy' | April 9, 2014 |
'eeee, MMMM d, yyyy h:mm
a' | Wednesday, April 9, 2014 9:41 PM |
'MMMM d, yyyy HH:mm:ss
Z' | April 9, 2014 21:41:06 -400 |
'yyyy-MM-dd''T''HH:mmXXX' | 2014-04-09T21:41-04:00 |
'yyyy-MM-dd
HH:mm:ss.SSS' | 2014-04-09
21:41:06.123 |
다음 식별자를 사용하여 날짜/시간 필드의 표시 형식을 지정할 수 있습니다. 표시 형식은 뉴욕 시의 날짜 2014년 4월 9일 수요일 오후 9:41:06.12345에 대한 출력값을 보여줍니다.
문자 식별자 | 설명 | 표시 |
---|---|---|
G | 연대 | CE |
y | 연도. 앞에 0 표시 안 됨. 이 표 다음에 나오는 참고 사항을 참조하십시오. | 2014 |
yy | 연도. 마지막 2자리 숫자 사용. 이 표 다음에 나오는 참고 사항을 참조하십시오. | 14 |
yyy , yyyy ... | 연도. 'y' 의 개수로 지정된 최소한의 자릿수 사용 | 연도 2014의 경우 'yyy' 는 2014 를 표시하는 반면 'yyyyy' 는 02014 를 표시합니다. |
u , uu , ... | ISO 연도. 연도를 지정하는 단일 숫자. ISO 연도 값은 CE 연도로 양의 값을 대입하고 BCE 연도로 음의 값을 대입합니다. 1 BCE는 연도 0이 됩니다. | 2014 |
Q | 사분기. 1자리 숫자 사용 | 2 |
QQ | 사분기. 2자리 숫자 사용 | 02 |
QQQ | 사분기. 축약형 | Q2 |
QQQQ | 사분기. 전체 이름 | 2nd quarter |
M | 월. 1자리나 2자리 숫자 사용 | 4 |
MM | 월. 2자리 숫자 사용 | 04 |
MMM | 월. 축약형 이름 | Apr |
MMMM | 월. 전체 이름 | April |
MMMMM | 월. 대문자로 머리글자 표시 | A |
W | 그 달의 몇째 주. 1자리 숫자 사용 | 2 |
d | 그 달의 몇째 날. 1자리나 2자리 숫자 사용 | 9 |
dd | 그 달의 몇째 날. 2자리 숫자 사용 | 09 |
D | 그 해의 몇째 날. 1자리나 2자리, 3자리 숫자 사용 | 99 |
DD | 그 해의 몇째 날. 2자리 숫자 사용 | 99 |
DDD | 그 해의 몇째 날. 3자리 숫자 사용 | 099
|
e | 그 주의 몇째 날. 1자리나 2자리 숫자 사용 | 4 . 여기서, 한 주의 첫째 날은 일요일입니다. |
ee | 그 주의 몇째 날. 2자리 숫자 사용 | 04 |
eee | 요일. 축약형 이름 | Wed |
eeee | 요일. 전체 이름 | Wednesday |
eeeee | 요일. 대문자로 머리글자 표시 | W |
a | 시간대(오전 또는 오후) | PM |
h | 시. 1자리나 2자리 숫자를 사용한 12시간 표기법 | 9 |
hh | 시. 2자리 숫자를 사용한 12시간 표기법 | 09 |
H | 시. 1자리나 2자리 숫자를 사용한 24시간 표기법 | 21 |
HH | 시. 2자리 숫자를 사용한 24시간 표기법 | 21 |
m | 분. 1자리나 2자리 숫자 사용 | 41 |
mm | 분. 2자리 숫자 사용 | 41 |
s | 초. 1자리나 2자리 숫자 사용 | 6 |
ss | 초. 2자리 숫자 사용 | 06 |
S , SS , ..., SSSSSSSSS | 소수 초(Fractional Second). 'S' 의 개수로 지정된 자릿수 사용(최대 9자리) | 'SSS' 의 경우 6.12345초를 6.123 으로 자릅니다. |
참고
2자리 연도 숫자 값을 읽는 경우 형식을 y
또는 yy
로 지정하면 피벗 연도에 따라 연도가 속하는 세기가 결정됩니다.
연중 일자 숫자를 읽을 경우 연중 일자(D
) 식별자와 그레고리력 연도(y
) 식별자를 모두 포함하는 형식을 지정하면 datetime
이 연중 일자 숫자를 올바르게 읽어 들이지 못할 수 있습니다. y
자리에 ISO 연도(u
)를 사용하십시오.
0에 가까운 연도 숫자 값으로 작업할 경우 y
문자 대신 하나 이상의 u
문자를 사용하여 연도를 나타낼 수 있습니다.
144683년 CE 이후이거나 140743 BCE 이전인 datetime형 값은 지정된 Format
값에 관계없이 연도 숫자 값만 표시합니다.
다음 식별자를 사용하여 표준 시간대 오프셋의 표시 형식을 지정합니다. 표준 시간대 오프셋은 특정 날짜/시간이 UTC에서 오프셋되는 시간입니다. 표준 시간대는 표준 시간대 오프셋을 결정하는 규칙을 사용하며, 매년 다른 시기에서 오프셋은 다를 수 있습니다. 시간 구성요소가 분명하게 표시되도록 하려면 datetime형 배열의 표시 형식에 표준 시간대 오프셋 식별자를 포함시키십시오.
문자 식별자 | 설명 | 표시 |
---|---|---|
z | 표준 시간대 오프셋의 축약형 이름. 이 값을 사용할 수 없는 경우 표준 시간대 오프셋은 UTC-4 와 같은 짧은 UTC 형식을 사용합니다. | EDT |
Z | 시, 분 및 초(선택 사항) 필드를 포함한 ISO 8601 기본 형식. | -0400 |
ZZZZ | 긴 UTC 형식. | UTC-04:00 |
ZZZZZ | 시, 분 및 초(선택 사항) 필드를 포함한 ISO 8601 확장 형식. 시간 오프셋 0은 ISO 8601 UTC 표시기 “Z”로 표시됩니다. | -04:00 |
x 또는 X | 시 필드와 분 필드(선택 사항)를 포함한 ISO 8601 기본 형식. X 를 지정하면 시간 오프셋 0은 ISO 8601 UTC 표시기 “Z”로 표시됩니다. | -04 |
xx 또는 XX | 시 필드와 분 필드를 포함한 ISO 8601 기본 형식. XX 를 지정하면 시간 오프셋 0은 ISO 8601 UTC 표시기 “Z”로 표시됩니다. | -0400 |
xxx 또는 XXX | 시 필드와 분 필드를 포함한 ISO 8601 확장 형식. XXX 를 지정하면 시간 오프셋 0은 ISO 8601 UTC 표시기 “Z”로 표시됩니다. | -04:00 |
xxxx 또는 XXXX | 시, 분 및 초(선택 사항) 필드를 포함한 ISO 8601 기본 형식. XXXX 를 지정하면 시간 오프셋 0은 ISO 8601 UTC 표시기 “Z”로 표시됩니다. | -0400 |
xxxxx 또는 XXXXX | 시, 분 및 초(선택 사항) 필드를 포함한 ISO 8601 확장 형식. XXXXX 를 지정하면 시간 오프셋 0은 ISO 8601 UTC 표시기 “Z”로 표시됩니다. | -04:00 |
TimeZone
— 표준 시간대''
(디폴트 값) | 문자형 벡터 | string형 스칼라표준 시간대로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. datetime
배열을 만든 후에 이 속성을 사용하여 표준 시간대를 변경할 수 있습니다.
datetime
데이터형은 표준 시간대를 설정하고 표준 시간대 오프셋을 계산하기 위해 IANA(인터넷 할당 번호 관리 기관)에서 제공하는 IANA Time Zone Database의 코드와 데이터를 사용합니다. 현재 datetime
이 사용하는 버전에는 IANA의 최신 업데이트가 포함되어 있습니다. (datetime
이 사용하는 버전을 가져오려면 timezones
함수의 두 번째 출력값을 반환하십시오.)
TimeZone
의 값은 다음이 될 수 있습니다.
''
. 특정 표준 시간대에 속하지 않는, “표준 시간대가 지정되지 않은” datetime
형 배열을 만들려는 경우 사용합니다.
IANA 표준 시간대 데이터베이스에 제공된 표준 시간대 영역 이름(예: 'America/Los_Angeles'
). 표준 시간대 영역의 이름은 지리적 지역에서 준수하는, UTC와의 표준 오프셋 및 일광 절약 시간제 오프셋에 대한 현재 규칙과 이전 규칙을 고려합니다.
+HH:mm
또는 -HH:mm
형식의 ISO 8601 문자형 벡터(예: '+01:00'
). UTC와의 고정 오프셋인 표준 시간대를 지정하려는 경우 사용합니다.
'UTC'
. UTC(세계 협정시)의 datetime
형 배열을 만들려는 경우 사용합니다.
'UTCLeapSeconds'
. 윤초(Leap Second)를 고려하는 UTC(세계 협정시)의 datetime
형 배열을 만들려는 경우 사용합니다. datetime
데이터형에서 지원하는 윤초 목록은 leapseconds
를 참조하십시오.
'local'
. 시스템 표준 시간대의 datetime
형 배열을 만들려는 경우 사용합니다. TimeZone
속성을 쿼리하면 IANA 값이 반환됩니다.
다음 표에는 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
Year
— 연도 숫자 값datetime
형 배열에 있는 각 값의 연도 숫자 값으로, datetime
형 배열과 차원이 같은 숫자형 배열로 지정됩니다. 각 연도 숫자 값은 ISO 달력을 기반으로 하는 정수 값입니다. 현재 연대의 연도는 양수이며, 이전 연대의 연도는 0 또는 음수입니다. 예를 들어, 1 BCE에 대한 연도 숫자 값은 0입니다.
윤일(2월 29일)에 해당하는 datetime
형 값에 대해 Year
속성을 비윤년으로 설정하면 Day
와 Month
속성이 3월 1일로 변경됩니다.
Month
— 월 숫자 값datetime
형 배열에 있는 각 값의 월 숫자 값으로, datetime
형 배열과 차원이 같은 숫자형 배열로 지정됩니다. 각 월 숫자 값은 1에서 12까지의 정수 값입니다. 이 범위 밖의 값을 설정하면 Year
속성이 그에 따라 조정되고 Month
속성은 범위 1~12 내에 유지됩니다. 예를 들어, 월 0은 전년도의 12월에 해당합니다. 이전 날짜의 경우, 월 숫자 값은 역산 그레고리력(Proleptic Gregorian Calendar)을 기반으로 합니다.
Day
— 월중 일자(Day Of Month) 숫자 값datetime
형 배열에 있는 각 값의 월중 일자 숫자 값으로, datetime
형 배열과 차원이 같은 숫자형 배열로 지정됩니다. 각각의 월중 일자 숫자 값은 1에서 28, 29, 30, 31 중 하나(연도와 월에 따라 다름)까지의 정수 값입니다. 이 범위 밖의 값을 설정하면 Month
속성과 Year
속성이 그에 따라 조정되고 Day
속성은 적절한 범위 내에 유지됩니다. 예를 들어, 일자 값 0은 이전 달의 마지막 날에 해당합니다. 이전 날짜의 경우, 일 숫자 값은 역산 그레고리력(Proleptic Gregorian Calendar)을 기반으로 합니다.
Hour
— 시간 숫자 값datetime
형 배열에 있는 각 값의 시간 숫자 값으로, datetime
형 배열과 차원이 같은 숫자형 배열로 지정됩니다. 각 시간 숫자 값은 0에서 23까지의 정수 값입니다. 이 범위 밖의 값을 설정하면 Day
, Month
, Year
속성이 그에 따라 조정되고 Hour
속성은 적절한 범위 내에 유지됩니다. 예를 들어, 시간 -1은 전날의 시간 23에 해당합니다.
이러한 조건은 일광 절약 시간제를 따르는 특정 표준 시간대의 datetime형 배열에 적용됩니다.
일광 절약 시간제가 시작될 때 시간 차이에 존재하지 않는 날짜/시간을 생성하는 Hour
속성의 값을 지정하면 Hour
속성의 값은 다음 시간에 맞춰 조정됩니다.
일광 절약 시간제가 끝날 때 겹치는 시간에 모호한 날짜/시간을 생성하는 Hour
속성의 값을 지정하면 날짜/시간은 해당 시의 두 가지 시간(표준 시간)의 초에 맞춰 조정됩니다.
Minute
— 분 숫자 값datetime
형 배열에 있는 각 값의 분 숫자 값으로, datetime
형 배열과 차원이 같은 숫자형 배열로 지정됩니다. 각 분 숫자 값은 0에서 59까지의 정수 값입니다. 이 범위 밖의 값을 지정하면 Hour
, Day
, Month
, Year
속성이 그에 따라 조정되고 Minute
속성은 적절한 범위 내에 유지됩니다. 예를 들어, -1분은 이전 시의 59분에 해당합니다.
Second
— 초 숫자 값datetime
형 배열에 있는 각 값의 초 숫자 값으로, datetime
형 배열과 차원이 같은 숫자형 배열로 지정됩니다. 각 초 값은 보통 0에서 60 미만까지의 범위에 속하는 부동소수점 값입니다. 이 범위 밖의 값을 설정하면 Minute
, Hour
, Day
, Month
, Year
속성이 그에 따라 조정되고 Second
속성은 적절한 범위 내에 유지됩니다. 예를 들어, -1초는 이전 분의 59초에 해당합니다.
TimeZone
값이 'UTCLeapSeconds'
인 datetime
형 배열의 경우 초의 범위는 0에서 61 미만까지입니다. 60에서 61까지의 값은 윤초(Leap Second) 동안 발생하는 날짜/시간을 나타냅니다. (datetime
데이터형에서 지원하는 윤초 목록은 leapseconds
를 참조하십시오.)
SystemTimeZone
— 시스템 표준 시간대 설정이 속성은 읽기 전용입니다.
시스템 표준 시간대 설정으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 이 표준 시간대 설정은 MATLAB®이 실행 중인 시스템에서 결정됩니다.
예: America/New_York
로컬 시스템 표준 시간대의 현재 날짜와 시간을 지정합니다.
t = datetime('now','TimeZone','local','Format','d-MMM-y HH:mm:ss Z')
t = datetime
3-Aug-2020 20:33:31 -0400
한국 서울로 표시되는 표준 시간대의 현재 날짜와 시간을 지정합니다.
t = datetime('now','TimeZone','Asia/Seoul','Format','d-MMM-y HH:mm:ss Z')
t = datetime
4-Aug-2020 09:33:31 +0900
문자형 벡터로 구성된 셀형 배열에서 datetime
형 배열을 만듭니다.
DateStrings = {'2014-05-26';'2014-08-03'}; t = datetime(DateStrings,'InputFormat','yyyy-MM-dd')
t = 2x1 datetime
26-May-2014
03-Aug-2014
t
의 datetime형 값은 입력 날짜의 형식이 아닌 디폴트 형식을 사용하여 표시됩니다.
R2016b부터는 string
함수를 사용하여 string형 배열을 만들고 datetime형 값으로 변환할 수 있습니다.
str = string({'2016-03-24','2016-04-19'})
str = 1x2 string
"2016-03-24" "2016-04-19"
입력 형식을 yyyy-MM-dd
로 지정하여 문자열을 변환합니다. str
이 string형 배열인 경우에도 형식을 문자형 벡터로 지정해야 합니다.
t = datetime(str,'InputFormat','yyyy-MM-dd')
t = 1x2 datetime
24-Mar-2016 19-Apr-2016
날짜/시간을 밀리초 단위로 나타내는 텍스트에서 datetime
형 값을 만듭니다. 더 많은 정보 없이는 datetime
함수가 구문 분석할 수 없는 형식으로 텍스트를 변환하려면 'InputFormat'
이름-값 쌍의 인수를 지정하십시오.
d = '2018-06-25 11:23:37.712'; t = datetime(d,'InputFormat','yyyy-MM-dd HH:mm:ss.SSS')
t = datetime
25-Jun-2018 11:23:37
이 변환은 소수 초(Fractional Second)를 그대로 유지합니다. 그러나 기본적으로 datetime
형 배열은 소수 초를 표시하지 않습니다. 소수 초를 표시하려면 'Format'
이름-값 쌍 또는 Format
속성을 지정하십시오.
t.Format = 'MMM dd, yyyy HH:mm:ss.SSS'
t = datetime
Jun 25, 2018 11:23:37.712
'InputFormat'
인수는 입력 텍스트로부터 변환하는 경우에만 적용됩니다. Format
속성은 모든 datetime
형 배열의 표시 형식을 지정합니다.
ISO 8601 형식의 날짜를 datetime형 값으로 변환합니다.
ISO 8601 형식의 날짜를 포함하는 문자형 벡터로 구성된 셀형 배열을 만듭니다. 이 형식에서 문자 T는 날짜와 시간을 구분하는 구분 기호로 사용됩니다. 각 문자형 벡터는 표준 시간대 오프셋을 포함합니다. 문자 Z는 UTC로부터 오프셋이 없음을 나타냅니다.
DateStrings = {'2014-05-26T13:30-05:00';'2014-08-26T13:30-04:00';'2014-09-26T13:30Z'}
DateStrings = 3x1 cell
{'2014-05-26T13:30-05:00'}
{'2014-08-26T13:30-04:00'}
{'2014-09-26T13:30Z' }
문자형 벡터를 datetime형 값으로 변환합니다. 입력 형식을 지정할 때 문자 T를 작은따옴표로 묶어 리터럴 문자임을 나타내십시오. TimeZone
이름-값 쌍의 인수를 사용하여 출력 datetime형 배열의 표준 시간대를 지정합니다.
t = datetime(DateStrings,'InputFormat','uuuu-MM-dd''T''HH:mmXXX','TimeZone','UTC')
t = 3x1 datetime
26-May-2014 18:30:00
26-Aug-2014 17:30:00
26-Sep-2014 13:30:00
t
의 datetime형 값은 디폴트 형식으로 표시됩니다.
프랑스어로 표기된 날짜를 포함하는 문자형 벡터로 구성된 셀형 배열을 만듭니다.
C = {'8 avril 2013','9 mai 2013';'10 juin 2014','11 juillet 2014'}
C = 2x2 cell
{'8 avril 2013'} {'9 mai 2013' }
{'10 juin 2014'} {'11 juillet 2014'}
C
에 포함된 문자형 벡터를 datetime형 값으로 변환합니다. 컴퓨터가 영어를 사용하는 로캘로 설정된 경우 'Locale'
이름-값 쌍의 인수를 지정하여 문자열이 프랑스어임을 나타내야 합니다.
t = datetime(C,'InputFormat','d MMMM yyyy','Locale','fr_FR')
t = 2x2 datetime
08-Apr-2013 09-May-2013
10-Jun-2014 11-Jul-2014
t
에 포함된 datetime형 값은 디폴트 형식과, 시스템 로캘에 따라 MATLAB이 사용하는 언어로 표시됩니다.
연, 월, 일 값으로 구성된 개별 배열에서 datetime
형 배열을 만듭니다.
연도 값 Y와 일 값 D로 구성된 샘플 숫자형 배열을 만듭니다. 이 경우 월 값 M은 스칼라입니다.
Y = [2014;2013;2012]; M = 01; D = [31;30;31];
datetime
형 배열을 만듭니다.
t = datetime(Y,M,D)
t = 3x1 datetime
31-Jan-2014
30-Jan-2013
31-Jan-2012
Format
이름-값 쌍의 인수를 사용하여 출력값의 사용자 지정 표시 형식을 지정합니다.
t = datetime(Y,M,D,'Format','eeee, MMMM d, y')
t = 3x1 datetime
Friday, January 31, 2014
Wednesday, January 30, 2013
Tuesday, January 31, 2012
1900년 1월 0일 이후의 일수를 나타내는 Excel® 날짜 번호 값으로 구성된 샘플 배열을 만듭니다.
X = [39558, 39600; 39700, 39800]
X = 2×2
39558 39600
39700 39800
X
의 값을 datetime형 값으로 변환합니다.
t = datetime(X,'ConvertFrom','excel')
t = 2x2 datetime
20-Apr-2008 01-Jun-2008
09-Sep-2008 18-Dec-2008
datetime
함수 목록은 날짜/시간 항목을 참조하십시오.
datetime
형 배열을 입력 인수로 허용하는 핵심 MATLAB 함수 목록은 날짜/시간 배열을 지원하는 핵심 함수 항목을 참조하십시오.
사용법 관련 참고 및 제한 사항:
string형 배열 또는 셀형 배열에 포함된 문자형 벡터에 대한 tall datetime형 배열을 만들 때 항상 입력 datetime형 형식을 지정하십시오.
'Format'
을 'preserveinput'
으로 지정할 경우, MATLAB은 형식을 확인하기 위해 tall형 배열을 계산해야 할 수 있습니다.
자세한 내용은 tall형 배열 항목을 참조하십시오.
사용법 관련 참고 및 제한 사항:
R2020a부터는 코드 생성을 위한 MATLAB 코드에 datetime
형 배열을 사용할 수 있습니다. 자세한 내용은 Code Generation for Datetime Arrays (MATLAB Coder) 항목과 Datetime Array Limitations for Code Generation (MATLAB Coder) 항목을 참조하십시오.
사용법 관련 참고 및 제한 사항:
DateStrings
에 들어 있는 텍스트로부터 datetime
형 배열을 만들 때는 입력 형식 infmt
를 지정해야 합니다.
자세한 내용은 Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox) 항목을 참조하십시오.
calendarDuration
| cellstr
| char
| duration
| leapseconds
| NaT
| string
| timezones
다음 MATLAB 명령에 해당하는 링크를 클릭했습니다.
명령을 실행하려면 MATLAB 명령 창에 입력하십시오. 웹 브라우저는 MATLAB 명령을 지원하지 않습니다.
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
Select web siteYou can also select a web site from the following list:
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.