PlainYearMonth toLocaleString()
Example
const date = Temporal.PlainYearMonth.from("2026-05");
let text = date.toLocaleString("en-US", {calendar:"iso8601"});
Try it Yourself »
Description
The toLocaleString() method returns a string with a language-sensitive
representation of the PlainYearMonth.
The toLocaleString() method does not change the original PlainYearMonth.
Syntax
plainyearmonth.toLocaleString(locales, options)
Parameters
| Parameter | Description |
| locales | The locale(s) to be used. |
| options | An object adjusting the output format. |
Return Value
| Type | Description |
| String | The PlainYearMonth in a locale format. |
Browser Support
Temporal is a major update to the JavaScript standard (TC39).
It is currently supported in Chrome, Edge, Firefox, and Opera Safari has not shipped it yet.
| Chrome 144 |
Edge 144 |
Firefox 139 |
Safari |
Opera 128 |
| Jan 2026 | Jan 2026 | May 2025 | 🚫 | Feb 2026 |
The Safari implementation can be tested in Safari Technology Preview by enabling the --use-temporal runtime flag.
Polyfill
Until Safari supports Temporal natively, you can use the official polyfill:
<script
src="https://cdn.jsdelivr.net/npm/@js-temporal/polyfill@0.5.1/dist/index.umd.js">
</script>