---
title: array.toTime() function
description: array.toTime() converts all values in an array to times.
url: https://docs.influxdata.com/flux/v0/stdlib/experimental/array/totime/
estimated_tokens: 735
product: Flux
version: v0
---

# array.toTime() function

-   Flux 0.184.0+
-   View InfluxDB support

`array.toTime()` is experimental and [subject to change at any time](/flux/v0/stdlib/experimental/#experimental-packages-are-subject-to-change).

`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](/flux/v0/data-types/basic/time/#time-syntax) representation (RFC3339 timestamps).
-   `[uint]` (parsed as nanosecond epoch timestamps)

##### Function type signature

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

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### arr

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

## Examples

### Convert an array of integers to time values

```js
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]

```

[type-conversions](/flux/v0/tags/type-conversions/)