[doc] Improve joda-time migration guide (#60499)
Previously migration guide incorrectly stated that joda-time patterns have to be fixed before upgrading to 7.x since (7.7) #52555 and our bwc policy 6.x created indices even with joda-time are supported relates #60374
This commit is contained in:
parent
890f943d0f
commit
62baca74ed
|
@ -5,16 +5,23 @@ With 7.0, {es} switched from joda time to java time for date-related parsing,
|
|||
formatting, and calculations. This guide is designed to help you determine
|
||||
if your cluster is impacted and, if so, prepare for the upgrade.
|
||||
|
||||
You do not need to convert joda-time date formats to java time for indices
|
||||
created in {es} 6.8 before upgrading to 7.7 or later versions. However, mappings
|
||||
for indices created in 7.7 and later versions must use java-time formats.
|
||||
|
||||
To ensure new indices use java-time formats, we recommend you update any ingest
|
||||
pipelines and index templates created in 6.8 to java time before upgrading. See:
|
||||
|
||||
* <<java-time-migration-update-ingest-pipelines>>
|
||||
* <<java-time-migration-update-index-templates>>
|
||||
|
||||
Indices created in versions 7.0-7.6 cannot use joda time. This was fixed
|
||||
was in 7.7 with {es-pull}52555[#52555].
|
||||
[discrete]
|
||||
[[java-time-convert-date-formats]]
|
||||
=== Convert date formats
|
||||
|
||||
To upgrade to 7.0, you'll need to convert any joda-time date formats
|
||||
to their java-time equivalents.
|
||||
|
||||
To help track this effort, you can prefix java-time date formats with an `8`
|
||||
in {es} 6.8 and later versions.
|
||||
|
||||
To use java time in 6.8, prefix the date format with an `8`.
|
||||
For example, you can change the date format `YYYY-MM-dd` to `8yyyy-MM-dd` to
|
||||
indicate the date format uses java time.
|
||||
|
||||
|
@ -51,7 +58,7 @@ or the {kibana-ref}/upgrade-assistant.html[Kibana upgrade assistant].
|
|||
[[java-time-migration-incompatible-date-formats]]
|
||||
==== Incompatible date formats
|
||||
Custom date formats containing the following joda-time literals should be
|
||||
changed before upgrading.
|
||||
converted to their java-time equivalents.
|
||||
|
||||
`Y` (Year of era)::
|
||||
+
|
||||
|
|
Loading…
Reference in New Issue