Convert dates
Offline AD ↔ BS conversion for BS 1970–2090, with a verification status on every result.
Looking for the Mac app? Sajilo Patro for Mac
For JavaScript and TypeScript projects (Node.js 20+), free to use, including commercially.
npm install sajilo-patroसजिलो पात्रो (sajilo patro) means “easy calendar”. Prefer the full name?npm install @nepali-calendar/nepali-calendarSame code, same version.
The macOS menu-bar app. Free, with optional premium themes.
brew install --cask ssarthaks/tap/sajilo-patroSajilo Patro is a free Nepali patro (Nepali calendar) npm package for JavaScript and TypeScript. It gives you reliable Bikram Sambat (BS) calendar data: offline BS ↔ AD date conversion, Government of Nepal public holidays, working-day and payroll calculations, tithi and Nepali formatting, for payroll, HRMS, attendance, leave and accounting software.
New to the Nepali calendar? Learn the basics in two minutes
Get started quickly. See results right away.
Press ⌘ + K to search docs
Offline AD ↔ BS conversion for BS 1970–2090, with a verification status on every result.
The Ministry of Home Affairs holiday list, with who each holiday applies to: everyone, a district, a community or a group.
Working days, payroll calendars and leave ranges with your own weekly and custom holidays.
Type a date in either calendar. It runs in your browser with the same package and dataset you install.
Format YYYY-MM-DD. Nepali digits work too. Try: , , .
$ npm install sajilo-patro
added 1 package
$ node
> const { NepaliCalendar } = require("sajilo-patro")
> new NepaliCalendar().convertToBS("2026-11-06").bs.iso
'2083-07-20'Browse any month from BS 1970–2090. Select a day to see its holidays and calculated tithi, and switch between English and Nepali.
Red days are public holidays for everyone; Saturday is the weekly holiday. Tithi is calculated for Kathmandu sunrise.
Everything the package can do, one topic at a time.
Copy-ready snippets for the most common tasks. Requires Node.js 20 or newer.
// CommonJS (Node.js 20+)const { NepaliCalendar } = require("sajilo-patro"); async function main() { const calendar = new NepaliCalendar(); const today = await calendar.getToday(); console.log(today.bs.iso, today.monthName.en, today.weekdayName.ne);} main();Every date says how far it can be trusted. This is an independent project: it is not an official government calendar and has no endorsement from the Government of Nepal.
From two open-source month tables that agree with each other, not checked against an official source. May not be 100% correct.
Month lengths confirmed by Ministry of Home Affairs notices (their Saturday lists and stated dates).
Except Chaitra 2083: provisional
Not officially published yet. Month lengths may change when the official calendar is released.
How updates happen
A daily GitHub Action watches the Ministry of Home Affairs holiday pages. New notices open a pull request; a maintainer transcribes the notice and a second maintainer reviews it. Calendar data is never changed automatically.
Good to know
Holiday lists exist for BS 2083. Tithi is calculated and can differ by a day from the official panchanga. District holidays apply when you set a district.
Patro (पात्रो) is the Nepali word for calendar. A Nepali patro follows Bikram Sambat (BS), the official calendar of Nepal, which runs about 56 years and 8 months ahead of the Gregorian (AD) calendar. BS months have 29 to 32 days and their lengths change every year, so dates must come from a verified table, not a formula.
Install Sajilo Patro with "npm install sajilo-patro". The same code is also published as @nepali-calendar/nepali-calendar. It runs on Node.js 20 or newer, in browsers, and in apps built with React, Next.js, Vue, Angular or Svelte, with ES module and CommonJS builds and TypeScript types. It is a calendar data and conversion library, not a date-picker widget.
Create a calendar with new NepaliCalendar(), then call convertToAD({ year: 2083, month: 7, day: 21 }), which gives 2026-11-07, or convertToBS("2026-11-06"), which gives 2083-07-20. Conversion is synchronous and works offline.
Yes. Government of Nepal public holidays for BS 2083 are transcribed from Ministry of Home Affairs notices, including who each holiday applies to: everyone, specific districts, women employees or particular communities. getWorkingDays and getPayrollCalendar count working days for payroll, HR and attendance software.
Dates from BS 1970–2090. Every date carries a verification status (official, verified, provisional or unverified), so your software can tell confirmed dates from estimates.
Yes. It is free to use in personal and commercial projects under the Nepali Calendar Free Use License. It is not open source.
Yes. The calendar dataset is bundled with the package, so date conversion, holidays and tithi need no network or API key. An optional remote provider can load newer holiday data when it is published.
Free to use, including commercially
Use it in personal and business projects at no cost. Report a data error, or support the work with a donation.