RadzenDateRangePicker Class

A date range picker component that provides a calendar popup for selecting a start and end date. RadzenDateRangePicker binds to a DateRange value with nullable Start and End dates. Displays a text input rendering both dates separated by Separator and a calendar icon button. Clicking opens a popup calendar. The popup shows two months side by side by default - use DisplayMonths to change the number of displayed months. The first click in the calendar selects the start date, the second click selects the end date and closes the popup. Clicking a date before the pending start date restarts the selection from that date. While picking the end date the days between the start date and the hovered day are highlighted as a preview of the prospective range. Supports min/max date constraints, disabled dates via DateRender, inline calendar mode, and culture-specific formatting.

Inheritance

Object

ComponentBase

RadzenComponent

RadzenDatePicker<DateRange>

RadzenDateRangePicker

Implements

IComponent

IHandleEvent

IHandleAfterRender

IRadzenFormComponent

Inherited Members

RadzenDatePicker<DateRange>.OnPopupClose

RadzenDatePicker<DateRange>.OnInitialized

RadzenDatePicker<DateRange>.ParseDate

RadzenDatePicker<DateRange>.ParseDateImmediate

RadzenDatePicker<DateRange>.Close

RadzenDatePicker<DateRange>.GetComponentCssClass

RadzenDatePicker<DateRange>.SetParametersAsync

RadzenDatePicker<DateRange>.OnAfterRenderAsync

RadzenDatePicker<DateRange>.Dispose

RadzenDatePicker<DateRange>.GetValue

RadzenDatePicker<DateRange>.FocusAsync

RadzenDatePicker<DateRange>.BuildRenderTree

RadzenDatePicker<DateRange>.Immediate

RadzenDatePicker<DateRange>.ShowCalendarWeek

RadzenDatePicker<DateRange>.Multiple

RadzenDatePicker<DateRange>.NavigationMode

RadzenDatePicker<DateRange>.CalendarWeekTitle

RadzenDatePicker<DateRange>.ToggleAriaLabel

RadzenDatePicker<DateRange>.PopupAriaLabel

RadzenDatePicker<DateRange>.ClearAriaLabel

RadzenDatePicker<DateRange>.HourAriaLabel

RadzenDatePicker<DateRange>.MinutesAriaLabel

RadzenDatePicker<DateRange>.SecondsAriaLabel

RadzenDatePicker<DateRange>.OkAriaLabel

RadzenDatePicker<DateRange>.PrevMonthAriaLabel

RadzenDatePicker<DateRange>.NextMonthAriaLabel

RadzenDatePicker<DateRange>.PrevYearAriaLabel

RadzenDatePicker<DateRange>.NextYearAriaLabel

RadzenDatePicker<DateRange>.ToggleAmPmAriaLabel

RadzenDatePicker<DateRange>.TodayAriaLabel

RadzenDatePicker<DateRange>.SelectedAriaLabel

RadzenDatePicker<DateRange>.DisabledAriaLabel

RadzenDatePicker<DateRange>.RangeStartAriaLabel

RadzenDatePicker<DateRange>.RangeEndAriaLabel

RadzenDatePicker<DateRange>.InputAttributes

RadzenDatePicker<DateRange>.YearFormatter

RadzenDatePicker<DateRange>.YearFormat

RadzenDatePicker<DateRange>.AllowClear

RadzenDatePicker<DateRange>.TabIndex

RadzenDatePicker<DateRange>.Name

RadzenDatePicker<DateRange>.InputClass

RadzenDatePicker<DateRange>.ButtonClass

RadzenDatePicker<DateRange>.Min

RadzenDatePicker<DateRange>.Max

RadzenDatePicker<DateRange>.InitialViewDate

RadzenDatePicker<DateRange>.DateRender

RadzenDatePicker<DateRange>.Kind

RadzenDatePicker<DateRange>.Value

RadzenDatePicker<DateRange>.CurrentDateChanged

RadzenDatePicker<DateRange>.IsBound

RadzenDatePicker<DateRange>.HasValue

RadzenDatePicker<DateRange>.FormattedValue

RadzenDatePicker<DateRange>.Form

RadzenDatePicker<DateRange>.ParseInput

RadzenDatePicker<DateRange>.Inline

RadzenDatePicker<DateRange>.TimeOnly

RadzenDatePicker<DateRange>.ReadOnly

RadzenDatePicker<DateRange>.AllowInput

RadzenDatePicker<DateRange>.ShowButton

RadzenDatePicker<DateRange>.ShowInput

RadzenDatePicker<DateRange>.Disabled

RadzenDatePicker<DateRange>.FormFieldContext

RadzenDatePicker<DateRange>.ShowDays

RadzenDatePicker<DateRange>.ShowTime

RadzenDatePicker<DateRange>.ShowHour

RadzenDatePicker<DateRange>.ShowMinutes

