# from_epoch

Interprets a duration as Unix time.

```tql
from_epoch(x:duration) -> time
```

## Description

The `from_epoch` function interprets a duration as [Unix time](https://en.wikipedia.org/wiki/Unix_time).

### `x: duration`

The duration since the Unix epoch, i.e., 00:00:00 UTC on 1 January 1970.

## Examples

### Convert an integral Unix time

```tql
from {time: 1736525429}
time = from_epoch(time * 1s)
```

```tql
{time: 2025-01-10T16:10:29+00:00}
```

### Interpret a duration as Unix time

```tql
from {x: from_epoch(50y + 12w + 20m)}
```

```tql
{x: 2020-03-13T00:20:00.000000}
```

## See Also

* [`now`](https://preview.docs.tenzir.com/375/375/reference/functions/now.md)
* [`since_epoch`](https://preview.docs.tenzir.com/375/375/reference/functions/since_epoch.md)
* [Work with time](https://preview.docs.tenzir.com/375/375/guides/transformation/work-with-time.md)
* [Learn idiomatic TQL](https://preview.docs.tenzir.com/375/375/tutorials/learn-idiomatic-tql.md)