quarter

Returns the quarter of given date

Syntax

q = quarter(date)

q = quarter(___,month1)

q = quarter(date,month1,dateformat)

Description

q = quarter(date) returns the quarter of the given date, assuming the standard calendar (starting on January 1st).

q = quarter(___,month1) returns the quarter of the date for a calendar which starts on the month specified by month1. month1 must be an integer between 1–12 representing Jan-Dec respectively.

q = quarter(date,month1,dateformat) returns the quarter of the date for a calendar which starts on the month specified by month1. month1 must be an integer between 1–12 representing January to December respectively. The dateformat input is a character vector to specify the format of your date character vector in case it is not normally recognized by the datenum function.

Examples

Determine the Quarter for a Given Date

quarter returns the quarter of the given date, assuming the standard calendar that starts on Jan 1st.

quarter('7-Apr-2013')

ans = 2

Determine the Quarter for a Given Date for an Off-Cycle Calendar

quarter returns the quarter of the date for a calendar which starts on the month specified by month1.

quarter('7-Apr-2013',5)

ans = 4

If the financial calendar starts in May (where month1 = 5), April would be the last month and fall in the last quarter.

Determine the Quarter for a Given Date When the Date is Not Recognized by datenum

When using quarter, the optional input argument for dateformat is a character vector which lets you specify the format of your date character vector in case it isn't normally recognized by the datenum function.

quarter('07-04-2013',1)

ans = 3

This gives the quarter 3 because by default datenum interprets the date as July 7th, 2013.

If you really meant April 7th, 2013, you can use dateformat to specify the intended format.

quarter('07-04-2013',1,'dd-mm-yyyy')

ans = 2

Input Arguments

date — Date in a quarter

serial date number | date character vector

Date in a quarter, specified as a serial date number or date character vector.

Data Types: double | char

month1 — First month in a calendar

integer with value between 1–12

First month in a calendar, specified as an integer with a value between 1–12, representing January to December respectively. Use month1 when the standard calendar that starts on January 1st does not apply.

Data Types: double

dateformat — Format of date

character vector

Format of date, specified as a character vector. dateformat input is a character vector to specify the format of your date character vector in case it is not normally recognized by the datenum function.

Data Types: char

Output Arguments

q — Quarter for given date

integer

Quarter for given date, returned as an integer between 1–4.