Main Content

datestr

(권장되지 않음, string 또는 char 사용) 날짜/시간을 문자열 형식으로 변환

datestr은 권장되지 않습니다. datetime형 값을 텍스트로 변환하려면 string 또는 char 함수를 사용하십시오. 코드 업데이트에 대한 자세한 내용은 버전 내역 또는Replace Discouraged Instances of Serial Date Numbers and Date Strings 항목을 참조하십시오.

설명

예제

DateString = datestr(t)는 입력 배열 t에 있는 datetime형 값을 날짜/시간을 나타내는 텍스트로 변환합니다.

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

예제

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

참고: datestr이 날짜 벡터를 마치 6개의 날짜 번호 값으로 구성된 벡터인 것처럼 해석하는 경우가 있습니다. 자세한 내용은 날짜 벡터 변환에서 예기치 않은 출력값이 반환되는 경우 항목을 참조하십시오.

예제

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
   14-Aug-2023 23:33:27
   15-Aug-2023 00:00:00

DateString = datestr(t)
DateString = 2x20 char array
    '14-Aug-2023 23:33:27'
    '15-Aug-2023 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/14/23'

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

formatOut = 2;
datestr(now,formatOut)
ans = 
'08/14/23'

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

dt = datestr(now,'mmmm dd, yyyy HH:MM:SS.FFF AM')
dt = 
'August 14, 2023 11:33:24.230 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형 배열로 지정됩니다.

참고: datestr 함수는 NaTdatetime 값을 입력값으로 받지 않습니다.

데이터형: datetime

날짜 벡터로, m×6 행렬로 지정됩니다. 여기서 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 이전에 개발됨

모두 확장