month

Month of date

Syntax

[MonthNum,MonthString] = month(Date)

[MonthNum,MonthString] = month(___,F)

Description

[MonthNum,MonthString] = month(Date) returns the month of date given a serial date number or a date character vector.

[MonthNum,MonthString] = month(___,F) returns the month of date given a serial date number or a date character vector, Date, using format defined by the optional input F. Date can be a character array where each row corresponds to one date character vector, or a one-dimensional cell array of character vectors. All the character vectors in Date must have the same format F. F must designate a supported date format symbol. For more information on supported date formats, see datestr.

Examples

Determine the Month for Various Dates

Find the month for Date using a serial date number.

[MonthNum, MonthString] = month(730368)

MonthNum = 9

MonthString = 
'Sep'

Find the month for Date using a date character vector format.

[MonthNum, MonthString] = month('05-Sep-1999')

MonthNum = 9

MonthString = 
'Sep'

Use the optional F argument to designate a country-specific date format for a given Date.

[MonthNum, MonthString] = month('1999/05/09','yyyy/dd/mm')

MonthNum = 9

MonthString = 
'Sep'

Input Arguments

Date — Date to determine month

serial date number | date character vector | cell array of date character vectors

Date to determine month, specified as a serial date number or date character vector.

Date can be an array of date character vectors, where each row corresponds to one date character vector, or a one-dimensional cell array of character vectors. All the character vectors in Date must have the same format F. F must designate a supported date format symbol. For more information on supported date formats, see datestr

Data Types: single | double | char | cell

F — Date format symbol

character vector designating date format

Date format symbol, specified as a character vector to designate the date format symbol for input argument Date. For more information on supported date character vector formats, see datestr. Note, formats with 'Q' are not accepted.

Data Types: char

Output Arguments

MonthNum — Numeric representation of the month

nonnegative integer

Month of date, returned as a nonnegative integer.

MonthString — Three letter abbreviation for month

character vector

Three letter abbreviation for month, returned as a character vector.