github-mirrors/elasticsearch
1
0
Fork 0
mirror of https://github.com/elastic/elasticsearch.git synced 2025-06-28 17:34:17 -04:00
Code Issues Projects Releases Packages Wiki Activity

Add note about optional times and epochs (#105786)

Browse source
This commit is contained in:
Benjamin Trent 2024-03-05 08:44:03 -05:00 • committed by GitHub
parent 4f2c8ca078
commit 61b3d98227
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 5 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

5
docs/reference/mapping/params/format.asciidoc
View file

@ -70,6 +70,11 @@ The following tables lists all the defaults ISO formats supported:
(separated by `T`), is optional.
Examples: `yyyy-MM-dd'T'HH:mm:ss.SSSZ` or `yyyy-MM-dd`.
NOTE: When using `date_optional_time`, the parsing is lenient and will attempt to parse
numbers as a year (e.g. `292278994` will be parsed as a year). This can lead to unexpected results
when paired with a numeric focused format like `epoch_second` and `epoch_millis`.
It is recommended you use `strict_date_optional_time` when pairing with a numeric focused format.
[[strict-date-time-nanos]]`strict_date_optional_time_nanos`::
A generic ISO datetime parser, where the date must include the year at a minimum, and the time