---
title: high_time() | Tiger Data Docs
description: Get the timestamp corresponding to the high time from a candlestick aggregate
---

Since [1.14.0](https://github.com/timescale/timescaledb-toolkit/releases/tag/1.14.0)

Get the timestamp corresponding to the high time from a candlestick aggregate.

## Arguments

The syntax is:

```
high_time(
    candlestick Candlestick
) RETURNS TIMESTAMPTZ
```

| Name        | Type        | Default | Required | Description           |
| ----------- | ----------- | ------- | -------- | --------------------- |
| candlestick | Candlestick | -       | ✔        | Candlestick aggregate |

## Returns

| Column     | Type        | Description                                                                                                                                                                                                                                                                                                  |
| ---------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| high\_time | TIMESTAMPTZ | The time at which the high price occurred. If more than one tick has the high price, which of their times is returned depends on the order in which the aggregate processes the input. To get the earliest, order the aggregate input by `ts`, for example `candlestick_agg(ts, price, volume ORDER BY ts)`. |
