Eonasdan/tempus-dominus
Tempus Dominus
Tempus Dominus is a JavaScript date-time picker library designed to integrate with Bootstrap-based web projects, replacing manual text entry with an interactive calendar and clock interface. It functions as a form input enhancement that provides visual selection of single dates, times, or combined date-time values through a calendar and clock widget.
The picker is built as a collection of independent UI components that manage their own state and rendering, with visual customization achieved entirely through CSS variables and class overrides without requiring JavaScript configuration. User interactions and programmatic changes trigger events through a centralized event system, while the display formatting is determined by a configurable format string that maps to locale-aware rendering rules. The picker's lifecycle is tied to its associated input element, automatically initializing and cleaning up based on DOM events, and it dynamically calculates its position relative to the viewport to ensure full visibility when opened.
The widget supports navigating through day, month, year, and decade views to locate and select specific dates, and can switch between date-only, time-only, and combined date-time modes to match input requirements. A hierarchical view system allows seamless transitions between these views through a shared navigation state.