# foundryts.functions.time\_extent

## foundryts.functions.time\_extent()

Returns a function that extracts the time extent (earliest and latest timestamps) of a single time series.

The returned function computes the time extent by identifying the range from the first to the last timestamp
in the given time series.

* **Returns:**
  A function that accepts a single time series and returns its time extent. The dataframe contains a single row
  with the time extent.
* **Return type:**
  ([FunctionNode](../nodes-function-node/index.md#foundryts.nodes.FunctionNode)) -> SummarizerNode

## Dataframe schema

| Column name               | Type             | Description                                 |
|---------------------------|------------------|---------------------------------------------|
| extent.earliest\_timestamp | pandas.Timestamp | Timestamp of the first point in the series. |
| extent.latest\_timestamp   | pandas.Timestamp | Timestamp of the last point in the series.  |

## Examples

```pycon
>>> series = F.points(
...     (1, 0.0),
...     (101, 10.2),
...     (200, 11.3),
...     (123450, 11.8),
... )
>>> series.to_pandas()
                      timestamp  value
0 1970-01-01 00:00:00.000000001    0.0
1 1970-01-01 00:00:00.000000101   10.2
2 1970-01-01 00:00:00.000000200   11.3
3 1970-01-01 00:00:00.000123450   11.8
```

```pycon
>>> time_ext = F.time_extent()(series)
>>> time_ext.to_pandas()
      extent.earliest_timestamp       extent.latest_timestamp
0 1970-01-01 00:00:00.000000001 1970-01-01 00:00:00.000123450
```