이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

datestr

날짜/시간을 문자열 형식으로 변환

datestr 함수는 하나 이상의 시점을 표시하는 문자형 배열을 만듭니다. 그러나, 시점을 나타내는 가장 좋은 방법은 datetime 데이터형을 사용하는 것입니다.

구문

DateString = datestr(t)
DateString = datestr(DateVector)
DateString = datestr(DateNumber)
DateString = datestr(___,formatOut)
DateString = datestr(DateStringIn)
DateString = datestr(DateStringIn,formatOut,PivotYear)
DateString = datestr(___,'local')

설명

예제

DateString = datestr(t)는 입력 배열 t에 있는 datetime형 값을 날짜/시간을 나타내는 텍스트로 변환합니다. 그러나, char, cellstr 또는 string 함수를 사용하여 datetime형 값을 텍스트로 나타낼 수도 있습니다.

datestr 함수는 m개 행으로 구성된 문자형 배열을 반환하며, mt에 있는 datetime형 값의 총 개수입니다. 기본적으로 datestr은 일-월-연 시:분:초 형식의 텍스트를 반환합니다. 시:분:초가 00:00:00인 경우 반환되는 텍스트의 형식은 일-월-연이 됩니다.

예제

DateString = datestr(DateVector)는 날짜 벡터를 날짜/시간을 나타내는 텍스트로 변환합니다. datestr 함수는 m개 행으로 구성된 문자형 배열을 반환하며, mDateVector에 있는 날짜 벡터의 총 개수입니다.

예제

DateString = datestr(DateNumber)는 날짜 일련 번호 값을 날짜/시간을 나타내는 텍스트로 변환합니다. datestr 함수는 m개 행으로 구성된 문자형 배열을 반환하며, mDateNumber에 있는 날짜 번호 값의 총 개수입니다.

예제

DateString = datestr(___,formatOut)formatOut을 사용하여 출력 텍스트의 형식을 지정합니다. formatOut은 위에 열거한 구문의 모든 입력 인수와 함께 사용할 수 있습니다.

DateString = datestr(DateStringIn)DateStringIn을 일-월-연 시:분:초 형식의 텍스트로 변환합니다. DateStringIn으로 표현되는 모든 날짜/시간은 형식이 동일해야 합니다.

예제

DateString = datestr(DateStringIn,formatOut,PivotYear)DateStringInformatOut으로 지정된 형식의 DateString으로 변환하고, 선택적으로 PivotYear를 사용하여 연도를 명시하는 두 문자로 된 날짜를 해석합니다.

예제

DateString = datestr(___,'local')은 현재 로케일의 언어로 날짜를 반환합니다. 이 언어는 컴퓨터의 운영 체제에서 사용자가 선택한 언어입니다. 인수 목록에서 'local'을 빼면 datestr은 텍스트를 디폴트 언어(US English)로 반환합니다. 'local'을 위에 열거된 구문 중 하나와 함께 사용합니다. 'local' 인수는 인수 시퀀스의 마지막에 나와야 합니다.

예제

모두 축소

t = [datetime('now');datetime('tomorrow')]
t = 2x1 datetime array
   02-Aug-2018 18:15:57
   03-Aug-2018 00:00:00

DateString = datestr(t)
DateString = 2x20 char array
    '02-Aug-2018 18:15:57'
    '03-Aug-2018 00:00:00'

datestr은 일-월-연 시:분:초 형식으로 날짜/시간을 나타내는 텍스트를 반환합니다.

DateVector = [2009,4,2,11,7,18];

datestr(DateVector)
ans = 
'02-Apr-2009 11:07:18'

datestr은 디폴트 형식으로 날짜/시간을 나타내는 텍스트를 반환합니다.

현재 날짜를 mm/dd/yy 형식으로 지정합니다.

기호 식별자를 사용하여 이 형식을 지정할 수 있습니다.

formatOut = 'mm/dd/yy';
datestr(now,formatOut)
ans = 
'08/02/18'

또는 숫자형 식별자를 사용하여 이 형식을 지정할 수 있습니다.

