{"id":13482245,"url":"https://github.com/tc39/proposal-temporal","last_synced_at":"2025-05-12T15:20:40.544Z","repository":{"id":37411030,"uuid":"84692493","full_name":"tc39/proposal-temporal","owner":"tc39","description":"Provides standard objects and functions for working with dates and times.","archived":false,"fork":false,"pushed_at":"2025-04-21T17:11:43.000Z","size":143963,"stargazers_count":3521,"open_issues_count":44,"forks_count":163,"subscribers_count":94,"default_branch":"main","last_synced_at":"2025-04-23T17:09:40.424Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://tc39.es/proposal-temporal/docs/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tc39.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-03-12T01:50:08.000Z","updated_at":"2025-04-22T22:09:24.000Z","dependencies_parsed_at":"2023-10-21T02:25:07.797Z","dependency_job_id":"b5dcff7c-2481-4976-be25-52976f5a19ff","html_url":"https://github.com/tc39/proposal-temporal","commit_stats":{"total_commits":2972,"total_committers":101,"mean_commits":"29.425742574257427","dds":0.5578734858681023,"last_synced_commit":"d1161a146eb2278db32a6b39be70b2cb7c1254a2"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tc39%2Fproposal-temporal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tc39%2Fproposal-temporal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tc39%2Fproposal-temporal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tc39%2Fproposal-temporal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tc39","download_url":"https://codeload.github.com/tc39/proposal-temporal/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250477811,"owners_count":21437049,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T17:01:00.260Z","updated_at":"2025-04-23T17:09:46.522Z","avatar_url":"https://github.com/tc39.png","language":"HTML","readme":"# Temporal\n\nProvides standard objects and functions for working with dates and times.\n\n## Status\n\nThis proposal is currently [Stage 3](https://github.com/tc39/proposals#stage-3) and was reviewed for Stage 3 by Richard Gibson, Bradley Farias, and Daniel Ehrenberg.\n\nThis proposal is now in the hands of ECMAScript engine implementers, so the bar for making API changes is extremely high.\nNonetheless, changes may occur as the result of feedback from implementation in JS engines.\nEditorial changes to the spec and bug fixes to the spec, tests, and docs are also ongoing, as is customary for Stage 3 proposals.\nAdditional tests and documentation content are also being added during Stage 3.\n\n## Champions\n\n- Philipp Dunkel ([@pipobscure](https://github.com/pipobscure))\n- Maggie Johnson-Pint ([@maggiepint](https://github.com/maggiepint))\n- Matt Johnson-Pint ([@mattjohnsonpint](https://github.com/mattjohnsonpint))\n- Brian Terlson ([@bterlson](https://github.com/bterlson))\n- Shane Carr ([@sffc](https://github.com/sffc))\n- Ujjwal Sharma ([@ryzokuken](https://github.com/ryzokuken))\n- Philip Chimento ([@ptomato](https://github.com/ptomato))\n- Jason Williams ([@jasonwilliams](https://github.com/jasonwilliams))\n- Justin Grant ([@justingrant](https://github.com/justingrant))\n\n## Overview / Motivation\n\n`Date` has been a long-standing pain point in ECMAScript.\nThis proposes `Temporal`, a global `Object` that acts as a top-level namespace (like `Math`), that brings a modern date/time API to the ECMAScript language.\nFor a detailed breakdown of motivations, see:\n[Fixing JavaScript Date](https://maggiepint.com/2017/04/09/fixing-javascript-date-getting-started/)\n\n### Principles:\n\n- All Temporal objects are immutable.\n- Date values can be represented in local calendar systems ([why?](./docs/calendar-review.md)), but they should be convertable to and from the [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar).\n- All time-of-day values are based on a standard 24-hour clock.\n- [Leap seconds](https://en.wikipedia.org/wiki/Leap_second) are not represented.\n\n## Specification Text\n\nThe specification text can be found [here](https://tc39.es/proposal-temporal/).\n\n## Documentation\n\nReference documentation and examples can be found below.\n\n- [Temporal Documentation (English)](https://tc39.es/proposal-temporal/docs/index.html)\n- [Temporal のドキュメント (Japanese)](https://tc39.es/proposal-temporal/docs/ja/index.html) (translated a part of the English document into Japanese)\n- [Temporal 文档 (Chinese)](https://tc39.es/proposal-temporal/docs/zh_CN/index.html) (translated a part of the English document into Chinese)\n\nA cookbook to help you get started and learn the ins and outs of Temporal is available [here](https://tc39.es/proposal-temporal/docs/cookbook.html)\n\n## Polyfills\n\n| Polyfill                                                                         | Repo                                                                                | Status                  |\n| -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ----------------------- |\n| **[@js-temporal/polyfill](https://www.npmjs.com/package/@js-temporal/polyfill)** | [js-temporal/temporal-polyfill](https://github.com/js-temporal/temporal-polyfill)   | Alpha release available |\n| **[temporal-polyfill](https://www.npmjs.com/package/temporal-polyfill)**         | [fullcalendar/temporal-polyfill](https://github.com/fullcalendar/temporal-polyfill) | Beta release available  |\n\nIf you're working on a polyfill, please file an issue or PR so we can add yours here.\n\nA [non-production polyfill](./polyfill) was built to validate this proposal.\nThis polyfill continues to live in this repo, but only for the purposes of running tests and powering the documentation \"playground\" as described below.\n\n**DO NOT use this polyfill in your own projects!\nInstead, please use a polyfill from the table above.**\n\n## Documentation Playground\n\nWhen viewing the [reference documentation](https://tc39.es/proposal-temporal/docs/index.html), the non-production polyfill is automatically loaded in your browser, so you can try out Temporal by opening your browser's developer tools console.\n","funding_links":[],"categories":["HTML","JavaScript","🔧 Utilities \u0026 Miscellaneous"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftc39%2Fproposal-temporal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftc39%2Fproposal-temporal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftc39%2Fproposal-temporal/lists"}