days

Duration in days

Syntax

Description

example

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'.

Examples

collapse all

X = magic(2);
D = days(X)
D = 

  2×2 duration array

    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 = 

  2×2 datetime array

   09-Aug-2016 16:42:49   11-Aug-2016 16:42:49
   12-Aug-2016 16:42:49   10-Aug-2016 16:42:49

Create a duration array.

X = hours(23:20:95) + minutes(45)
X = 

  1×4 duration array

   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 =

    0.9896    1.8229    2.6562    3.4896

Input Arguments

collapse all

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

More About

collapse all

Tall Array Support

This function fully supports tall arrays. For more information, see Tall Arrays.

Tips

  • 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.

See Also

|

Introduced in R2014b

Was this topic helpful?