Getting Started with Blazor DatePicker Component

16 Sep 20213 minutes to read

This section briefly explains about how to include a Blazor DatePicker Component in your Blazor Server-Side and Client-Side application. You can refer to our Getting Started with Blazor Server-Side DatePicker and Blazor WebAssembly DatePicker documentation pages for configuration specifications.

To get start quickly with Blazor DatePicker component, you can check on this video.

Importing Syncfusion Blazor component in the application

  • Install Syncfusion.Blazor.Calendars NuGet package to the application by using the NuGet Package Manager.

  • You can add the client-side resources through CDN or from NuGet package in the HEAD element of the ~/wwwroot/index.html page.

<head>
    <link href="_content/Syncfusion.Blazor.Themes/bootstrap4.css" rel="stylesheet" />
    <!-- <link href="https://cdn.syncfusion.com/blazor//styles/.css" rel="stylesheet" /> -->
</head>

For Internet Explorer 11 kindly refer the polyfills. Refer the documentation for more information.

<head>
    <link href="_content/Syncfusion.Blazor.Themes/bootstrap4.css" rel="stylesheet" />
    <script src="https://github.com/Daddoon/Blazor.Polyfill/releases/download/3.0.1/blazor.polyfill.min.js"></script>
</head>

Adding component package to the application

Open ~/_Imports.razor file and import the Syncfusion.Blazor.Calendars package.

@using Syncfusion.Blazor.Calendars

Add SyncfusionBlazor service in Program.cs

Open the Program.cs file and add services required by Syncfusion components using builder.Services.AddSyncfusionBlazor() method.

using Syncfusion.Blazor;

namespace BlazorApplication
{
    public class Program
    {
        public static async Task Main(string[] args)
        {
            ....
            ....
            builder.Services.AddSyncfusionBlazor();
            await builder.Build().RunAsync();
        }
    }
}

To enable custom client side resource loading from CRG or CDN. You need to disable resource loading by AddSyncfusionBlazor(true) and load the scripts in the HEAD element of the ~/wwwroot/index.html page.

<head>
    <script src="https://cdn.syncfusion.com/blazor/19.3.43/syncfusion-blazor.min.js"></script>
</head>

Adding DatePicker component to the application

To initialize the DatePicker component add the below code to your Index.razor view page which is present under ~/Pages folder.

The following code shows a basic DatePicker component.

<SfDatePicker TValue="DateTime?" Placeholder='Choose a Date'></SfDatePicker>

Run the application

After the successful compilation of your application, press F5 to run the application.

The output will be as follows.

Blazor DatePicker Component

Setting the Value and Min and Max dates

The following example demonstrates how to set the Value and Min and Max dates on initializing the DatePicker. Here, you can select a date within the range from 5th to 27th of this month. TValue specifies the type of the DatePicker component.

<SfDatePicker TValue="DateTime?" Value='@DateValue' Min='@MinDate' Max='@MaxDate'></SfDatePicker>

@code {
    public DateTime? DateValue {get;set;} = new DateTime(DateTime.Now.Year,DateTime.Now.Month,10);
    public DateTime MinDate {get;set;} = new DateTime(DateTime.Now.Year,DateTime.Now.Month,05);
    public DateTime MaxDate {get;set;} = new DateTime(DateTime.Now.Year, DateTime.Now.Month, 27);
}

The output will be as follows.

Settin Minimum and Maximum Dates in Blazor DatePicker

See Also