Skip to content

JavaScript toLocaleString() | Method

  • by

JavaScript toLocaleString() Method returns a Date object as a string, using locale settings. The default language depends on the locale setup on your computer browser.

toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)

JavaScript toLocaleString

Simple example code.

<!DOCTYPE html>
<html>
<body>
  <script>
   const event = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));

  // British English uses d-m-y order and 24-hour time without AM/PM
  console.log(event.toLocaleString('en-GB', { timeZone: 'UTC' }));

  // Korean uses y-m-d order and 12-hour time with AM/PM
  console.log(event.toLocaleString('ko-KR', { timeZone: 'UTC' }));

</script>
</body>
</html>

Output:

JavaScript toLocaleString() Method

Parameter Valueslocales

ar-SA Arabic (Saudi Arabia)
bn-BD Bangla (Bangladesh)
bn-IN Bangla (India)
cs-CZ Czech (Czech Republic)
da-DK Danish (Denmark)
de-AT Austrian German
de-CH “Swiss” German
de-DE Standard German (as spoken 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 US English
en-ZA English (South Africa)
es-AR Argentine Spanish
es-CL Chilean Spanish
es-CO Colombian Spanish
es-ES Castilian Spanish (as spoken in Central-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 (as spoken in Italy)
ja-JP Japanese (Japan)
ko-KR Korean (Republic of Korea)
nl-BE Belgian Dutch
nl-NL Standard Dutch (as spoken in The Netherlands)
no-NO Norwegian (Norway)
pl-PL Polish (Poland)
pt-BR Brazilian Portuguese
pt-PT European Portuguese (as written and spoken in Portugal)
ro-RO Romanian (Romania)
ru-RU Russian (Russian Federation)
sk-SK Slovak (Slovakia)
sv-SE Swedish (Sweden)
ta-IN Indian Tamil
ta-LK Sri Lankan Tamil
th-TH Thai (Thailand)
tr-TR Turkish (Turkey)
zh-CN Mainland China, simplified characters
zh-HK Hong Kong, traditional characters
zh-TW Taiwan, traditional characters

Option (Optional):- An object were you can set some properties. Legal properties:

dateStyleLegal values:
"full"
"long"
"medium"
"short"
timeStyle"full"
"long"
"medium"
"short"
localeMatcher"best-fit" (default)
"lookup"
timeZone 
hour12false
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"
"numeric"
hour"2-digit"
"numeric"
minute"2-digit"
"numeric"
second"2-digit"
"numeric"
timeZoneName"long"
"short"

Do comment if you have any doubts or suggestions on this JS method.

Note: The All JS Examples codes are tested on the Firefox browser and the Chrome browser.

OS: Windows 10

Code: HTML 5 Version

Leave a Reply

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.