[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:
Przemyslaw Gomulka 2020-08-20 16:03:58 +02:00 committed by GitHub
parent 890f943d0f
commit 62baca74ed
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 12 deletions

View File

@ -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)::
+