datenum (MATLAB Function Reference)

Serial date number

Syntax

N = datenum(str)
N = datenum(str,P)
N = datenum(Y,M,D)
N = datenum(Y,M,D,H,MI,S)

Description

The datenum function converts date strings and date vectors into serial date numbers. Date numbers are serial days elapsed from some reference date. By default, the serial day 1 corresponds to 1-Jan-0000.

N = datenum(str)

converts the date string str into a serial date number. Date strings with two-character years, e.g., 12-june-12, are assumed to lie within the 100-year period centered about the current year.

NOTE
The string str must be in one of the date formats 0, 1, 2, 6, 13, 14, 15, or 16 as defined by datestr.

N = datenum(str,P)

assumes that two-character years lie within the 100-yearperiod beginning with the pivot year p. The default pivot year is the current year minus 50 years.

N = datenum(Y,M,D)

returns the serial date number for corresponding elements of the Y, M, and D (year, month, day) arrays. Y, M, and D must be arrays of the same size (or any can be a scalar). Values outside the normal range of each array are automatically "carried" to the next unit.

N = datenum(Y,M,D,H,MI,S)

returns the serial date number for corresponding elements of the Y, M, D, H, MI, and S (year, month, hour, minute, and second) array values. Y, M, D, H, MI, and S must be arrays of the same size (or any can be a scalar).

Examples

Convert a date string to a serial date number.

n = datenum('19-May-1995')

n =

      728798

Specifying year, month, and day, convert a date to a serial date number.

n = datenum(1994,12,19)

n =

      728647

Convert a date string to a serial date number using the default pivot year

n = datenum('12-june-12')

n =

      735032

Convert the same date string to a serial date number using 1900 as the pivot year.

n = datenum('12-june-12', 1900)

n =

      698507