diff --git a/docs/changelog/136426.yaml b/docs/changelog/136426.yaml new file mode 100644 index 0000000000000..a66a81af6b028 --- /dev/null +++ b/docs/changelog/136426.yaml @@ -0,0 +1,6 @@ +summary: "Docs: clarify ESQL time span alias rules (month m/mm vs minute min/mi/n), note case-insensitive matching and optional whitespace, and add unambiguous examples." +area: ES|QL +type: docs +issues: + - 135552 +pr: 136426 diff --git a/docs/reference/query-languages/esql/esql-time-spans.md b/docs/reference/query-languages/esql/esql-time-spans.md index e9da009e7deff..3c0e71e0c5805 100644 --- a/docs/reference/query-languages/esql/esql-time-spans.md +++ b/docs/reference/query-languages/esql/esql-time-spans.md @@ -110,17 +110,30 @@ POST /_query ``` +### Duration units and matching rules + +Duration literals can be written with or without a space between the number and the unit +(for example, `1m` is equivalent to `1 m`). Matching is **case-insensitive**. + ## Supported temporal units [esql-time-spans-table] | Temporal Units | Valid Abbreviations | | --- | --- | | year | y, yr, years | | quarter | q, quarters | -| month | mo, months | +| month | m, mm, month, months | | week | w, weeks | | day | d, days | | hour | h, hours | -| minute | min, minutes | +| minute | min, mi, n, minute, minutes | | second | s, sec, seconds | | millisecond | ms, milliseconds | +**Examples** + +```esql +FROM t | WHERE date_col > NOW() - 1m // month (same as: 1 m) +FROM t | WHERE ts > NOW() - 1mi // minute +FROM t | WHERE ts > NOW() - 1n // minute +FROM t | WHERE ts > NOW() - 500ms // millisecond +```