docs-v2/content/influxdb/cloud/reference/flux/stdlib/date/second.md

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

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

Function type: Transformation

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().

Data type: Time | Duration

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