XCalendar

A cross-platform plugin for .NET providing a Calendar API and DateTime extensions.

UI controls are available for Xamarin Forms and .NET MAUI, able to run on any platform the respective framework supports.

Features

Ability to use the Calendar from code without referencing a UI framework.
Ability to use and reference your own models by implementing interfaces like ICalendar, ICalendarDay, or IEvent.
Ability to set the number of rows/weeks shown or have it be automatic.
Ability to change the start of the week to any day of the week.
Ability to select single, multiple or a range of dates.
Ability to specify a selection direction, for example restricting range selection from start to finish or finish to start
Ability to restrict navigation to a range of dates and define how the calendar loops.
Ability to specify your own custom order of days of week, with support for duplicates and non-chronological orders.
Fully customisable CalendarView with custom controls, templates, and exposed default styles and commands.
Support for localising text (such as days of the week and day numbers).
And more!

Roadmap

Features (Xamarin Forms/MAUI)

Default calendar control that exposes many customisation properties, making the calendar easier to use out-of-the-box instead of requiring usage of templates and styles.
Default implementation of selection and navigation commands, making the calendar easier to use out-of-the-box.
Default feature-based calendar controls such as "EventCalendar"/"AppointmentCalendar".
Some type of time schedule control Discussion 153
Culture/Locale property for CalendarView
YearView
DecadeView
CenturyView
Day, Month, and year properties as an alternative to NavigatedDate.

Maui Community Toolkit

Follow the discussion for moving XCalendar into the Maui Community Toolkit here.

Images

Standard Calendar

Custom Days Of Week (Unordered/Duplicates)

Custom Days Of Week (3 Days Of Week)

Custom Week Amount (1 Week)

Custom Week Amount (2 Weeks)

Day Styles

Sample App

The sample app has a flyout menu where you can access the following pages:

Playground Page

A page where you can modify almost every single property of the CalendarView. Perfect for a quick look, showcases, tests and experiments!

Examples Page

A page where you can search for examples of how to use XCalendar.

Examples include:

Event Calendar

Custom DatePicker Dialog

Selection

Using DayView

Customising A Day

Animated Swipable Calendar

https://user-images.githubusercontent.com/73718829/209573341-b506e399-631b-4cdd-b840-d17bb5ddfb85.mp4

Connecting Selected Days

Duolingo Streak Calendar

| Official App | Sample App | | ------------ | ---------- | | <img src="https://github.com/ME-MarvinE/XCalendar/assets/73718829/1663a8df-9c7e-4e23-8a5d-3c981bcc030d" width="100%"> | <img src="https://github.com/ME-MarvinE/XCalendar/assets/73718829/276d2a66-ef58-4425-af45-791d3100decb" width="100%"> |

Basic Usage

.NET

Install the NuGet package

https://www.nuget.org/packages/XCalendar.Core

Now you can use the Calendar

public Calendar MyCalendar { get; set; } = new Calendar();

Xamarin Forms

Install the NuGet package

https://www.nuget.org/packages/XCalendar.Forms

Create a Calendar in your ViewModel

public Calendar MyCalendar { get; set; } = new Calendar();

Add the following xmlns to your page or view

xmlns:xc="clr-namespace:XCalendar.Forms.Views;assembly=XCalendar.Forms"

Bind to the properties of your Calendar

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage
    x:Class="App1.MainPage"
    xmlns="http://xamarin.com/schemas/2014/forms"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:xc="clr-namespace:XCalendar.Forms.Views;assembly=XCalendar.Forms">
    
        <xc:CalendarView
            Days="{Binding MyCalendar.Days}"
            DaysOfWeek="{Binding MyCalendar.DayNamesOrder}"
            NavigatedDate="{Binding MyCalendar.NavigatedDate}"/>

</ContentPage>

Alternatively, these properties can be set directly from code-behind without the use of MVVM.

Youtube Tutorial (Outdated - Uses version 1.2.1 for Xamarin Forms)

.NET MAUI

Install the NuGet package

https://www.nuget.org/packages/XCalendar.Maui

Create a Calendar in your ViewModel

public Calendar MyCalendar { get; set; } = new Calendar();

Add the following xmlns to your page or view

xmlns:xc="clr-namespace:XCalendar.Maui.Views;assembly=XCalendar.Maui"

Bind to the properties of your Calendar

<ContentPage
    x:Class="MauiApp1.MainPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:xc="clr-namespace:XCalendar.Maui.Views;assembly=XCalendar.Maui">
    
        <xc:CalendarView
            Days="{Binding MyCalendar.Days}"
            DaysOfWeek="{Binding MyCalendar.DayNamesOrder}"
            NavigatedDate="{Binding MyCalendar.NavigatedDate}"/>

</ContentPage>

Alternatively, these properties can be set directly from code-behind without the use of MVVM.

Navigation Overview

Calendar

Navigation can be performed by setting the NavigatedDate property of the Calendar.

Alternatively, navigation can be performed using the Navigate method; it takes a parameter specifying the TimeSpan to navigate by. The Calendar can handle exceptions caused by non-representable dates such as DateTime.MaxValue.AddDays(1).

Variable time units such as months can be obtained by using the'AddMonths' method on a DateTime and subtracting the result from the current date. The 'TryAdd' and 'TrySubtract' methods in DateTimeExtensions are useful if you ever plan to navigate to the

XCalendar

Install / Use

README

XCalendar

Features

Roadmap

Features (Xamarin Forms/MAUI)

Maui Community Toolkit

Images

Standard Calendar

Custom Days Of Week (Unordered/Duplicates)

Custom Days Of Week (3 Days Of Week)

Custom Week Amount (1 Week)

Custom Week Amount (2 Weeks)

Day Styles

Sample App

Playground Page

Examples Page

Event Calendar

Custom DatePicker Dialog

Selection

Using DayView

Customising A Day

Animated Swipable Calendar

Connecting Selected Days

Duolingo Streak Calendar

Basic Usage

.NET

Install the NuGet package

Now you can use the Calendar

Xamarin Forms

Install the NuGet package

Create a Calendar in your ViewModel

Add the following xmlns to your page or view

Bind to the properties of your Calendar

Youtube Tutorial (Outdated - Uses version 1.2.1 for Xamarin Forms)

.NET MAUI

Install the NuGet package

Create a Calendar in your ViewModel

Add the following xmlns to your page or view

Bind to the properties of your Calendar

Navigation Overview

Calendar