JavaScript Date toLocaleString() Method

Definition and Usage

toLocaleString() Methods use locale settings to convert Date objects to strings.

The default language depends on the regional settings on your computer.

Example

Use locale conventions to convert Date objects to strings:

var d = new Date();
var n = d.toLocaleString();

Try it yourself

Syntax

Date.toLocaleString(locales, options)

Parameter Value

Parameter Description

locales

Try it

Optional. To use language-specific formats.

Click the "Try it" button to view all running values.

Valid Values:

  • ar-SA Arabic (Saudi Arabia)
  • bn-BD Bangla (Bangladesh)
  • bn-IN Bengali (India)
  • cs-CZ Czech (Czech Republic)
  • da-DK Danish (Denmark)
  • de-AT Austrian German
  • de-CH "Swiss" German
  • de-DE Standard German (used in Germany)
  • el-GR Modern Greek
  • en-AU Australian English
  • en-CA Canadian English
  • en-GB British English
  • en-IE Irish English
  • en-IN Indian English
  • en-NZ New Zealand English
  • en-US American English
  • en-ZA English (South Africa)
  • es-AR Argentinian Spanish
  • es-CL Chilean Spanish
  • es-CO Colombian Spanish
  • es-ES Castilian Spanish (used in central and northern Spain)
  • es-MX Mexican Spanish
  • es-US American Spanish
  • fi-FI Finnish (Finland)
  • fr-BE Belgian French
  • fr-CA Canadian French
  • fr-CH “Swiss” French
  • fr-FR Standard French (especially in France)
  • he-IL Hebrew (Israel)
  • hi-IN Hindi (India)
  • hu-HU Hungarian (Hungary)
  • id-ID Indonesian (Indonesia)
  • it-CH “Swiss” Italian
  • it-IT Standard Italian (Italian)
  • jp-JP Japanese (Japan)
  • ko-KR Korean (Republic of Korea)
  • nl-BE Flemish Dutch
  • nl-NL Standard Dutch (Dutch)
  • no-NO Norwegian (Norway)
  • pl-PL Polish (Poland)
  • pt-BR Brazilian Portuguese
  • pt-PT European Portuguese (written and used in Portugal)
  • ro-RO Romanian (Romania)
  • ru-RU Russian (Russian Federation)
  • sk-SK Slovak (Slovakia)
  • sv-SE Swedish (Sweden)
  • ta-IN Tamil (India)
  • ta-LK Sinhala (Sri Lanka)
  • th-TH Thai (Thailand)
  • tr-TR Turkish (Turkey)
  • zh-CN Mainland China, Simplified Chinese
  • zh-HK Hong Kong, Traditional Chinese
  • zh-TW Taiwan, Traditional Chinese
options

Optional. An object that can set some properties.

Valid Attributes are listed in the following table:

Valid Attributes Valid Values:
dateStyle
  • "full"
  • "long"
  • "medium"
  • "short"
timeStyle
  • "full"
  • "long"
  • "medium"
  • "short"
localeMatcher
  • "best-fit"(Default)
  • "lookup"
timeZone
hour12
  • false
  • true
hourCycle
  • "h11"
  • "h12"
  • "h23"
  • "h24"
formatMatcher
  • "basic"
  • "best-fit"(Default)
  • weekday
    • "long"
    • "short"
    • "narrow"
    year
    • "2-digit"
    • "numeric"
    month
    • "2-digit"
    • "long"
    • "narrow"
    • "numeric"
    • "short"
    day
    • "2-digit"
    • "long"
    hour
    • "2-digit"
    • "long"
    minute
    • "2-digit"
    • "long"
    second
    • "2-digit"
    • "long"
    timeZoneName
    • "long"
    • "short"

    Technical Details

    Return Value: A string representing a date and time in string format.
    JavaScript Version: ECMAScript 1

    Browser Support

    Method Chrome IE Firefox Safari Opera
    toLocaleString() Support Support Support Support Support

    Related Pages

    Tutorial:JavaScript Date

    Tutorial:JavaScript Date Format

    Tutorial:JavaScript String