---
schema_version: "1"
id: bf37ed9dfd19b335e8f946758c533b456510195c21ac43f9848a1ac3e888446a
title: Localization
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/aura-platform/guides/aura/components/components-l10n.md
canonical_url: https://developer.salesforce.com/docs/platform/aura-platform/guide/components-l10n.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 6e0c06dda15f2f68dd6cf83e3bde1b8d1db3967bb606a8f999eb2aa059de043f
products:
- Lightning Aura Components Developer Guide
- Platform Developer Content
---
# Localization
The framework provides client-side localization support on input and output components.
You can use the global value provider, [`$Locale`](https://developer.salesforce.com/docs/platform/aura-platform/expr/expr-locale-value-provider.md), to obtain the locale information. The locale setting in your organization overrides the browser’s locale information. Lightning base components adapt automatically to the language, locale, and time zone settings of the Salesforce org they run in.
## Working with Locale, Language, and Timezone
In a single currency organization, Salesforce administrators set the currency locale, default language, default locale, and default time zone for their organizations. Users can set their individual language, locale, and time zone on their personal settings pages.
**note:** Single language organizations cannot change their language, although they can change their locale.
If you’re working with Salesforce data, we recommend using the base components built on Lightning Data Service. For example, the `lightning:recordForm` and `lightning:recordViewForm` components can display a read-only value of your record data. See [Lightning Data Service](https://developer.salesforce.com/docs/platform/aura-platform/data-service/data-service.md).
Consider the `lightning:formatted*` components only if the `lightning:record*Form` components don’t meet your requirements.
Let’s take a look at the `lightning:formattedDateTime` component to display a date and time. Setting the time zone on the Language & Time Zone page to `(GMT+02:00)` returns the date and time like `Sep 28, 2020, 11:13 AM` when you run the following code.
```nolang
```
Changing the user locale to `French (France)` returns the date and time like `28 sept. 2020 à 11:13`. Running `$A.get("$Locale.userLocaleCountry")` returns the user’s locale, for example, `FR`.
For more information, see [Supported Locales and ICU Formats](https://help.salesforce.com/articleView?id=admin_locales_icu.htm).
To display a currency value, use `lightning:formattedNumber`. Setting the currency locale on the Company Information page to `Japanese (Japan) - JPY` returns `¥100,000` when you run the following code.
```nolang
```
Similarly, running `$A.get("$Locale.currency")` returns `"¥"` when your org’s currency locale is set to `Japanese (Japan) - JPY`. For more information, see [Supported Locales and ICU Formats](https://help.salesforce.com/articleView?id=admin_locales_icu.htm)" in the Salesforce Help.
## Working with Address, Name, and Number Formats
The user’s locale determines the name and address formats. Numbers, including currency, decimal, and percentage are also formatted according to the user’s locale. See [Supported Locales and ICU Formats](https://help.salesforce.com/articleView?id=admin_locales_icu.htm).
To get user input for an address, use [`lightning:inputAddress`](https://developer.salesforce.com/docs/component-library/bundle/lightning:inputAddress). For a read-only output of an address, use [`lightning:formattedAddress`](https://developer.salesforce.com/docs/component-library/bundle/lightning:formattedAddress). The default output displays an address that links to Google Maps.
To get user input for a person’s name, use [`lightning:inputName`](https://developer.salesforce.com/docs/component-library/bundle/lightning:inputName). For a read-only output of a name, use [`lightning:formattedName`.](https://developer.salesforce.com/docs/component-library/bundle/lightning:formattedName)
To get user input for a number, including currency, decimal, and percentage, use [`lightning:input`](https://developer.salesforce.com/docs/component-library/bundle/lightning:input) with `number` type. For a read-only output of a number, use [`lightning:formattedNumber`.](https://developer.salesforce.com/docs/component-library/bundle/lightning:formattedNumber)
## Working with Date and Time Formats
To get user input for a date and time, use [`lightning:input`](https://developer.salesforce.com/docs/component-library/bundle/lightning:input) with type `date`, `datetime`, or `time`. To customize the date and time formats, we recommend using [`lightning:formattedDateTime`](https://developer.salesforce.com/docs/component-library/bundle/lightning:formattedDateTime) or [`lightning:formattedTime`](https://developer.salesforce.com/docs/component-library/bundle/lightning:formattedTime).
This example sets the date and time from a Date object using the `init` handler. The `timeZone` attribute is optional and is used to override the default timezone based on the user’s location.
```nolang
```
```javascript
({
doInit : function(component, event, helper) {
var date = new Date();
component.set("v.datetime", date);
}
})
```
This example renders the date in the format `MMM DD, YYYY HH:MM:SS AM`. Refer to the component reference for examples on how you can display the date in a different format.
**See Also**
- [Formatting Dates in JavaScript](https://developer.salesforce.com/docs/platform/aura-platform/js-cb/js-cb-format-dates.md)