Skip to content

Commit 00b56bf

Browse files
committed
Add note about negative epoch times (elastic#61379)
This commit adds a reminder to date type documentation that negative epoch times are not supported. relates elastic#40983
1 parent 08dbd6d commit 00b56bf

File tree

1 file changed

+3
-0
lines changed

1 file changed

+3
-0
lines changed

docs/reference/mapping/types/date.asciidoc

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,9 @@ JSON doesn't have a date data type, so dates in Elasticsearch can either be:
1010
* a long number representing _milliseconds-since-the-epoch_.
1111
* an integer representing _seconds-since-the-epoch_.
1212

13+
NOTE: Values for _milliseconds-since-the-epoch_ and _seconds-since-the-epoch_
14+
must be non-negative. Use a formatted date to represent dates before 1970.
15+
1316
Internally, dates are converted to UTC (if the time-zone is specified) and
1417
stored as a long number representing milliseconds-since-the-epoch.
1518

0 commit comments

Comments
 (0)