# since_epoch

Interprets a time value as duration since the Unix epoch.

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

## Description

The `since_epoch` function turns a time value into a duration since the [Unix epoch](https://en.wikipedia.org/wiki/Unix_time), i.e., since 00:00:00 UTC on January 1970.

## Examples

### Retrive the Unix time for a given date

```tql
from { x: since_epoch(2021-02-24) }
```

```tql
{x: 18682.0d}
```

## See Also

* [`from_epoch`](https://preview.docs.tenzir.com/375/375/reference/functions/from_epoch.md)
* [`now`](https://preview.docs.tenzir.com/375/375/reference/functions/now.md)
* [Work with time](https://preview.docs.tenzir.com/375/375/guides/transformation/work-with-time.md)