# decyear

Decimal year calculator

## Syntax

``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(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`. `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 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 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

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`

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`

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`

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, specify `year`, `month`, and `day` or `year`, `month`, `day`, `hour`, `minute`, and `second` as one-dimensional arrays of the same length or scalar values.

Data Types: `double`

Month, specified as a scalar or one-dimensional array from `1` to `12`.

#### Dependencies

Depending on the syntax, specify `year`, `month`, and `day` or `year`, `month`, `day`, `hour`, `minute`, and `second` as 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, specify `year`, `month`, and `day` or `year`, `month`, `day`, `hour`, `minute`, and `second` as one-dimensional arrays of the same length or scalar values.

Data Types: `double`

Hour, specified as a scalar from `0` to `24`.

#### Dependencies

Depending on the syntax, specify `year`, `month`, and `day` or `year`, `month`, `day`, `hour`, `minute`, and `second` as one-dimensional arrays of the same length or scalar values.

Data Types: `double`

Minute, specified as a double, whole number from `0` to `60`.

#### Dependencies

Depending on the syntax, specify `year`, `month`, and `day` or `year`, `month`, `day`, `hour`, `minute`, and `second` as one-dimensional arrays of the same length or scalar values.

Data Types: `double`

Second, specified as a double, whole number from `0` to `60`.

#### Dependencies

Depending on the syntax, specify `year`, `month`, and `day` or `year`, `month`, `day`, `hour`, `minute`, and `second` as one-dimensional arrays of the same length or scalar values.

Data Types: `double`

## Output Arguments

collapse all

Decimal year, returned as a 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

#### Dependencies

The output format depends on the input format:

Input Syntax`dy` Format
```dy = decyear(dateVector)```m-by-6 column vector or m-by-3 column vector of m decimal years
```dy = decyear(dateCharacterVector,format)```Column vector of m decimal years, where m is the number of character vectors in `dateCharacterVector` 