vy commented on code in PR #4130: URL: https://github.com/apache/logging-log4j2/pull/4130#discussion_r3395414030
########## src/site/antora/modules/ROOT/pages/manual/pattern-layout.adoc: ########## @@ -450,6 +454,15 @@ The predefined _named_ formats are: You can also use a set of braces containing a time zone id per https://docs.oracle.com/javase/{java-target-version}/docs/api/java/util/TimeZone.html#getTimeZone(java.lang.String)[`TimeZone#getTimeZone(String)`]. If no date format specifier is given, then the `DEFAULT` format is used. +The conversion supports supplying an optional timezone and/or a locale. A locale tag in https://www.rfc-editor.org/rfc/bcp/bcp47.txt[BCP 47] format (for example, `de-DE` or `fr-FR`) can be supplied to control locale-sensitive formatting such as month and day names. + +When only two brace arguments are provided (pattern plus one additional argument), the second argument is interpreted as follows: + +- If the value matches a known `TimeZone` ID, it is treated as a timezone ID (timezone always takes precedence). +- Otherwise, if the value is a valid BCP 47 language tag, it is treated as a locale tag. + +To supply both a timezone and a locale, use the three-argument form: `%d{pattern}{timezone}{locale}`. + Review Comment: This is not applicable anymore. Please revert this paragraph. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
