Getting Started with Blazor DateTime Picker Component

16 Sep 20213 minutes to read

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

To get start quickly with Blazor DateTimePicker 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 DateTimePicker component to the application

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

The following code shows a basic DateTimePicker component.

<SfDateTimePicker TValue="DateTime?" Placeholder='Select a date and time'></SfDateTimePicker>

Run the application

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

The output will be as follows.

Blazor DateTimePicker Component

Setting the Value, Min and Max

The minimum and maximum date time can be defined with the help of Min and Max properties.

The following code demonstrates how to set the Min and Max on initializing the DateTimePicker. TValue specifies the type of the DatePicker component.

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

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

Setting Minimum and Maximum Value in Blazor DateTimePicker

See Also