month

Month number and name

Syntax

m = month(t)

m = month(t,monthType)

Description

m = month(t) returns the month numbers of the datetime values in t. The m output contains integer values from 1 to 12.

m = month(t,monthType) returns the type of month number or name specified by monthType.

The month function returns the month numbers or names of datetime values. To assign month numbers to datetime array t, use t.Month and modify the Month property.

Examples

Extract Month Number from Dates

Extract the month numbers from an array of dates.

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

Find Month Names of Dates

Get the month names from an array of dates.

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'}

Input Arguments

t — Input date and time

datetime array

Input date and time, specified as a datetime array.

monthType — Type of month values

'monthofyear' (default) | 'name' | 'shortname'

Type of month values, specified as a value in the table.

Value of monthType	Description
'monthofyear'	Month-of-year number
'name'	Full month names, for example, August or September. For NaT datetime values, the month name is the empty character vector, ''.
'shortname'	Abbreviated month names, for example, Aug or Sep. For NaT datetime values, the month name is the empty character vector, ''.

Note

month returns month names in the language specified by the Locale option in the Datetime format section of the Preferences window. To change the default datetime locale, see Set Command Window Preferences.

Output Arguments

m — Month number or name

double array | cell array of character vectors

Month number or name, returned as a numeric array of type double, or a cell array of character vectors. m is the same size as t.

Extended Capabilities

Tall Arrays

Calculate with arrays that have more rows than fit in memory.

This function fully supports tall arrays. For more information, see Tall Arrays.

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).