NepaliDatePicker.Maui 1.0.1

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.

Preview

Bottom Sheet — Light Theme

<table> <tr> <th>English (Purple)</th> <th>English (Teal)</th> <th>Nepali Script (Purple)</th> <th>Nepali Script (Teal)</th> </tr> <tr> <td><img src="preview/1.png" width="180"/></td> <td><img src="preview/2.png" width="180"/></td> <td><img src="preview/3.png" width="180"/></td> <td><img src="preview/4.png" width="180"/></td> </tr> </table>

Dialog — Light & Dark Theme

<table> <tr> <th>Light (Purple)</th> <th>Light (Teal)</th> <th>Dark (Teal)</th> </tr> <tr> <td><img src="preview/5.png" width="180"/></td> <td><img src="preview/6.png" width="180"/></td> <td><img src="preview/7.png" width="180"/></td> </tr> </table>

Year / Month Fast-Nav — Dark Theme

<table> <tr> <th>Purple Theme</th> <th>Teal Theme</th> </tr> <tr> <td><img src="preview/8.png" width="180"/></td> <td><img src="preview/9.png" width="180"/></td> </tr> </table>

Wheel Style

<table> <tr> <th>Dark Theme</th> <th>Light Theme</th> </tr> <tr> <td><img src="preview/10.png" width="180"/></td> <td><img src="preview/11.png" width="180"/></td> </tr> </table>

Input Style

<table> <tr> <th>Dark Theme</th> <th>Light Theme</th> </tr> <tr> <td><img src="preview/12.png" width="180"/></td> <td><img src="preview/13.png" width="180"/></td> </tr> </table>

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" />

Wheel picker style

Set PickerStyle="Wheel" to swap the calendar grid for three iOS-style drum-roll wheels (year | month | day). Works with every display mode, presentation and theme option; the day wheel adapts to the number of days in the selected month.

<nep:NepaliDatePicker
    SelectedDate="{Binding MyDate}"
    PickerStyle="Wheel"
    UseNepaliScript="True"
    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

PickerStyle enum

Nepali script mode (UseNepaliScript)

When enabled (and DisplayMode is BsOnly or Both with BS active — or AdOnly, where the AD calendar itself is rendered in Devanagari with Nepali Gregorian month names like जनवरी, फेब्रुअरी):

• 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.

Date utilities

Add using NepaliDatePicker.Formatting; to access the formatting classes and the extension methods they surface on NepaliDate.

NepaliDateFormatter — token-based formatting

Format a BS date with a pattern string, optionally in Devanagari script.

using NepaliDatePicker.Formatting;

var date = new NepaliDate(2082, 1, 15);   // 15 Baisakh 2082

NepaliDateFormatter.Format(date, "d MMMM yyyy")               // "15 Baisakh 2082"
NepaliDateFormatter.Format(date, "dd/MM/yyyy")                // "15/01/2082"
NepaliDateFormatter.Format(date, "EEEE, d MMMM yyyy")         // "Tuesday, 15 Baisakh 2082"
NepaliDateFormatter.Format(date, "EEE d MMM, yy")             // "Tue 15 Bai, 82"
NepaliDateFormatter.Format(date, "d MMMM yyyy", nepali: true) // "१५ बैशाख २०८२"
NepaliDateFormatter.Format(date, "EEEE, d MMMM yyyy", true)   // "मंगलबार, १५ बैशाख २०८२"

// Extension method shorthand
date.Format("d MMMM yyyy")

Pattern tokens

Wrap literal characters in single quotes — 'of' — to prevent token substitution. Use '' for a literal apostrophe.

NepaliMoment — relative time

Describes how long ago or until a BS date is, relative to today or a custom reference point.

using NepaliDatePicker.Formatting;

var date = new NepaliDate(2082, 1, 12);   // 3 days before 2082-01-15

NepaliMoment.Elapsed(date)                            // "3 days ago"
NepaliMoment.Elapsed(date, nepali: true)              // "३ दिन पहिले"

// With an explicit reference date
var reference = new NepaliDate(2082, 1, 15);
NepaliMoment.Elapsed(date, reference)                 // "3 days ago"
NepaliMoment.Elapsed(date, reference, nepali: true)   // "३ दिन पहिले"

// From AD DateTime
NepaliMoment.Elapsed(DateTime.Today.AddDays(-8))      // "1 week ago"

// Extension method shorthand
date.Elapsed()
date.Elapsed(nepali: true)

Threshold behaviour

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 (wheel picker style)
│
├─ 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
│
└─ Utils/
    NepaliDateFormatter.cs         token-based BS date formatter (Format)
    NepaliMoment.cs                relative-time strings (Elapsed)
    NepaliDateExtensions.cs        Format() and Elapsed() extension methods on NepaliDate

example/                           ← demo MAUI app (Android / iOS / Windows)
│  MainPage.xaml                   full-featured picker showcase
│  UtilsPage.xaml                  date utils demo (formatter · moment · amount)
│  CalendarPage.xaml               minimal AD-only dialog example

License

MIT