docs-v2/content/flux/v0.x/stdlib/date/second.md

1.0 KiB

title description aliases menu weight introduced
date.second() function The `date.second()` function returns the second of a specified time. Results range from `[0-59]`.
/influxdb/v2.0/reference/flux/functions/date/second/
/influxdb/v2.0/reference/flux/stdlib/date/second/
/influxdb/cloud/reference/flux/stdlib/date/second/
flux_0_x_ref
name parent
date.second date
301 0.37.0

The date.second() function returns the second of a specified time. Results range from [0-59].

import "date"

date.second(t: 2019-07-17T12:05:21.012Z)

// Returns 21

Parameters

t

The time to operate on. Use an absolute time, relative duration, or integer. Durations are relative to now().

Examples

Return the second of a time value
import "date"

date.second(t: 2020-02-11T12:21:03.293534940Z)

// Returns 3
Return the second of a relative duration
import "date"

option now = () => 2020-02-11T12:21:03.293534940Z

date.second(t: -50s)

// Returns 13