diff --git a/docs/reference/elasticsearch/mapping-reference/mapping-date-format.md b/docs/reference/elasticsearch/mapping-reference/mapping-date-format.md index 886e1e267f128..603b2422ac7c2 100644 --- a/docs/reference/elasticsearch/mapping-reference/mapping-date-format.md +++ b/docs/reference/elasticsearch/mapping-reference/mapping-date-format.md @@ -27,7 +27,7 @@ Many APIs which support date values also support [date math](/reference/elastics ## Custom date formats [custom-date-formats] -Completely customizable date formats are supported. The syntax for these is explained in [DateTimeFormatter docs](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.md). +Completely customizable date formats are supported. The syntax for these is explained in [DateTimeFormatter docs](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.html). Note that while the built-in formats for week dates use the ISO definition of weekyears, custom formatters using the `Y`, `W`, or `w` field specifiers use the JDK locale definition of weekyears. This can result in different values between the built-in formats and custom formats for week dates.