docs-v2/content/flux/v0/stdlib/experimental/array/totime.md

title	description	menu	weight	flux/v0/tags	introduced
array.toTime() function	`array.toTime()` converts all values in an array to times.	flux_v0_ref name parent identifier array.toTime experimental/array experimental/array/toTime	201	type-conversions	0.184.0

array.toTime() converts all values in an array to times.

Supported array types

• [int] (parsed as nanosecond epoch timestamps)
• [string] with values that use time literal representation (RFC3339 timestamps).
• [uint] (parsed as nanosecond epoch timestamps)

Function type signature

(<-arr: [A]) => [time]

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

Parameters

arr

Array of values to convert. Default is the piped-forward array (<-).

Examples

Convert an array of integers to time values

import "experimental/array"

arr = [1640995200000000000, 1643673600000000000, 1646092800000000000]

array.toTime(arr: arr)// Returns [2022-01-01T00:00:00Z, 2022-02-01T00:00:00Z, 2022-03-01T00:00:00Z]