Bikram-JS

!License
!NPM Version
!Build Status

Bikram-js is an npm package for converting Gregorian dates to Bikram Sambat dates, calculating Tithis, and providing various functionalities related to the Bikram Sambat calendar. This package is useful for developers needing accurate Nepali date conversions and Tithi calculations in their applications.

Repository Structure

- Root Folder: Contains the source code for the bikram-js npm package.
- example Folder: Contains an example implementation of a calendar and date converter to demonstrate the use of the bikram-js package.

Features

- Convert Gregorian dates to Bikram Sambat dates and vice versa
- Calculate Tithi (lunar day) for a given Gregorian date and longitude
- Retrieve Nepali month and weekday names

Installation

You can install the package via npm:

``bash
npm install bikram-js


Or for development purposes:


npm install bikram-js --save-dev
`

Usage

$3

The Bikram class provides methods for converting between Gregorian and Bikram Sambat dates and retrieving Nepali month and weekday names.

#### Example




Usage Examples (these examples are in test section of this package too)

Here are some examples of how to use the bikram-js package:

$3

`typescript
import { Bikram } from 'bikram-js';

const bikram = new Bikram();
bikram.fromGregorian(2024, 1, 1);

console.log(bikram.getYear()); // 2080
console.log(bikram.getMonth()); // 9
console.log(bikram.getDay()); // 16
`

$3

`typescript
import { Tithi } from 'bikram-js';

const testTithi = new Tithi();
const tithiResult = testTithi.calculateTithi(2024, 1, 1);

console.log(tithiResult.tithi); // "पञ्चमी"
console.log(tithiResult.paksha); // "कृष्ण"
`

$3

`typescript
import { Bikram } from 'bikram-js';

const bikram = new Bikram();
const gregorianDate = bikram.toGregorian(2081, 1, 1);

console.log(gregorianDate.year); // 2024
console.log(gregorianDate.month); // 4
console.log(gregorianDate.day); // 13
`

$3

`typescript
import { Bikram } from 'bikram-js';

const bikram = new Bikram();
const totalDays = bikram.daysInMonth(2081, 8);
console.log(totalDays); // 30

const totalDaysFebruary = bikram.daysInMonth(2081, 2);
console.log(totalDaysFebruary); // 32
`

$3

`typescript
import { Tithi } from 'bikram-js';

const testTithi = new Tithi();
const tithiResult = testTithi.calculateTithi(2020, 2, 29);

console.log(tithiResult.tithi); // "पञ्चमी"
console.log(tithiResult.paksha); // "शुक्ल"
`

$3

`typescript
import { Bikram } from 'bikram-js';

const bikram = new Bikram();
console.log(bikram.getWeekdayName(2024, 12, 5)); // 'बिहीबार'
console.log(bikram.getWeekdayName(2024, 12, 6)); // 'शुक्रबार'
console.log(bikram.getWeekdayName(2024, 12, 7)); // 'शनिबार'
console.log(bikram.getWeekdayName(2024, 12, 8)); // 'आइतबार'
`

$3

`typescript
import { Bikram } from 'bikram-js';

const bikram = new Bikram();
const gregorianDate = bikram.toGregorian(2081, 8, 20);
const testDay = bikram.getWeekdayName(gregorianDate.year, gregorianDate.month, gregorianDate.day);
console.log(testDay); // "बिहीबार"
`

$3

`typescript
import { Bikram } from 'bikram-js';

const bikram = new Bikram();
console.log(bikram.getWeekdayName(2020, 2, 29)); // 'शनिबार'
`

$3

`typescript
import { Bikram } from 'bikram-js';

const bikram = new Bikram();
console.log(bikram.getWeekdayName(2024, 1, 1)); // 'सोमबार'
console.log(bikram.getWeekdayName(2024, 12, 31)); // 'मंगलबार'
`

$3

`typescript
import { Bikram } from 'bikram-js';

const bikram = new Bikram();
bikram.fromGregorian(2024, 12, 5);
const testMonthName = bikram.getMonthName(bikram.getMonth());
console.log(testMonthName); // 'मंसिर'
`

$3

`typescript
import { Bikram } from 'bikram-js';

const bikram = new Bikram();
try {
bikram.getMonthName(0);
} catch (error) {
console.error(error);
}
try {
bikram.getMonthName(13);
} catch (error) {
console.error(error);
}
`

Documentation

Detailed documentation of functions are available in the docs/docs folder of this repository. You can find comprehensive guides and examples on using the bikram-js library.

To view the documentation:

1. Navigate to the docs/docs` folder.
2. Open the markdown files to read the documentation.

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for more details.

Contributing

Contributions are welcome! you can fork this repo, create modifications and send pull request.

Acknowledgements

The Bikram Sambat and Tithi functionalities are implemented using calculations from a port of the Perl script Pancanga library by M. Fushimi and M. Yano. For detailed information, consult the original documentation:

- Documentation
- Pancanga Library

Special thanks to Samar Dhwoj Acharya (techgaun), Kapil Karki (kapil-31), and the Build For Nepal team for their encouragement.

Author

Khumnath CG (nath.khum@gmail.com)

Contributors

Special thanks to all contributors.