For AI agents: the complete documentation index is available at /tc39-atlas/en/llms.txt, the full documentation bundle is available at /tc39-atlas/en/llms-full.txt, and this page is available as Markdown at /tc39-atlas/en/proposals/proposal-intl-datetime-style.md.
TC39 Atlas
  • English

      • DateTimeFormat dateStyle & timeStyle S4

      Proposal details
      Proposal overview

      This proposal adds two options, dateStyle and timeStyle, to Intl.DateTimeFormat for a compact way to request locale-specific date and time formats of given lengths. It provides a simpler alternative to explicitly specifying individual date/time components.

      Note

      The README below comes from the upstream repository and may contain outdated stage or status metadata. Use the proposal details above as the current source of truth.

      dateStyle and timeStyle option on Intl.DateTimeFormat API Specification [draft]

      This proposal adds two options to Intl.DateTimeFormat: dateStyle and timeStyle. These options give a compact way to request the appropriate, locale-specific way to ask for a date and time of given lengths.

      Status

      Current Stage:

      • Stage 4

      Spec Text:

      Authors

      • Zibi Braniecki (@zbraniecki)

      Reviewers

      • Frank Tang (@FrankYFTang)
      • Nathan Hammond (@nathanhammond)

      Informative

      This proposal is based on the CLDR Date/Time Patterns:

      Usage

      let o = new Intl.DateTimeFormat("en" , {
  timeStyle: "short"
});
console.log(o.format(Date.now())); // "13:31"

let o = new Intl.DateTimeFormat("en" , {
  dateStyle: "short"
});
console.log(o.format(Date.now())); // "21.03.2012"

let o = new Intl.DateTimeFormat("en" , {
  timeStyle: "medium",
  dateStyle: "short"
});
console.log(o.format(Date.now())); // "21.03.2012, 13:31"

      Render Spec

      npm install
npm run build
open index.html

      Backpointers