NepaliCalendarToolkit 1.0.2

Nepali Calendar Toolkit

This NuGet package provides a comprehensive toolkit for handling Nepali calendar dates, including Nepali public holidays and weekends from 2065 BS - 2081 BS.

Features

• Convert between Nepali (Bikram Sambat) and Gregorian (AD) dates
• Get Nepali public holidays
• Calculate weekends for Nepali dates
• Work with Nepali fiscal years (starts on Shrawan 1st and ends on Ashar end)
• Get date ranges for Nepali months, quarters, and fiscal years
• JSON-based holiday data storage

Installation

Install-Package NepaliCalendarToolkit

Or using the .NET CLI:

dotnet add package NepaliCalendarToolkit

Usage

Initialize Holiday JSON Files (Optional)

// Call this once at application startup if you want to use JSON files
NepaliCalendarConverter.InitializeHolidayJsonFiles();

Get Holidays and Weekends

// Get all holidays and weekends for a specific year
var holidaysAndWeekends = NepaliCalendarConverter.GetHolidaysAndWeekends(2080);

// Get only holidays for a specific month in a year
var holidays = NepaliCalendarConverter.GetHolidaysAndWeekends(2080, 1, HolidayOrWeekendEnum.Holidays);

// Get only weekends for a specific month in a year
var weekends = NepaliCalendarConverter.GetHolidaysAndWeekends(2080, 1, HolidayOrWeekendEnum.Weekends);

Date Conversion

// Convert from Nepali date to Gregorian date
var nepaliDate = new NepaliDate(2080, 1, 1);
var gregorianDate = NepaliCalendarConverter.ConvertToAD(nepaliDate);

// Convert from Gregorian date to Nepali date
var gregorianDate = new DateTime(2023, 4, 14);
var nepaliDate = NepaliCalendarConverter.ConvertToNepali(gregorianDate);

Fiscal Year Operations

// Get date range for a Nepali fiscal year
var fiscalYearRange = NepaliCalendarConverter.GetFiscalYearDateRangeInAD(2080);
// Result: StartDate: 2023-07-17, EndDate: 2024-07-15

// Get holidays for a fiscal year
var fiscalYearHolidays = NepaliCalendarConverter.GetHolidaysAndWeekendsForFiscalYear(2080);

Holiday Data Structure

The toolkit now stores holiday data in JSON files (in the Data/Holidays directory) with the following structure:

[
  {
    "month": 1,
    "day": 11,
    "date": "2008-04-23",
    "name": "Loktantra Diwas"
  }
  // More holidays...
]

Each year has its own JSON file named with the BS year (e.g., "2080.json").

License

This project is licensed under the MIT License - see the LICENSE file for details.

Methods

1. ConvertToNepali

Description: Converts date in AD (DateTime) to a Nepali date (NepaliDate).

Implementation:

DateTime dateInAD = new DateTime(2024, 10, 1);
NepaliDate nepaliDate = NepaliCalendarConverter.ConvertToNepali(dateInAD);

Response:

{
  "Year": 2081,
  "Month": 6,
  "Day": 15
}

2. ConvertToAD

Description: Converts a Nepali date (NepaliDate) to a Gregorian date (DateTime).

Implementation:

csharp
NepaliDate nepaliDate = new NepaliDate { Year = 2080, Month = 6, Day = 15 };
DateTime dateInAD = NepaliCalendarConverter.ConvertToAD(nepaliDate);

2023-10-01 00:00:00

3. GetStartAndEndDateInAD

Description: Retrieves the start and end dates in AD for a given Nepali year and month.

Implementation:

var dateRange = NepaliCalendarConverter.GetStartAndEndDateInAD(2080, 6);

Response:

{
  "StartDate": "2023-09-17",
  "EndDate": "2023-10-16"
}

4. GetQuarterDateRangeInAD

Description: Retrieves the start and end dates in AD for a given Nepali year and quarter.

Implementation:

var quarterRange = NepaliCalendarConverter.GetQuarterDateRangeInAD(2080, 1);

Response:

{
  "StartDate": "2023-07-01",
  "EndDate": "2023-09-30"
}

5. GetMonthRangeDateInAD

Description: Retrieves the start and end dates in AD for a specified range of Nepali months.

Implementation:

var monthRange = NepaliCalendarConverter.GetMonthRangeDateInAD(2080, 6, 8);

Response:

{
  "StartDate": "2023-09-17",
  "EndDate": "2023-11-15"
}

6. GetHolidaysAndWeekends

Description: Retrieves a list of holidays and weekends for a specified year and optional month.

Implementation:

var holidays = NepaliCalendarConverter.GetHolidaysAndWeekends(2080);

Response:

List<HolidayInfo> { ... } // Contains holiday information for the year 2080

7. GetFiscalYearDateRangeInAD

Description: Retrieves the start and end dates in AD for a given Nepali fiscal year.

Implementation:

var fiscalYearRange = NepaliCalendarConverter.GetFiscalYearDateRangeInAD(2080);

Response:

{
  "StartDate": "2023-07-17",
  "EndDate": "2024-07-15"
}

8. GetHolidaysAndWeekendsForFiscalYear

Description: Retrieves a list of holidays and weekends for a specified fiscal year.

Implementation:

var fiscalYearHolidays = NepaliCalendarConverter.GetHolidaysAndWeekendsForFiscalYear(2080);

Response:

List<HolidayInfo> { ... } // Contains holiday information for the fiscal year 2080-81