formatOut = 2;
datestr(now,formatOut)
ans = 
'08/02/18'

날짜/시간의 형식을 다시 지정할 수 있으며, 밀리초를 표시할 수도 있습니다.

dt = datestr(now,'mmmm dd, yyyy HH:MM:SS.FFF AM')
dt = 
'August 02, 2018  6:15:25.628 PM'

12시간 형식 시간 05:32 p.m.을 24시간 형식 시간으로 변환합니다.

datestr('05:32 PM','HH:MM')
ans = 
'17:32'

24시간 형식 시간 05:32를 12시간 형식 시간으로 변환합니다.

datestr('05:32','HH:MM PM')
ans = 
' 5:32 AM'

formatOut 출력 텍스트에 AM 또는 PM을 사용하는 것은 실제로 텍스트의 일부가 되는 문자에 영향을 미치지 않습니다. 이러한 문자를 포함할지 여부만 지정합니다. 입력한 시간에 따라 MATLAB®이 AM이나 PM을 선택합니다.

datestr 내에 datenum을 호출하여 날짜를 나타내는 입력 텍스트의 형식을 지정합니다.

formatOut = 'dd mmm yyyy';
datestr(datenum('16-04-55','dd-mm-yy',1900),formatOut)
ans = 
'16 Apr 1955'

날짜를 나타내는 여러 문자형 벡터를 셀형 배열 형식으로 전달하여 변환합니다.

모든 입력 날짜는 형식이 동일해야 합니다. 예를 들어, 다음 명령은 mm/dd/yyyy 형식을 사용하는 3개의 날짜를 전달합니다.

datestr(datenum({'09/16/2007';'05/14/1996';'11/29/2010'}, ...
    'mm/dd/yyyy'))
ans = 3x11 char array
    '16-Sep-2007'
    '14-May-1996'
    '29-Nov-2010'

datestr은 일-월-연 형식으로 변환된 날짜로 구성된 문자형 배열을 반환합니다.

아래 날짜는 정상 범위를 벗어난 값(month=13)을 사용하고 있으므로 datestr 내에서 datenum을 호출하여 원하는 값이 반환되도록 합니다.

datestr(datenum('13/24/88','mm/dd/yy'))
ans = 
'24-Jan-1989'

피벗 연도를 변경하여 연도 범위를 변경합니다.

피벗 연도 1900을 사용합니다.

DateStringIn = '4/16/55';
formatOut = 1;
PivotYear = 1900;
datestr(DateStringIn,formatOut,PivotYear)
ans = 
'16-Apr-1955'

동일한 날짜에 대해 피벗 연도 2000을 사용합니다.

PivotYear = 2000;
datestr(DateStringIn,formatOut,PivotYear)
ans = 
'16-Apr-2055'

날짜 번호 값을 현재 로케일의 언어로 된 텍스트로 변환합니다.

프랑스어 로케일의 'local' 인수를 사용합니다.

DateNumber = 725935;
formatOut = 'mmmm-dd-yyyy';
str = datestr(DateNumber,formatOut,'local')
str =
Juillet-17-1987

'local'을 지정하지 않고 동일한 호출을 만들 수 있습니다.

str = datestr(DateNumber,formatOut)
str =
July-17-1987

이 경우 출력값은 기본적으로 영어로 설정됩니다.

입력 인수

모두 축소

날짜/시간으로, datetime형 배열로 지정됩니다.

데이터형: datetime

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

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

데이터형: double

날짜 일련 번호 값으로, 양의 배정밀도 숫자로 구성된 배열로 지정됩니다.

예: 731878

데이터형: double

날짜/시간을 나타내는 출력값 형식으로, 기호 식별자로 구성된 문자형 벡터나 string형 스칼라로 지정되거나 미리 정의된 형식에 대응하는 정수로 지정됩니다. formatOut을 지정하지 않는 경우 datestr은 디폴트 형식 dd-mmm-yyyy HH:MM:SS(일-월-연 시:분:초)로 텍스트를 반환합니다. 기본적으로 HH:MM:SS = 00:00:00이면 반환된 텍스트의 형식은 dd-mmm-yyyy입니다.

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

