NepDate 1.1.0

Package

Package	NuGet Stable	Downloads
NepDate

Installation

Install NepDate with the package manager console

NuGet\Install-Package NepDate

Install NepDate with the .NET CLI

dotnet add package NepDate

Features

NepDate is a struct based on .NET Standard 2.0 that closely resembles the DateOnly struct in .NET. It stands out due to its easy integration, super-fast and memory-efficient conversions, and built in powerful features related to Nepali date functionality.

Initialization

By nepali year, month, and day values

using NepDate;

var nepDate = new NepaliDate(2079, 12, 16);

By Nepali date as a string

using NepDate;

var nepDate = new NepaliDate("2079/12/16");
// or
var nepDate = NepaliDate.Parse("2079/12/16");

By English DateTime

using NepDate;

var nepDate = new NepaliDate(DateTime.Now);
// or
var nepDate = DateTime.Now.ToNepaliDate();

By Nothing

using NepDate;

var nepDate = NepaliDate.Now; // Initializes NepaliDate object with current Nepali date

Properties

using NepDate;

var nepDate = new NepaliDate("2079/12/16");

// get the Nepali year, month, and day values
var year = nepDate.Year;
var month = nepDate.Month;
var day = nepDate.Day;

// get the equivalent English date as a DateTime
var englishDate = nepDate.EnglishDate;

// get the day of the week as a DayOfWeek enum value
var dayOfWeek = nepDate.DayOfWeek;

// get the last day of the month as an integer value
var monthEndDay = nepDate.MonthEndDay;

// get the last day of the month as a NepaliDate object
var monthEndDate = nepDate.MonthEndDate;

// get the name of the month as a NepaliMonths enum
var monthName = nepDate.MonthName;

Additional Functions

using NepDate;

var nepDate = DateTime.Now.ToNepaliDate();

// get the equivalent Nepali date as string
var nepDateAsString = nepDate.ToString();

// determine if the Nepali year is a leap year
var isLeapYear = nepDate.IsLeapYear();

// add or subtract days from a Nepali date
var newDate = nepDate.AddDays(10);

// get next month as a NepDate object
var nextMonth = nepDate.NextMonth();

// get previous month as a NepDate object
var nextMonth = nepDate.PreviousMonth();

// subtract two Nepali dates to get a TimeSpan object
var nepDate2 = new NepaliDate("2080/12/16");
var timeSpan = nepDate2 - nepDate;
// or
var timeSpan = nepDate2.Subtract(nepDate);

// check if a string is a valid Nepali date and convert it to a NepaliDate object
if (NepaliDate.TryParse("2079/13/16", out var result))
{
    // use the result NepaliDate object
}

Comparing NepaliDate objects

using NepDate;

var nepDate = NepaliDate.Parse("2079/12/16");
var nepDate2 = DateTime.Now.ToNepaliDate();

if (nepDate == nepDate2)
{
    // the two NepaliDate objects are equal
}

if (nepDate < nepDate2)
{
    // nepDate is earlier than nepaliDate2
}

if (nepDate > nepDate2)
{
    // nepDate is after nepaliDate2
}

// etc

You just need the conversion?

using NepDate;

// Convert a DateTime directly to a NepaliDate string
var convertedToBS = DateTime.Now.ToNepaliDate().ToString();

// Convert a NepaliDate string directly to a DateTime
var convertedToAD = NepaliDate.Parse("2079/12/16").EnglishDate;

Performance

NepDate is distinguished by its capacity to perform with exceptional speed while utilizing minimal runtime memory resources. The metrics presented below exemplify NepDate's remarkable efficiency and proficiency, while remaining mindful of resource consumption.

The benchmarks can be found in NepDate.Benchmarks & NepDate.DotNetFrameworkBench

Output from latest run is

BenchmarkDotNet=v0.13.5, OS=Windows 11 (10.0.22621.1413/22H2/2022Update/SunValley2)
Intel Core i5-10400 CPU 2.90GHz, 1 CPU, 12 logical and 6 physical cores
.NET SDK=7.0.200
  [Host]     : .NET 7.0.3 (7.0.323.6910), X64 RyuJIT AVX2
  DefaultJob : .NET 7.0.3 (7.0.323.6910), X64 RyuJIT AVX2

BenchmarkDotNet=v0.13.5, OS=Windows 11 (10.0.22621.1413/22H2/2022Update/SunValley2)
Intel Core i5-10400 CPU 2.90GHz, 1 CPU, 12 logical and 6 physical cores
  [Host]     : .NET Framework 4.8.1 (4.8.9139.0), X86 LegacyJIT
  DefaultJob : .NET Framework 4.8.1 (4.8.9139.0), X86 LegacyJIT

Contributions

Please view the CONTRIBUTING guide for more information.