Skip to content
Esc

Use the up and down arrow keys to choose a result and Enter to open it.

Nepali Calendar npm package

Looking for the Mac app? Sajilo Patro for Mac

Dataset 2083.2 · sources

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.

  • v1.6.0
  • Dataset 2083.2
  • BS 1970–2090
  • Holidays: BS 2083
  • Zero dependencies
  • ESM · CJS · TypeScript

Sajilo 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

Fast Path

Get started quickly. See results right away.

Convert dates

Offline AD ↔ BS conversion for BS 1970–2090, with a verification status on every result.

Government holidays

The Ministry of Home Affairs holiday list, with who each holiday applies to: everyone, a district, a community or a group.

Payroll and working days

Working days, payroll calendars and leave ranges with your own weekly and custom holidays.

Convert a date in seconds

Type a date in either calendar. It runs in your browser with the same package and dataset you install.

Conversion direction

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'

Live calendar

Browse any month from BS 1970–2090. Select a day to see its holidays and calculated tithi, and switch between English and Nepali.

Loading calendar…

Language

Red days are public holidays for everyone; Saturday is the weekly holiday. Tithi is calculated for Kathmandu sunrise.

Guides

Everything the package can do, one topic at a time.

Code examples

Copy-ready snippets for the most common tasks. Requires Node.js 20 or newer.

example.js
// 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();

Data reliability

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.

Unverified

BS 1970–2079

From two open-source month tables that agree with each other, not checked against an official source. May not be 100% correct.

Official

BS 2080–2083

Month lengths confirmed by Ministry of Home Affairs notices (their Saturday lists and stated dates).

Except Chaitra 2083: provisional

Provisional

BS 2084–2090

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.

Read about data sources and accuracy

Nepali Patro Package: Frequently Asked Questions

What is a Nepali patro?

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.

Which npm package can I use for a Nepali patro in JavaScript or TypeScript?

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.

How do I convert a BS date to AD, or AD to BS, in JavaScript?

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.

Does it include Nepal public holidays?

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.

Which years does the Nepali calendar data cover?

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.

Is Sajilo Patro free for commercial use?

Yes. It is free to use in personal and commercial projects under the Nepali Calendar Free Use License. It is not open source.

Does it work offline?

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.