second

Second number

Syntax

s = second(t)

s = second(t,secondType)

Description

s = second(t) returns the second values, including a fractional part, for the datetime values in t. The s output is a double array the same size as t and contains values from 0 to less than 60.

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.

s = second(t,secondType) returns the type of second number specified by secondType.

The second function returns the second numbers of datetime values. To assign second values to datetime array t, use t.Second and modify the Second property.

Examples

Find Second Number of Datetime Values

t1 = datetime('now','Format','dd-MMM-yyyy HH:mm:ss.SSS');
t = t1 + seconds(30:15:60)

t = 1x3 datetime
Columns 1 through 2

   21-Feb-2023 14:28:23.311   21-Feb-2023 14:28:38.311

Column 3

   21-Feb-2023 14:28:53.311

s = second(t)

s = 1×3

   23.3112   38.3112   53.3112

Input Arguments

t — Input date and time

datetime array

Input date and time, specified as a datetime array.

secondType — Type of second values

'secondofminute' (default) | 'secondofday'

Type of second values, specified as either 'secondofminute' or 'secondofday'.

• If secondType is 'secondofminute', then second returns the second of the minute.

• If secondType is 'secondofday', then second returns the second of the day, which (except for leap seconds) is in the range [0, 86400).

Extended Capabilities

Tall Arrays

Calculate with arrays that have more rows than fit in memory.

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

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).