Main Content

decyear

Decimal year calculator

    Description

    example

    dy= decyear(datetime)converts one or moredatetimearrays 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 formatformat.

    example

    dy= decyear(year,month,day)anddy= decyear([year,month,day])return the decimal year for corresponding elements of theyear,month,dayarrays.

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

    Examples

    collapse all

    Calculate the decimal year for February 4, 2016 fromdatetimearray.

    dt = datetime('04-02-2016',“InputFormat”,'dd-MM-yyyy') dy = decyear(dt)
    dt = datetime 04-Feb-2016 dy = 2.0161e+03

    Calculate decimal year for May 24, 2005 using data character vector anddd-mm-yyyyformat.

    dy = decyear('24-May-2005','dd-mmm-yyyy')
    dy = 2.0054e+03

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

    dy = decyear(2006,12,19)
    dy = 2.0070e+003

    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

    datetimearray, specified as anm-by-1 array or 1-by-marray.

    Full or partial date vector, specified as anm-by-6 orm3 matrix containingmfull 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

    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

    日期格式,specified as a character vector, string scalar, or integer. All dates indateCharacterVectormust have the same format and use the same date format symbols as thedatenumfunction.

    decyeardoes not accept formats containing the letterQ.

    Ifformatdoes not contain enough information to compute a date number, then:

    • Hours, minutes, and seconds default to 0.

    • 天默认为1。

    • Months default to January.

    • Years default to the current year.

    Data Types:char|string

    Year, specified as a scalar or one-dimensional array.

    Dates with two character years are interpreted to be within 100 years of the current year.

    Dependencies

    Depending on the syntax, specifyyear,month, anddayoryear,month,day,hour,minute, andsecondas one-dimensional arrays of the same length or scalar values.

    Data Types:double

    Month, specified as a scalar or one-dimensional array from1to12.

    Dependencies

    Depending on the syntax, specifyyear,month, anddayoryear,month,day,hour,minute, andsecondas one-dimensional arrays of the same length or scalar values.

    Data Types:double

    Day, specified as a scalar or one-dimensional array from 1 to 31.

    Dependencies

    Depending on the syntax, specifyyear,month, anddayoryear,month,day,hour,minute, andsecondas one-dimensional arrays of the same length or scalar values.

    Data Types:double

    Hour, specified as a scalar from0to24.

    Dependencies

    Depending on the syntax, specifyyear,month, anddayoryear,month,day,hour,minute, andsecondas one-dimensional arrays of the same length or scalar values.

    Data Types:double

    Minute, specified as a double, whole number from0to60.

    Dependencies

    Depending on the syntax, specifyyear,month, anddayoryear,month,day,hour,minute, andsecondas one-dimensional arrays of the same length or scalar values.

    Data Types:double

    Second, specified as a double, whole number from0to60.

    Dependencies

    Depending on the syntax, specifyyear,month, anddayoryear,month,day,hour,minute, andsecondas one-dimensional arrays of the same length or scalar values.

    Data Types:double

    Output Arguments

    collapse all

    Decimal year, returned as a row or column vector.

    • m-by-6 column vector — Contains six elements specifying the year, month, day, hour, minute, and second

    • m-by-3 column vector — Contains three elements specifying the year, month, and day

    • Row or column vector — Containsmdecimal years

    Dependencies

    The output format depends on the input format:

    Input Syntax dyFormat
    dy= decyear(datetime) Column or row vector ofmdecimal years
    dy= decyear(dateVector) m-by-6 column vector orm-by-3 column vector ofmdecimal years
    dy= decyear(dateCharacterVector,format) Column vector ofmdecimal years, wheremis the number of character vectors indateCharacterVector

    Version History

    Introduced in R2006b