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:

(Auto-migrated image: description temporarily unavailable)

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:

    (Auto-migrated image: description temporarily unavailable)

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

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.