hms

Hour, minute, and second numbers of duration

collapse all in page

Syntax

Description

example

[h,m,s] = hms(t) returns the hour, minute, and second values of the datetime values in t as separate numeric arrays. The h and m outputs contain integer values, and the s output can contain a fractional part. h, m, and s are the same size as t.

Calling hms is equivalent to calling the hour, minute, and second functions.

Examples

collapse all

Open Script
t1 = datetime('now','Format','HH:mm:ss.SSS');
t = t1 + minutes(0:45:135)

[h,m,s] = hms(t)

t = 

  1×4 datetime array

   16:34:17.618   17:19:17.618   18:04:17.618   18:49:17.618


h =

    16    17    18    18


m =

    34    19     4    49


s =

   17.6180   17.6180   17.6180   17.6180

hms returns the hour, minute, and second numbers in separate arrays.

Input Arguments

collapse all

Input date and time, specified as a datetime array.

Output Arguments

collapse all

Hour numbers, returned as a numeric array of integer values from 0 to 23. The h output is of type double and is the same size as t.

Minute numbers, returned as a numeric array of integer values from 0 to 59. The m output is of type double and is the same size as t.

Second numbers, returned as a numeric array of values from 0 to less than 60, and can include a fractional part. For datetime values whose time zone is UTCLeapSeconds, the s output can contain a value between 60 and 61 for times that fall during a leap second occurrence. The s output is of type double and is the same size as t.

More About

collapse all

Tall Array Support

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

See Also

| | |

Introduced in R2014b

Was this topic helpful?
MATLAB Documentation
Other Documentation
Support