RadzenDatePicker<DateRange>.ShowSeconds

RadzenDatePicker<DateRange>.HoursStep

RadzenDatePicker<DateRange>.MinutesStep

RadzenDatePicker<DateRange>.SecondsStep

RadzenDatePicker<DateRange>.PadHours

RadzenDatePicker<DateRange>.PadMinutes

RadzenDatePicker<DateRange>.PadSeconds

RadzenDatePicker<DateRange>.ShowTimeOkButton

RadzenDatePicker<DateRange>.DateFormat

RadzenDatePicker<DateRange>.YearRange

RadzenDatePicker<DateRange>.HourFormat

RadzenDatePicker<DateRange>.Placeholder

RadzenDatePicker<DateRange>.Change

RadzenDatePicker<DateRange>.OkClick

RadzenDatePicker<DateRange>.ValueChanged

RadzenDatePicker<DateRange>.FooterTemplate

RadzenDatePicker<DateRange>.CurrentPlaceholder

RadzenDatePicker<DateRange>.InputSize

RadzenDatePicker<DateRange>.EditContext

RadzenDatePicker<DateRange>.FieldIdentifier

RadzenDatePicker<DateRange>.ValueExpression

RadzenDatePicker<DateRange>.PopupRenderMode

RadzenDatePicker<DateRange>.input

RadzenComponent.OnMouseEnter

RadzenComponent.OnMouseLeave

RadzenComponent.OnContextMenu

RadzenComponent.GetCssClass

RadzenComponent.GetId

RadzenComponent.GetIdAttribute

RadzenComponent.Debounce

RadzenComponent.Localize

RadzenComponent.RaiseContextMenu

RadzenComponent.RaiseMouseEnter

RadzenComponent.AddContextMenu

RadzenComponent.RaiseMouseLeave

RadzenComponent.OnBecameInvisible

RadzenComponent.Attributes

RadzenComponent.Element

RadzenComponent.MouseEnter

RadzenComponent.MouseLeave

RadzenComponent.ContextMenu

RadzenComponent.Culture

RadzenComponent.DefaultCulture

RadzenComponent.UICulture

RadzenComponent.DefaultUICulture

RadzenComponent.Style

RadzenComponent.Visible

RadzenComponent.UniqueID

RadzenComponent.JSRuntime

RadzenComponent.IsJSRuntimeAvailable

RadzenComponent.Reference

RadzenComponent.CurrentStyle

ComponentBase.OnInitializedAsync

ComponentBase.OnParametersSet

ComponentBase.OnParametersSetAsync

ComponentBase.StateHasChanged

ComponentBase.ShouldRender

ComponentBase.OnAfterRender

ComponentBase.InvokeAsync

ComponentBase.DispatchExceptionAsync

ComponentBase.RendererInfo

ComponentBase.Assets

ComponentBase.AssignedRenderMode

Namespace: Radzen.Blazor

Assembly: Radzen.Blazor.dll

Syntax

public class RadzenDateRangePicker : RadzenDatePicker<DateRange>, IComponent, IHandleEvent, IHandleAfterRender, IRadzenFormComponent

Examples

Basic date range picker:

<RadzenDateRangePicker @bind-Value=@range />
@code {
    DateRange range = new DateRange(DateTime.Today, DateTime.Today.AddDays(7));
}

Date range picker with constraints and custom format:

<RadzenDateRangePicker @bind-Value=@range Min="@DateTime.Today" Max="@DateTime.Today.AddMonths(6)" DateFormat="dd/MM/yyyy" AllowClear="true" />

Constructors

RadzenDateRangePickerLink to this section

A date range picker component that provides a calendar popup for selecting a start and end date. RadzenDateRangePicker binds to a DateRange value with nullable Start and End dates. Displays a text input rendering both dates separated by Separator and a calendar icon button. Clicking opens a popup calendar. The popup shows two months side by side by default - use DisplayMonths to change the number of displayed months. The first click in the calendar selects the start date, the second click selects the end date and closes the popup. Clicking a date before the pending start date restarts the selection from that date. While picking the end date the days between the start date and the hovered day are highlighted as a preview of the prospective range. Supports min/max date constraints, disabled dates via DateRender, inline calendar mode, and culture-specific formatting.

Declaration
public RadzenDateRangePicker()

Properties

DisplayMonthsLink to this section

Gets or sets the number of months displayed side by side in the calendar. Clamped between 1 and 6.

Declaration
public int DisplayMonths { get; set; }
Property Value
Type Description
intGets or sets the number of months displayed side by side in the calendar. Clamped between 1 and 6.

SeparatorLink to this section

Gets or sets the text separating the start and end dates in the input.

Declaration
public string Separator { get; set; }
Property Value
Type Description
stringGets or sets the text separating the start and end dates in the input.
An error has occurred. This app may no longer respond until reloaded. Reload 🗙