---
title: toTime() function
description: toTime() converts all values in the _value column to time types.
url: https://docs.influxdata.com/flux/v0/stdlib/universe/totime/
estimated_tokens: 1022
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/universe/totime/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.7.0+

InfluxDB support

`toTime()` converts all values in the `_value` column to time types.

#### Supported data types

* string (RFC3339 timestamp)
* int
* uint

`toTime()` treats all numeric input values as nanosecond epoch timestamps.

##### Function type signature

```js
(<-tables: stream[{A with _value: B}]) => stream[{A with _value: B, _value: time}]
```

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

## Parameters

### tables

Input data. Default is piped-forward data (`<-`).

## Examples

### Convert an integer \_value column to times

```js
data
    |> toTime()
```

[](#view-example-input-and-output)

View example input and output

#### Input data

|       \_time       |      \_value      |\*tag|
|--------------------|-------------------|-----|
|2021-01-01T00:00:00Z|\-20000000000000000| t1  |
|2021-01-01T00:00:10Z|100000000000000000 | t1  |
|2021-01-01T00:00:20Z| 70000000000000000 | t1  |
|2021-01-01T00:00:30Z|170000000000000000 | t1  |
|2021-01-01T00:00:40Z|150000000000000000 | t1  |
|2021-01-01T00:00:50Z| 40000000000000000 | t1  |

|       \_time       |      \_value      |\*tag|
|--------------------|-------------------|-----|
|2021-01-01T00:00:00Z|190000000000000000 | t2  |
|2021-01-01T00:00:10Z| 40000000000000000 | t2  |
|2021-01-01T00:00:20Z|\-30000000000000000| t2  |
|2021-01-01T00:00:30Z|190000000000000000 | t2  |
|2021-01-01T00:00:40Z|130000000000000000 | t2  |
|2021-01-01T00:00:50Z| 10000000000000000 | t2  |

#### Output data

|       \_time       |      \_value       |\*tag|
|--------------------|--------------------|-----|
|2021-01-01T00:00:00Z|1969-05-14T12:26:40Z| t1  |
|2021-01-01T00:00:10Z|1973-03-03T09:46:40Z| t1  |
|2021-01-01T00:00:20Z|1972-03-21T04:26:40Z| t1  |
|2021-01-01T00:00:30Z|1975-05-22T14:13:20Z| t1  |
|2021-01-01T00:00:40Z|1974-10-03T02:40:00Z| t1  |
|2021-01-01T00:00:50Z|1971-04-08T23:06:40Z| t1  |

|       \_time       |      \_value       |\*tag|
|--------------------|--------------------|-----|
|2021-01-01T00:00:00Z|1976-01-09T01:46:40Z| t2  |
|2021-01-01T00:00:10Z|1971-04-08T23:06:40Z| t2  |
|2021-01-01T00:00:20Z|1969-01-18T18:40:00Z| t2  |
|2021-01-01T00:00:30Z|1976-01-09T01:46:40Z| t2  |
|2021-01-01T00:00:40Z|1974-02-13T15:06:40Z| t2  |
|2021-01-01T00:00:50Z|1970-04-26T17:46:40Z| t2  |

#### Related

* [Work with time types](/flux/v0/data-types/basic/time/)
* [time() function](/flux/v0/stdlib/universe/time/)

[transformations](/flux/v0/tags/transformations/)[type-conversions](/flux/v0/tags/type-conversions/)
| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | -20000000000000000 | t1 |
| 2021-01-01T00:00:10Z | 100000000000000000 | t1 |
| 2021-01-01T00:00:20Z | 70000000000000000 | t1 |
| 2021-01-01T00:00:30Z | 170000000000000000 | t1 |
| 2021-01-01T00:00:40Z | 150000000000000000 | t1 |
| 2021-01-01T00:00:50Z | 40000000000000000 | t1 |

| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | 190000000000000000 | t2 |
| 2021-01-01T00:00:10Z | 40000000000000000 | t2 |
| 2021-01-01T00:00:20Z | -30000000000000000 | t2 |
| 2021-01-01T00:00:30Z | 190000000000000000 | t2 |
| 2021-01-01T00:00:40Z | 130000000000000000 | t2 |
| 2021-01-01T00:00:50Z | 10000000000000000 | t2 |

| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | 1969-05-14T12:26:40Z | t1 |
| 2021-01-01T00:00:10Z | 1973-03-03T09:46:40Z | t1 |
| 2021-01-01T00:00:20Z | 1972-03-21T04:26:40Z | t1 |
| 2021-01-01T00:00:30Z | 1975-05-22T14:13:20Z | t1 |
| 2021-01-01T00:00:40Z | 1974-10-03T02:40:00Z | t1 |
| 2021-01-01T00:00:50Z | 1971-04-08T23:06:40Z | t1 |

| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | 1976-01-09T01:46:40Z | t2 |
| 2021-01-01T00:00:10Z | 1971-04-08T23:06:40Z | t2 |
| 2021-01-01T00:00:20Z | 1969-01-18T18:40:00Z | t2 |
| 2021-01-01T00:00:30Z | 1976-01-09T01:46:40Z | t2 |
| 2021-01-01T00:00:40Z | 1974-02-13T15:06:40Z | t2 |
| 2021-01-01T00:00:50Z | 1970-04-26T17:46:40Z | t2 |