---
schema_version: "1"
id: 2a41ef731a5982fc5a164ee2f181afd9c6274e995145a50edee7ef8456ed20c8
title: AuraLocalizationService
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/aura-platform/guides/aura/ref-jsapi/ref-jsapi-auralocalizationservice.md
canonical_url: https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 02493fce512a0ae2e0e8f7ce0ca9c5c778760267a813803bce2077db4bbba837
products:
  - Lightning Aura Components Developer Guide
  - Platform Developer Content
---

# AuraLocalizationService

`AuraLocalizationService` provides methods for formatting and localizing dates. Use `$A.localizationService` to use the methods in `AuraLocalizationService`.

## Methods

-   **[UTCToWallTime()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-utctowalltime.md)**  


    Converts a datetime from UTC to a specified timezone.

-   **[WallTimeToUTC](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-walltimetoutc.md)**  


    Converts a datetime from a specified timezone to UTC.

-   **[displayDuration()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-displayduration.md)**  


    Displays a length of time.

-   **[displayDurationInDays()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-displaydurationindays.md)**  


    Displays a length of time in days.

-   **[displayDurationInHours()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-displaydurationinhours.md)**  


    Displays a length of time in hours.

-   **[displayDurationInMilliseconds()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-displaydurationinmilliseconds.md)**  


    Displays a length of time in milliseconds.

-   **[displayDurationInMinutes()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-displaydurationinminutes.md)**  


    Displays a length of time in minutes.

-   **[displayDurationInMonths()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-displaydurationinmonths.md)**  


    Displays a length of time in months.

-   **[displayDurationInSeconds()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-displaydurationinseconds.md)**  


    Displays a length of time in seconds.

-   **[duration()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-duration.md)**  


    Returns an object representing a length of time.

-   **[endOf()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-endof.md)**  


    Returns a date that is the end of a unit of time for the given date.

-   **[formatCurrency()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-formatcurrency.md)**  


    Returns a currency number based on the default currency format.

-   **[formatDate()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-formatdate.md)**  


    Returns a formatted date.

-   **[formatDateTime()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-formatdatetime.md)**  


    Returns a formatted date time.

-   **[formatDateTimeUTC()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-formatdatetimeutc.md)**  


    Returns a formatted date time in UTC.

-   **[formatDateUTC()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-formatdateutc.md)**  


    Returns a formatted date in UTC.

-   **[formatNumber()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-formatnumber.md)**  


    Returns a formatted number with the default number format.

-   **[formatPercent()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-formatpercent.md)**  


    Returns a formatted percentage number based on the default percentage format.

-   **[formatTime()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-formattime.md)**  


    Returns a formatted time.

-   **[formatTimeUTC()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-formattimeutc.md)**  


    Returns a formatted time in UTC.

-   **[getDateStringBasedOnTimezone](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getdatestringbasedontimezone.md)**  


    Gets a date string based on a time zone.

-   **[getDaysInDuration()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getdaysinduration.md)**  


    Returns the number of days in a duration.

-   **[getDefaultCurrencyFormat()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getdefaultcurrencyformat.md)**  


    Returns the default currency format.

-   **[getDefaultNumberFormat()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getdefaultnumberformat.md)**  


    Returns the default `NumberFormat` object.

-   **[getDefaultPercentFormat()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getdefaultpercentformat.md)**  


    Returns the default percentage format.

-   **[getHoursInDuration()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-gethoursinduration.md)**  


    Returns a length of time in hours.

-   **[getLocalizedDateTimeLabels()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getlocalizeddatetimelabels.md)**  


    Deprecated. Do not use. Returns date time labels, such as month name, weekday name.

-   **[getMillisecondsInDuration()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getmillisecondsinduration.md)**  


    Returns the number of milliseconds in a duration.

-   **[getMinutesInDuration()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getminutesinduration.md)**  


    Returns the number of minutes in a duration.

-   **[getMonthsInDuration()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getmonthsinduration.md)**  


    Returns the number of months in a duration.

-   **[getNumberFormat()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getnumberformat.md)**  


    Returns a `NumberFormat` object.

-   **[getSecondsInDuration()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getsecondsinduration.md)**  


    Returns the number of seconds in a duration.

-   **[getToday](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-gettoday.md)**  


    Gets today’s date based on a time zone.

-   **[getYearsInDuration()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-getyearsinduration.md)**  


    Returns the number of years in a duration.

-   **[isAfter()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-isafter.md)**  


    Checks if `date1` is after `date2`.

-   **[isBefore()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-isbefore.md)**  


    Checks if `date1` is before `date2`.

-   **[isBetween()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-isbetween.md)**  


    Checks if `date` is between `fromDate` and `toDate`, where the match is inclusive.

-   **[isPeriodTimeView()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-isperiodtimeview.md)**  


    Deprecated. Do not use. Checks if a datetime pattern string uses a 24-hour or 12-hour time view.

-   **[isSame()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-issame.md)**  


    Checks if `date1` is the same as `date2`.

-   **[parseDateTime()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-parsedatetime.md)**  


    Parses a string and returns a JavaScript Date.

-   **[parseDateTimeISO8601()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-parsedatetimeiso8601.md)**  


    Parses a date time string in an ISO-8601 format and returns a JavaScript Date.

-   **[parseDateTimeUTC()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-parsedatetimeutc.md)**  


    Parses a string and returns a JavaScript Date.

-   **[startOf()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-startof.md)**  


    Returns a date that is the start of a unit of time for the given date.

-   **[toISOString()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-toisostring.md)**  


    Deprecated. Use `Date.toISOString()` instead.

-   **[translateFromLocalizedDigits()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-translatefromlocalizeddigits.md)**  


    Translate the localized digit string to a string with Arabic digits, if there is any.

-   **[translateFromOtherCalendar()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-translatefromothercalendar.md)**  


    Translates the input date from another calendar system (for example, the Buddhist calendar) to the Gregorian calendar based on the locale.

-   **[translateToLocalizedDigits()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-translatetolocalizeddigits.md)**  


    Translate the input string to a string with localized digits, if there is any.

-   **[translateToOtherCalendar()](https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-translatetoothercalendar.md)**  


    Translates the input date to a date in another calendar system (for example, the Buddhist calendar) based on the locale.


**See Also**  


-   [Formatting Dates in JavaScript](https://developer.salesforce.com/docs/platform/aura-platform/js-cb/js-cb-format-dates.md)

