Introduction
Nepali Datepicker Pro is a self-owned Bikram Sambat ↔ Gregorian calendar engine with date, time, range and month pickers — framework-agnostic, and ready for vanilla JS, a plain <script> tag, jQuery, Vue and React.
- BS 1970–2100 of validated calendar data
- ~17 KB gzip, tree-shakeable
- Zero runtime dependencies
What's in the box
| Component | What it does |
|---|---|
| Date & Time Picker | A single date, with an optional same-screen time picker. |
| Date Range Picker | Start/end range with a presets rail and Nepali fiscal-year helpers. |
| Month Picker | One BS month, resolved to the AD date range it covers. |
| Helper functions | A NepaliFunctions-compatible BS↔AD toolkit, usable with no picker at all. |
Why another Nepali datepicker
Most Nepali date pickers are a jQuery plugin with a lookup table bolted on, and they force one calendar system on both your UI and your database. This one separates the two concerns:
- The engine is independent of the UI.
nepaliFunctionsand the calendar adapter work on their own — you can convert dates, validate them and do BS month math without rendering anything. See Helper functions. - What you display is not what you submit. A BS-mode picker — in Nepali digits if you set
locale: 'ne', English by default — can still hand your backend a clean AD ISO string, with no conversion glue in your form handler. See Options. - One package, every stack. The same core is wrapped for Vue, React, jQuery and plain HTML auto-init, so a mixed codebase doesn't need four different pickers.
Accuracy
The bundled adapter is O(1) and validated against the official calendar for BS 1970–2100. Conversions outside that window are rejected rather than silently approximated.
Next steps
- Installation — npm or CDN, in your framework
- Basic usage — mount a picker and read its value
- Components — live demos you can configure and copy from