Main Content


Duration in days



D = days(X) returns an array of days equivalent to the values in X.

  • If X is a numeric array, then D is a duration array in units of fixed-length days. A fixed-length day is equal to 24 hours.

  • If X is a duration array, then D is a double array with each element equal to the number of fixed-length (24-hour) days in the corresponding element of X.

The days function converts between duration and double values. To display a duration in units of days, set its Format property to 'd'.


collapse all

X = magic(2);
D = days(X)
D = 2x2 duration
    1 day   3 days
   4 days   2 days

Add each number of fixed-length days to the current date and time.

t = datetime('now') + D
t = 2x2 datetime
   13-Feb-2024 23:28:37   15-Feb-2024 23:28:37
   16-Feb-2024 23:28:37   14-Feb-2024 23:28:37

Create a duration array.

X = hours(23:20:95) + minutes(45)
X = 1x4 duration
   23.75 hr   43.75 hr   63.75 hr   83.75 hr

Convert each duration in X to a number of days.

D = days(X)
D = 1×4

    0.9896    1.8229    2.6562    3.4896

Input Arguments

collapse all

Input array, specified as a numeric array, duration array, or logical array.


  • days creates fixed-length (24 hour) days. To create days that account for Daylight Saving Time shifts when used in calendar calculations, use the caldays function.

Extended Capabilities

Version History

Introduced in R2014b

See Also