gitmyhub

tempus-dominus

HTML ★ 7.2k updated 2mo ago

This project is no longer active or supported.

A JavaScript date and time picker widget for web pages that shows a visual calendar and clock, requires only Popper2 as a dependency, and no longer needs jQuery or Bootstrap, though the project is no longer actively maintained.

TypeScriptJavaScriptCSSPopper2setup: easycomplexity 2/5

Tempus Dominus is a date and time picker for web pages, written in JavaScript. When added to a website, it gives users a visual calendar and clock interface for selecting a date, a time, or a combined date-and-time value. The library reached version 6.9.4 before its author announced the project is no longer actively maintained. Any new issues now require paid sponsorship to be addressed, and the author noted they are moving on to other projects.

Version 6 was a substantial rewrite compared to its predecessor. It is written in TypeScript, a typed extension of JavaScript that tends to produce more predictable code. One of the key changes in version 6 is that several older dependencies are no longer required: Bootstrap (a CSS framework), Moment.js (a date formatting library), and jQuery (a JavaScript utility library) are all optional or removed. The only required external dependency is Popper2, which handles positioning the picker widget correctly on the screen relative to the input field the user clicks. A jQuery compatibility wrapper is included for projects that still depend on jQuery, though the README suggests moving away from it.

The source code lives in a TypeScript project with a docs folder for the documentation site and a dist folder for built JavaScript and CSS files. Developers working on the library itself run npm i to install packages, then npm start to launch a local server with live rebuilding as they make changes. Running npm run serve shows the documentation site without watching for changes.

The project accumulated over 7,000 GitHub stars during its active years, reflecting significant adoption in web development projects that needed a date-picker widget without heavy framework dependencies. Because it is now in a paid-support-only state, new users should consider whether a still-actively-maintained alternative better fits their needs. Existing projects that already use it can continue with the published releases, but should not expect free fixes or new features.

Where it fits