decyear

Decimal year calculator

collapse all in page

Syntax

dy = decyear(datetime)

dy = decyear(dateVector)

dy = decyear(dateCharacterVector,format)

dy = decyear(year,month,day)

dy = decyear([year,month,day])

dy = decyear(year,month,day,hour,minute,second)

dy = decyear([year,month,day,hour,minute,second])

Description

example

dy = decyear(datetime) converts one or more datetime arrays to decimal year, dy.

dy = decyear(dateVector) converts one or more date vectors, dateVector, into decimal year, dy.

dy = decyear(dateCharacterVector,format) converts one or more date character vectors, dateCharacterVector, to decimal year using format format.

example

dy = decyear(year,month,day) and dy = decyear([year,month,day]) return the decimal year for corresponding elements of the year,month,day arrays.

dy = decyear(year,month,day,hour,minute,second) and dy = decyear([year,month,day,hour,minute,second]) return the decimal year for corresponding elements of the year,month,day,hour,minute,second arrays. Specify the six arguments as one-dimensional arrays of the same length or as scalar values.

Examples

collapse all

Calculate Decimal Year Using `datetime` Array

Calculate the decimal year for February 4, 2016 from datetime array.

dt = datetime('04-02-2016','InputFormat','dd-MM-yyyy')
dy = decyear(dt)

dt = 
  datetime

   04-Feb-2016

dy =
   2.0161e+03

Calculate Decimal Year Using Data Character Vector and `dd-mm-yyyy` Format

Calculate decimal year for May 24, 2005 using data character vector and dd-mm-yyyy format.

dy = decyear('24-May-2005','dd-mmm-yyyy')

dy =
   2.0054e+03

Calculate Decimal Year Using Year, Month, and Day Inputs

Calculate the decimal year for December 19, 2006 from year, month, and day inputs.

dy = decyear(2006,12,19)

dy =
  2.0070e+003

Calculate Decimal Year from Year, Month, Day, Hour, Minute, and Second Inputs

Calculate the decimal year for October 10, 2004, at 12:21:00 p.m. from year, month, day, hour, month, and second inputs:

dy = decyear(2004,10,10,12,21,0)

dy =
  2.0048e+003

Input Arguments

collapse all

`datetime` — `datetime` array
m-by-1 array | 1-by-m array

datetime array, specified as an m-by-1 array or 1-by-m array.

`dateVector` — Full or partial date vector
m-by-6 matrix | m-by-3 matrix | positive double-precision number

Full or partial date vector, specified as an m-by-6 or m-by-3 matrix containing m full or partial date vectors, respectively:

Full date vector — Contains six elements specifying the year, month, day, hour, minute, and second
Partial date vector — Contains three elements specifying the year, month, and day

Data Types: double

`dateCharacterVector` — Date character vector
character array | one-dimensional cell array of character vectors

Date character vector, specified as a character array, where each row corresponds to one date, or a one-dimensional cell array of character vectors.

Data Types: char | string

`format` — Date format
`-1` (default) | character vector | string scalar | integer

Date format, specified as a character vector, string scalar, or integer. All dates in dateCharacterVector must have the same format and use the same date format symbols as the datenum function.

decyear does not accept formats containing the letter Q.

If format does not contain enough information to compute a date number, then:

Hours, minutes, and seconds default to 0.
Days default to 1.
Months default to January.
Years default to the current year.

Data Types: char | string