참고

날짜/시간 형식을 설명하는 기호 식별자는 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

formatOut 문자형 벡터는 다음 지침을 준수해야 합니다.

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

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

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

다음 표에는 datestr과 함께 사용할 수 있는 미리 정의된 날짜 형식이 나와 있습니다.

숫자형 식별자

날짜/시간 형식

-1(디폴트 값)

'dd-mmm-yyyy HH:MM:SS' 또는 'dd-mmm-yyyy'('HH:MM:SS'= 00:00:00인 경우)

01-Mar-2000 15:45:17 또는 01-Mar-2000

0

'dd-mmm-yyyy HH:MM:SS'

01-Mar-2000 15:45:17

1

'dd-mmm-yyyy'

01-Mar-2000

2

'mm/dd/yy'

03/01/00

3

'mmm'

Mar

4

'm'

M

5

'mm'

03

6

'mm/dd'

03/01

7

'dd'

01

8

'ddd'

Wed

9

'd'

W

10

'yyyy'

2000

11

'yy'

00

12

'mmmyy'

Mar00

13

'HH:MM:SS'

15:45:17

14

'HH:MM:SS PM'

3:45:17 PM

15

'HH:MM'

15:45

16

'HH:MM PM'

3:45 PM

17

'QQ-YY'

Q1-01

18

'QQ'

Q1

19

'dd/mm'

01/03

20

'dd/mm/yy'

01/03/00

21

'mmm.dd,yyyy HH:MM:SS'

Mar.01,2000 15:45:17

22

'mmm.dd,yyyy'

Mar.01,2000

23

'mm/dd/yyyy'

03/01/2000

24

'dd/mm/yyyy'

01/03/2000

25

'yy/mm/dd'

00/03/01

26

'yyyy/mm/dd'

2000/03/01

27

'QQ-YYYY'

Q1-2001

28

'mmmyyyy'

Mar2000

29

'yyyy-mm-dd'
(ISO 8601)

2000-03-01

30

'yyyymmddTHHMMSS'
(ISO 8601)

20000301T154517

31

'yyyy-mm-dd HH:MM:SS'

2000-03-01 15:45:17

변환할 날짜/시간을 나타내는 텍스트로, 단일 문자형 벡터로 지정되거나 각 행이 하나의 날짜/시간에 해당하는 문자형 벡터로 구성된 셀형 배열이나 string형 배열로 지정됩니다.

datestr은 2자로 된 연도(예: '79')를 현재 연도를 중심으로 100년 범위 내에 해당하는 것으로 간주합니다.

날짜/시간을 나타내는 텍스트는 모두 날짜 형식이 동일해야 하며, 다음 날짜 형식 중 하나여야 합니다.

날짜/시간을 나타내는 텍스트 형식

'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

참고

날짜/시간 형식을 변환할 때 입력값의 형식을 지정할 수 있도록 먼저 텍스트를 datenum 함수로 전달해야 합니다. 이를 통하여 입력 날짜/시간의 형식이 올바르게 해석될 수 있습니다. 예제는 사용자 지정 형식에서 날짜 문자열 변환 항목을 참조하십시오.

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

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

예: 2000

참고

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

데이터형: double

출력 인수

모두 축소

날짜/시간을 나타내는 텍스트로, m개 행을 갖는 문자형 배열로 반환됩니다. 여기서 m은 입력 날짜/시간의 총 개수입니다. 디폴트 출력 형식은 dd-mmm-yyyy HH:MM:SS(일-월-연 시:분:초)입니다. 단, 시, 분, 초가 모두 0인 경우에는 HH:MM:SS가 표시되지 않습니다.

  • 텍스트를 미리 정의된 MATLAB® 날짜 형식이 아닌 형식으로 변환하려면 먼저 datenum 또는 datevec 함수를 사용하여 텍스트를 날짜 번호 값으로 변환해야 합니다.

확장 기능

R2006a 이전에 개발됨