year

Year of date

Syntax

Year = year(Date)

Year = year(___,F)

Description

Year = year(Date) returns the year of date given a serial date number or a date character vector.

Year = year(___,F) returns the year 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 Year of the Date for Various Dates

Find the year for Date using a serial date number.

Year = year(731798.776)

Year = 2003

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

Year = year('05-Aug-2003')

Year = 2003

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

Year = year('1999/05/09','yyyy/dd/mm')

Year = 1999

Input Arguments

Date — Date to determine year

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

Date to determine year, 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

Year — Numeric representation of the year

nonnegative integer

Numeric representation of the year, returned as a nonnegative integer.