datestr

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

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

구문

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형 값을 날짜/시간을 나타내는 텍스트로 변환합니다.

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

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

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

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

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

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

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

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

예제

datetime형 배열을 날짜 문자열로 변환

t = [datetime('now');datetime('tomorrow')]

t = 2×1 datetime
   13-Jul-2025 18:34:03
   14-Jul-2025 00:00:00

DateString = datestr(t)

DateString = 2×20 char array
    '13-Jul-2025 18:34:03'
    '14-Jul-2025 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 = 
'07/13/25'

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

formatOut = 2;
datestr(now,formatOut)

ans = 
'07/13/25'

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

dt = datestr(now,'mmmm dd, yyyy HH:MM:SS.FFF AM')

dt = 
'July 13, 2025  6:34:00.686 PM'

12시간 형식 시간 문자열을 24시간 형식 시간 문자열로 변환

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 = 3×11 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

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

입력 인수

t — 날짜/시간

datetime형 배열

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

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

데이터형: datetime

DateVector — 날짜 벡터

행렬

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

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

데이터형: double

DateNumber — 날짜 일련 번호 값

양의 배정밀도 숫자로 구성된 배열

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

예: 731878

데이터형: double

formatOut — 날짜/시간을 나타내는 출력값 형식

-1 (디폴트 값) | 문자형 벡터 | string형 스칼라 | 정수

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

DateStringIn — 변환할 날짜/시간을 나타내는 텍스트

문자형 벡터 | 셀형 배열 | string형 배열

변환할 날짜/시간을 나타내는 텍스트로, 단일 문자형 벡터로 지정되거나 각 행이 하나의 날짜/시간에 해당하는 문자형 벡터로 구성된 셀형 배열이나 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 함수로 전달해야 합니다. 이를 통하여 입력 날짜/시간의 형식이 올바르게 해석될 수 있습니다. 예제는 사용자 지정 형식에서 날짜 문자열 변환 항목을 참조하십시오.

PivotYear — 100년 날짜 범위의 시작 연도

현재 연도 - 50년 (디폴트 값) | 정수

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

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

예: 2000

참고

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

데이터형: double

출력 인수

DateString — 날짜/시간을 나타내는 텍스트

문자형 벡터 | 2차원 문자형 배열

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

팁

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

확장 기능

tall형 배열

메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

datestr 함수는 tall형 배열을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

• 첫 번째 인수가 열 벡터이거나 datevec에서 반환된 배열이어야 합니다.

• 첫 번째 인수가 datevec 배열인 경우 행은 연도 범위 1500:2499 내에 있어야 합니다.

자세한 내용은 tall형 배열 항목을 참조하십시오.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

R2022b: 권장되지 않음

datestr을 제거할 계획은 없습니다. 하지만 string과 char 함수가 datetime 배열의 텍스트 변환용으로 대신 권장됩니다. datetime 데이터형은 유연한 날짜/시간 형식과 나노초 정밀도로 표현하기 위한 저장공간, 표준 시간대와 일광 절약 시간제를 고려하기 위한 속성을 제공합니다.

예를 들어 현재 날짜와 시간을 datetime형 값으로 표현합니다. 그런 다음 string형으로 변환합니다.

d = datetime("now")

d = datetime
   15-Apr-2022 15:53:28

str = string(d)

str = 
    "15-Apr-2022 15:53:28"

날짜 벡터를 텍스트로 변환하려면 먼저 datetime형 값으로 변환합니다. 그런 다음 그 값을 텍스트로 변환합니다.

dv = [2022 4 15 15 53 28];
d = datetime(dv);
d = string(d)

d = 
    "15-Apr-2022 15:53:28"

참고 항목

datetime | string | char | datevec

도움말 항목

• MATLAB에서 날짜/시간 표시하기
• 날짜 벡터 변환에서 예기치 않은 출력값이 반환되는 경우