An interactive playground to learn and experiment with the Temporal API — the modern replacement for JavaScript's Date object.
Unlike the legacy Date object, Temporal provides:
- ✅ Timezone-aware calculations without surprises
- ✅ Immutable date/time objects that prevent bugs
- ✅ Clear, explicit APIs for common use cases
- ✅ First-class support for calendars and non-Gregorian systems
An interactive learning environment with:
- 🎨 16 curated examples — from fundamentals to advanced concepts
- ⚡ Live code execution — edit code, see results instantly
- 📝 Side-by-side comparisons — understand differences with Date
- 💡 Full TypeScript support — autocomplete and type checking
- 🛠️ Monaco Editor — the same editor as VS Code
No setup required — runs entirely in your browser.
Fundamentals • Understanding Temporal types • Timezone conversion • Parsing & validation • Migration from Date
Common Operations • ISO durations • Date differences • Comparison & sorting • API serialization • Formatting
Advanced Concepts • Calendar vs absolute arithmetic • DST handling • Immutability benefits
Real-World Use Cases • Recurring events • Age calculation • Dashboard time windows
Contributions welcome! Ideas for improvements:
- 🐛 Report bugs or edge cases
- 💡 Suggest new examples
- 🎨 Improve UI/UX
- 📝 Fix typos or enhance docs
- Fork the repo
- Create a branch (
git checkout -b feature/amazing-example) - Commit changes (
git commit -m 'feat: add amazing example') - Push (
git push origin feature/amazing-example) - Open a Pull Request
Built with ❤️ to help developers adopt Temporal