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

title	description	menu	weight
date.second() function	`date.second()` returns the second of a specified time. Results range from `[0 - 59]`.	flux_v0_ref name parent identifier date.second date date/second	101

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

Function type signature

(t: A) => int where A: Timeable

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

t

({{< req >}}) 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
• Return the second of a relative duration
• Return the current second

Return the second of a time value

import "date"

date.second(t: 2020-02-11T12:21:03.29353494Z)// Returns 3

Return the second of a relative duration

import "date"

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

date.second(t: -50s)// Returns 28

Return the current second

import "date"

date.second(t: now())