# bin_start_time¶

## Description¶

Returns the start time of the current bin (inclusive). Can only be used with timechart.

timestamp

## Domain¶

This is a scalar function (calculates a single output value for a single input row.)

## Usage¶

bin_start_time( )


## Examples¶

timechart 10m, first_to_bin_start:min(timestamp - bin_start_time()), group_by(key)


Create a column named “first_to_bin_start” that contains the difference between the first data point in the bin and the bin’s start time.