NepaliDatePicker.Maui 1.0.0-preview1

NepaliDatePicker.Maui

A Bikram Sambat (BS) date picker for .NET MAUI built on a Material Design calendar grid. Supports bottom-sheet and dialog presentation, BS ↔ AD dual-calendar toggle, full Devanagari script rendering, and rich theming.

Features

Installation

// MauiProgram.cs
builder.AddNepaliDatePicker();

Add the XAML namespace where needed:

xmlns:nep="clr-namespace:NepaliDatePicker.Controls;assembly=NepaliDatePicker.Maui"

Usage

Drop-in XAML control

<nep:NepaliDatePicker
    SelectedDate="{Binding MyDate}"
    Placeholder="Pick a date…"
    Format="d MMMM yyyy"
    DisplayMode="Both"
    UseNepaliScript="False"
    DateSelected="OnDateSelected" />

Programmatic / MVVM

// Inject INepaliDatePickerService
public MyViewModel(INepaliDatePickerService picker) => _picker = picker;

[RelayCommand]
async Task OpenPicker()
{
    var opts = new NepaliDatePickerOptions
    {
        DisplayMode     = DateDisplayMode.Both,
        Presentation    = PickerPresentation.BottomSheet,
        UseNepaliScript = false,
    };
    NepaliDate? result = await _picker.ShowAsync(SelectedDate, opts);
    if (result is not null)
        SelectedDate = result;
}

NepaliDatePicker control

The drop-in control renders as a tappable date-input field. All properties are bindable.

Core

Picker behaviour

Picker theming (passed through to the sheet)

Button appearance

Event

NepaliDatePickerOptions

Passed to INepaliDatePickerService.ShowAsync() for full programmatic control.

Behaviour

Full palette

Every color token is nullable — unset tokens fall back to MD3 defaults.

DateDisplayMode enum

PickerPresentation enum

Nepali script mode (UseNepaliScript)

When enabled (and DisplayMode is BsOnly or Both with BS active):

• Month names — "Baisakh" → "बैशाख", "Jestha" → "जेठ", … "Chaitra" → "चैत्र"
• Day numbers — 1–32 → १–३२
• Year number — 2082 → २०८२
• Weekday header row — S M T W T F S → आइ सो मं बु बि शु श
• Header date line — "Sun, Baisakh 5, 2082" → "आइत, बैशाख ५, २०८२"
• Header label — "SELECT DATE" → "मिति छान्नुहोस्"

AD dates always remain in English regardless of this setting.

INepaliDatePickerService

public interface INepaliDatePickerService
{
    /// Current date in Bikram Sambat.
    NepaliDate Today { get; }

    /// Open the picker and await the user's selection.
    /// Returns null if the user cancels.
    Task<NepaliDate?> ShowAsync(NepaliDate? initialDate = null,
                                NepaliDatePickerOptions? options = null);
}

Registered as transient by AddNepaliDatePicker(). Inject via constructor in your ViewModel.

NepaliDate model

var d = new NepaliDate(2082, 1, 15);

d.Year            // 2082
d.Month           // 1
d.Day             // 15
d.MonthName       // "Baisakh"
d.MonthNameNepali // "बैशाख"
d.ToDisplayString() // "15 Baisakh 2082"
d.ToString()        // "2082/01/15"
d.IsValid()         // true

BS ↔ AD conversion

using NepaliDatePicker.Services;

// BS → AD
DateTime ad = BsAdConverter.BsToAd(new NepaliDate(2082, 1, 15));

// AD → BS
NepaliDate bs = BsAdConverter.AdToBs(DateTime.Today);

// Formatted AD string
string label = BsAdConverter.FormatAdEquivalent(new NepaliDate(2082, 1, 15));
// → "28 April 2025"

Conversion data covers 1970 – 2100 BS using official Government of Nepal calendar tables.

Project layout

src/                               ← NuGet library
│  MauiAppBuilderExtensions.cs     service registration
│  NepaliDatePickerPage.cs         modal page (scrim + sheet)
│  NepaliDatePickerService.cs      INepaliDatePickerService implementation
│
├─ Controls/
│   NepaliDatePickerSheet.cs       MD3 calendar sheet (header, nav, grid, year picker)
│   NepaliDatePickerButton.cs      drop-in bindable input control
│   DrumRollPicker.cs              scroll-snap drum roll (internal)
│
├─ Data/
│   BsCalendarData.cs              1970–2100 BS month-day counts
│
├─ Models/
│   NepaliDate.cs                  record: Year / Month / Day + helpers
│   NepaliDatePickerOptions.cs     picker configuration
│   DateDisplayMode.cs             BsOnly / AdOnly / Both enum
│   PickerPresentation.cs          BottomSheet / Dialog enum
│
└─ Services/
    BsAdConverter.cs               BS ↔ AD conversion utilities
    INepaliDatePickerService.cs    public service interface

example/                           ← demo MAUI app (Android / iOS / Windows)

License

MIT