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

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

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

import "date"

date.nanosecond(t: 2019-07-17T12:05:21.012934584Z)

// Returns 12934584

Parameters

t

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

Examples

Return the nanosecond for a time value

import "date"

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

// Returns 293534940Z

Return the nanosecond for a relative duration

import "date"

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

date.nanosecond(t: -2111984ns)

// Returns 291422956