mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-04-25 23:57:20 -04:00
de725aef80
This adds some clarifications on the time unit strings the function takes as arguments, noting the differences between these and the time span literals, as well as the abbreviations' source.
33 lines
1.1 KiB
Text
Generated
33 lines
1.1 KiB
Text
Generated
// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
|
|
|
|
*Description*
|
|
|
|
Subtracts the `startTimestamp` from the `endTimestamp` and returns the difference in multiples of `unit`. If `startTimestamp` is later than the `endTimestamp`, negative values are returned.
|
|
|
|
[cols="^,^",role="styled"]
|
|
|===
|
|
2+h|Datetime difference units
|
|
|
|
s|unit
|
|
s|abbreviations
|
|
|
|
| year | years, yy, yyyy
|
|
| quarter | quarters, qq, q
|
|
| month | months, mm, m
|
|
| dayofyear | dy, y
|
|
| day | days, dd, d
|
|
| week | weeks, wk, ww
|
|
| weekday | weekdays, dw
|
|
| hour | hours, hh
|
|
| minute | minutes, mi, n
|
|
| second | seconds, ss, s
|
|
| millisecond | milliseconds, ms
|
|
| microsecond | microseconds, mcs
|
|
| nanosecond | nanoseconds, ns
|
|
|===
|
|
|
|
Note that while there is an overlap between the function's supported units and
|
|
{esql}'s supported time span literals, these sets are distinct and not
|
|
interchangeable. Similarly, the supported abbreviations are conveniently shared
|
|
with implementations of this function in other established products and not
|
|
necessarily common with the date-time nomenclature used by {es}.
|