Loading
Set Up and Maintain Your Salesforce Organization
Table of Contents
Filter by (0)Add
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

            Search all of Salesforce Help
            Search all of Salesforce Help
            Adopt the ICU Locale Formats

            You are here:

            1. Salesforce Help
            2. Docs
            3. Set Up and Maintain Your Salesforce Organization

            Adopt the ICU Locale Formats

            The ICU locale format release update is available for all orgs. Review the high-level process to successfully migrate to the new International Components for Unicode (ICU) locale formats. Some of the formats differ from the ones provided by Oracle’s Java Development Kit (JDK). Understand how to determine the impact of changes on your org, and learn about the updates required to support the new formats.

            Required Editions

            Available in: both Salesforce Classic and Lightning Experience
            Available in: all editions
            Note
            Note

            This update was first made available in Winter ’20. Orgs created in Winter ’20 or later have ICU locale formats enabled by default.

            Orgs that haven’t already switched to ICU locale formats are encouraged to manually update.

            Here’s the step-by-step process to migration from JDK to ICU locale formats.

            1. Determine whether your org is using ICU or JDK locale formats.

              Before you start, determine which formats you’re using and whether these instructions apply to you.

            2. Review the considerations for adopting ICU.

              Learn why Salesforce chose to adopt the ICU locale formats. Then review recommendations, including where to test and how to handle installed packages and custom code.

            3. Determine how the ICU locale formats affect your org.

              Your migration effort depends on the locales used in your org. Use an SOQL query and report to identify the locales in use, then identify the specific changes for those locales to be included in testing.

            4. Enable the ICU locale formats in a sandbox.

              Before enabling the new formats in production, we highly recommend that you test the ICU locale formats in a sandbox.

            5. Update your Apex Classes, Apex Triggers, and Visualforce Pages to API version 45.0 or later

              To avoid data integrity issues and end-user confusion, update your Apex classes, Apex triggers, and Visualforce pages to API version 45.0 or later. If these components use API version 44.0 or earlier, they return Oracle’s Java Development Kit (JDK) locale formats.

            6. Update custom code for the ICU locale formats.

              When an org migrates from JDK locale formats to ICU locale formats, users see the new formats automatically in standard Salesforce fields and functionality. However, custom code can require adjustments. Learn how to use locale-neutral formats to prevent issues when locale formats change and see examples of common issues.

            7. Test the ICU locale formats in a sandbox.

              Run your standard functional tests and targeted tests of functionality that processes or produces locale formats. Test your results in each of the affected locales that is used in your org. If you find any issues, update your org and test again.

            8. Notify your users and partners.

              Let your users know when you plan to enable ICU in production and how the new locales can affect them. Otherwise, the differences between JDK and ICU locale formats can cause confusion. Reaching everyone can require multiple reminders before and after you enable ICU in production.

              Also consider notifying your partners, especially if those partners send information to or extract information from Salesforce. Resolving issues related to integrations can require their assistance.

            9. Enable the ICU locale formats in production.

              After you test the ICU locale formats in a sandbox and identify the required adjustments, enable the ICU locale formats in production. Then make those same adjustments.

            10. Test the ICU locale formats again in production.

              To account for any variation between your sandbox and production orgs, run your standard functional tests. Also, test functionality that processes locale formats. If you find any issues, update your org, then test again. After you successfully validate the functionality in production, mark the release update as complete.

            See Also

             
            Loading
            Salesforce Help | Article