import type { FunctionDefinition } from '../../definition_types';
/**
 * Creates groups of values - buckets - out of a `@timestamp` attribute using either a fixed step width
 * or a target bucket count.
 * Unlike `TBUCKET`,
 * which aligns buckets to calendar boundaries, TSTEP uses a fixed-width UTC grid anchored at the start
 * of the query range. Each bucket is labeled by its right boundary.
 * When a target bucket count is provided, TSTEP derives a fixed step width from the query range.
 * The derived step is rounded up so that the result uses no more than the target number of buckets.
 *
 * When using ES|QL in Kibana, the range can be derived automatically from the
 * `@timestamp` filter
 * that Kibana adds to the query.
 *
 * @example
 * FROM sample_data
 * | STATS min = MIN(@timestamp), max = MAX(@timestamp) BY bucket = TSTEP(1 hour)
 * | SORT bucket
 *
 * @example
 * FROM sample_data
 * | STATS min = MIN(@timestamp), max = MAX(@timestamp) BY bucket = TSTEP(1 hour, "2023-10-23T12:15:00.000Z", "2023-10-23T13:55:01.543Z")
 * | SORT bucket
 *
 * @example
 * FROM sample_data
 * | STATS min = MIN(@timestamp), max = MAX(@timestamp) BY bucket = TSTEP(2, "2023-10-23T12:15:00.000Z", "2023-10-23T14:15:00.000Z")
 * | SORT bucket
 */
declare const definition: FunctionDefinition;
export default definition;
//# sourceMappingURL=tstep.d.ts.map