month

날짜/시간 입력값의 월 숫자 값 또는 이름

구문

m = month(t)

m = month(t,monthType)

설명

m = month(t)는 t에 지정된 각 날짜/시간의 월 숫자 값을 반환합니다.

m 출력값은 1에서 12까지의 정수 값이 포함된 double형 배열입니다. datetime형 배열 t에 월 숫자 값을 할당하려면 t.Month를 사용하고 Month 속성을 수정하십시오.

m = month(t,monthType)은 "monthofyear", "name" 또는 "shortname"으로 지정된 유형의 datetime형 배열 t의 월 숫자 값 또는 이름을 반환합니다.

예제

날짜에서 월 숫자 값 추출하기

날짜로 구성된 배열에서 월 숫자 값을 추출합니다.

t = datetime(2014,05,31):caldays(35):datetime(2014,10,15)

t = 1x4 datetime
   31-May-2014   05-Jul-2014   09-Aug-2014   13-Sep-2014

m = month(t)

m = 1×4

     5     7     8     9

날짜의 월 이름 찾기

날짜로 구성된 배열에서 월 이름을 가져옵니다.

t = datetime(2013,01,01):calweeks(12):datetime(2013,12,31)

t = 1x5 datetime
   01-Jan-2013   26-Mar-2013   18-Jun-2013   10-Sep-2013   03-Dec-2013

m = month(t,'name')

m = 1x5 cell
    {'January'}    {'March'}    {'June'}    {'September'}    {'December'}

입력 인수

t — 날짜/시간 입력값

datetime형 배열

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

이전에 Financial Toolbox™를 필요로 했던 기존 코드를 지원하기 위해 month가 날짜 일련 번호 값과 텍스트도 입력값으로 받지만 권장되지는 않습니다. 자세한 내용은 버전 내역을 참조하십시오.

monthType — 월 값의 유형

'monthofyear' (디폴트 값) | 'name' | 'shortname'

월 값의 유형으로, 표에 나열된 값 중 하나로 지정됩니다.

monthType의 값	설명
'monthofyear'	월 숫자 값
'name'	전체 월 이름(예: August 또는 September). NaT datetime형 값의 경우 월 이름은 빈 문자형 벡터('')입니다.
'shortname'	축약형 월 이름(예: Aug 또는 Sep). NaT datetime형 값의 경우 월 이름은 빈 문자형 벡터('')입니다.

참고

month는 기본 설정 창의 날짜/시간 형식 섹션에 있는 로캘 옵션으로 지정된 언어로 월 이름을 반환합니다. 디폴트 날짜/시간 로캘을 변경하려면 명령 창 기본 설정 지정하기 항목을 참조하십시오.

이 인수는 t가 datetime형 배열인 경우에만 유효합니다.

출력 인수

m — 월 숫자 값 또는 이름

double형 배열 | 문자형 벡터로 구성된 셀형 배열

월 숫자 값 또는 이름으로, double형으로 구성된 숫자형 배열이나 문자형 벡터로 구성된 셀형 배열로 반환됩니다. m은 t와 크기가 같습니다.

확장 기능

tall형 배열

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

이 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

스레드 기반 환경

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

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

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

이 함수는 분산 배열을 완전히 지원합니다. 자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2014b에 개발됨

R2022a: 날짜 일련 번호 값과 텍스트 입력값은 권장되지 않음

month가 날짜 일련 번호 값과 텍스트 입력값을 지원하지만 대신 datetime형 값이 권장됩니다. datetime 데이터형은 유연한 날짜/시간 형식과 나노초 정밀도로 표현하기 위한 저장공간, 표준 시간대와 일광 절약 시간제를 고려하기 위한 속성을 제공합니다.

날짜 일련 번호 값 또는 텍스트를 datetime형 값으로 변환하려면 datetime 함수를 사용하십시오. 예를 들어, 다음과 같이 합니다.

t = datetime(738427.656845093,"ConvertFrom","datenum");
m = month(t)

m =

     9

현재는 날짜 일련 번호 값 또는 텍스트 입력값에 대한 지원을 제거할 계획이 없습니다.

R2022a: Financial Toolbox와 MATLAB이 결합된 month 함수

이전 릴리스에서는 두 개의 month 함수가 있었습니다. 하나는 datetime형 값을 받는 MATLAB^®의 함수이고, 다른 하나는 날짜 일련 번호 값 또는 텍스트 값을 받는 Financial Toolbox의 함수입니다. R2022a부터는 Financial Toolbox 없이 month를 호출할 수 있습니다. MATLAB에서 month를 호출할 때 이전의 모든 입력 유형이 허용됩니다.

예를 들어, MATLAB에서 날짜 일련 번호 값과 텍스트를 사용하여 다음과 같은 호출을 생성할 수 있습니다.

m = month(738427.656845093)

m =

     9

m = month("28-Sep-2021")

m =

     9

더불어 month는 첫 번째 입력값이 datetime형 배열이 아닌 경우 날짜 형식을 나타내는 두 번째 입력값을 받습니다.

m = month(t,F)

아래 구문에서는 datestr 함수 문서에 나온 유효한 날짜 형식을 사용하여 F를 지정합니다. 단, 'Q' 형식 지정자는 지원되지 않습니다. 예를 들면 다음과 같습니다.

m = month("2021/28/09","yyyy/dd/mm")

m =

     9

참고 항목

ymd | year | quarter | week | day | datetime