---
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: 274
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/experimental/array/totime/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.184.0+

InfluxDB support

> [!Important]
> `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

```
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/)