Changing display locale for Confluence Date Picker Macro
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
The Date Picker Macro for Confluence will display the Month according to the system locale by default.
For example, if a Confluence hosted in Ubuntu that is using zh_TW.UTF-8
as its default locale, a Date Picker Macro will be displayed as below in the Confluence:

Another example is the following would be seen in the date picker when the OS locale is been set to Korean:
1
23 8월 2018
Solution
To change the display format for Confluence Date Picker Macro, aside from changing the System Locale, the following JVM Parameters can be added:
1
-Duser.language=en -Duser.country=US
ℹ️ The Internationalization: Understanding Locale in the Java Platform documentation from Oracle contains further information on the different codes to be set for language and country codes.
The details steps for adding the parameters is explained in this article - Configuring System Properties.
Date Picker Macro will display as below with the JVM Parameters in place:
Commonly used Locales
Commonly used language codes:
Language | Code |
---|---|
Arabic | ar |
German | de |
English | en |
Spanish | es |
Japanese | ja |
Hebrew | he |
Examples of commonly used Country codes:
Country | Code |
---|---|
United States | US |
Australia | AU |
Canada | CA |
France | FR |
Japan | JP |
Germany | DE |
Was this helpful?