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

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

date.nanosecond() returns the nanoseconds for a specified time. Results range from [0-999999999].

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 nanosecond for a time value
• Return the nanosecond for a relative duration
• Return the current nanosecond unit

Return the nanosecond for a time value

import "date"

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

Return the nanosecond for a relative duration

import "date"

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

date.nanosecond(t: -2111984ns)// Returns 128412016

Return the current nanosecond unit

import "date"

date.nanosecond(t: now())