Provides standard objects and functions for working with dates and times.
NOTE: The Polyfill, specification text and documentation are under continuing development and should be understood to be unstable.
- Maggie Pint (@maggiepint)
- Philipp Dunkel (@pipobscure)
- Matt Johnson (@mj1856)
- Brian Terlson (@bterlson)
- Shane Carr (@sffc)
- Ujjwal Sharma (@ryzokuken)
- Philip Chimento (@ptomato)
- Jason Williams (@jasonwilliams)
This proposal is currently stage 2.
Stage 3 Reviewers:
- Richard Gibson
- Bradley Farias
- Daniel Ehrenberg
Overview / Motivation
Date has been a long-standing pain point in ECMAScript.
Temporal, a global
Object that acts as a top-level namespace (like
Math), that brings a modern date/time API to the ECMAScript language.
For a detailed breakdown of motivations, see:
- All Temporal objects are immutable.
- Date values can be represented in local calendar systems, but they should be convertable to and from the Proleptic Gregorian Calendar.
- All time-of-day values are based on a standard 24-hour clock.
- Leap seconds are not represented.
The specification text can be found here.
Reference documentation and examples can be found here.
A cookbook to help you get started and learn the ins and outs of Temporal is available here