Package org.elasticsearch.xpack.esql.core.querydsl

Class QueryDslTimestampBoundsExtractor

java.lang.Object

org.elasticsearch.xpack.esql.core.querydsl.QueryDslTimestampBoundsExtractor

public final class QueryDslTimestampBoundsExtractor
extends Object

Extracts @timestamp bounds from Query DSL filters.

Used by PromQL planning to infer implicit start/end bounds from request filters.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	QueryDslTimestampBoundsExtractor.TimestampBounds	Represents the @timestamp lower and upper bounds extracted from a query DSL filter.

Method Summary

Modifier and Type	Method	Description
static QueryDslTimestampBoundsExtractor.TimestampBounds	extractTimestampBounds(QueryBuilder filter)	Extracts the @timestamp range bounds from a query DSL filter.
static QueryDslTimestampBoundsExtractor.TimestampBounds	extractTimestampBounds(QueryBuilder filter, LongSupplier nowSupplier)	Extracts the @timestamp range bounds from a query DSL filter using the supplied now value to resolve date math expressions consistently with the current request.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

extractTimestampBounds

@Nullable
public static QueryDslTimestampBoundsExtractor.TimestampBounds extractTimestampBounds(@Nullable
 QueryBuilder filter)

Extracts the @timestamp range bounds from a query DSL filter.

Supports:

• RangeQueryBuilder directly on @timestamp
• BoolQueryBuilder with the range nested in filter or must clauses

Parameters:

filter - the query DSL filter to inspect, may be null

Returns:

extracted bounds, or null when no @timestamp range is found or bounds cannot be parsed

extractTimestampBounds

@Nullable
public static QueryDslTimestampBoundsExtractor.TimestampBounds extractTimestampBounds(@Nullable
 QueryBuilder filter,
 LongSupplier nowSupplier)

Extracts the @timestamp range bounds from a query DSL filter using the supplied now value to resolve date math expressions consistently with the current request.