Interface for a class DateRangePicker
EmitType<BlurEventArgs>
Triggers when the control loses the focus.
Triggers when the Calendar value is changed.
Triggers when daterangepicker value is cleared using clear button.
EmitType<Object>
Triggers when the DateRangePicker is closed.
EmitType<Object>
Triggers when Calendar is created.
EmitType<Object>
Triggers when Calendar is destroyed.
EmitType<FocusEventArgs>
Triggers when the control gets focus.
Triggers when the Calendar is navigated to another view or within the same level of view.
EmitType<Object>
Triggers when the DateRangePicker is opened.
EmitType<RenderDayCellEventArgs>
Triggers when each day cell of the Calendar is rendered.
EmitType<Object>
Triggers on selecting the start and end date.
boolean
Support for
allowEdit
has been provided fromv16.2.46
. Specifies whether the input textbox is editable or not. Here the user can select the value from the popup and cannot edit in the input textbox.
string
Sets the root CSS class to the DateRangePicker which allows you to customize the appearance.
Specifies the format of the day that to be displayed in header. By default, the format is ‘short’. Possible formats are:
Short
- Sets the short format of day name (like Su ) in day header.Narrow
- Sets the single character of day name (like S ) in day header.Abbreviated
- Sets the min format of day name (like Sun ) in day header.Wide
- Sets the long format of day name (like Sunday ) in day header.Sets the maximum level of view (month, year, decade) in the Calendar. Depth view should be smaller than the start view to restrict its view navigation.
boolean
Enable or disable the persisting component’s state between the page reloads. If enabled, following list of states will be persisted.
boolean
Enable or disable rendering component in right to left direction.
boolean
Specifies the component to be disabled which prevents the DateRangePicker from user interactions.
Date
Gets or sets the end date of the date range selection.
number
Gets or sets the Calendar’s first day of the week. By default, the first day of the week will be based on the current culture.
For more details about firstDayOfWeek refer to
First day of week
documentation.
FloatLabelType
| string
Specifies the placeholder text to be floated. Possible values are: Never: The label will never float in the input when the placeholder is available. Always: The floating label will always float above the input. Auto: The floating label will float above the input after focusing or entering a value in the input.
string
| RangeFormatObject
Sets or gets the required date format to the start and end date string.
For more details refer to
Format
sample.
{ [key: string]: string }
You can add the additional html attributes such as disabled, value etc., to the element. If you configured both property and equivalent html attribute then the component considers the property value.
<input id="daterangepicker" type="text">
import { DateRangePicker } from '@syncfusion/ej2-calendars';
let daterangepicker: DateRangePicker = new DateRangePicker({
htmlAttributes: { name: "range", placeholder:"Choose a range" }
});
daterangepicker.appendTo('#daterangepicker');
{ [key: string]: string }
Customizes the key actions in DateRangePicker. For example, when using German keyboard, the key actions can be customized using these shortcuts. Input Navigation
Key action |
Key |
altUpArrow |
alt+uparrow |
altDownArrow |
alt+downarrow |
escape |
escape |
Calendar Navigation (Use the following list of keys to navigate the currently focused Calendar after the popup has opened).
Key action |
Key |
controlUp |
ctrl+38 |
controlDown |
ctrl+40 |
moveDown |
downarrow |
pageUp |
pageup |
pageDown |
pagedown |
shiftPageUp |
shift+pageup |
shiftPageDown |
shift+pagedown |
moveUp |
uparrow |
moveLeft |
leftarrow |
moveRight |
rightarrow |
select |
enter |
home |
home |
end |
end |
controlHome |
ctrl+home |
controlEnd |
ctrl+end |
altUpArrow |
alt+uparrow |
spacebar |
space |
enter |
enter |
altRightArrow |
alt+rightarrow |
altLeftArrow |
alt+leftarrow |
<input id="daterangepicker" type="text">
import { DateRangePicker } from '@syncfusion/ej2-calendars';
let daterangepicker: DateRangePicker = new DateRangePicker({
keyConfigs: {
select: "space",
home: "ctrl+home",
end: "ctrl+end"
}
});
daterangepicker.appendTo('#daterangepicker');
string
Overrides the global culture and localization value for this component. Default global culture is ‘en-US’.
Date
Gets or sets the maximum date that can be selected in the calendar-popup.
number
Specifies the maximum span of days that can be allowed in a date range selection.
For more details refer to
Range Span
documentation.
Date
Gets or sets the minimum date that can be selected in the calendar-popup.
number
Specifies the minimum span of days that can be allowed in date range selection.
For more details refer to
Range Span
documentation.
boolean
By default, the popup opens while clicking on the daterangepicker icon. If you want to open the popup while focusing the daterange input then specify its value as true.
string
Specifies the placeholder text that need to be displayed in the DateRangePicker component.
Set the predefined ranges which let the user pick required range easily in a component.
For more details refer to
Preset Ranges
documentation.
<input id="daterangepicker" type="text">
import { DateRangePicker } from '@syncfusion/ej2-calendars';
let daterangepicker: DateRangePicker = new DateRangePicker({
presets: [
{ label: 'Today', start: new Date(), end: new Date() },
{ label: 'This Month', start: new Date(new Date().setDate(1)), end: new Date() }
]
});
daterangepicker.appendTo('#daterangepicker');
boolean
Denies the editing the ranges in the DateRangePicker component.
string
Sets or gets the string that used between the start and end date string.
number
By default, the date value will be processed based on system time zone.
If you want to process the initial date value using server time zone
then specify the time zone value to serverTimezoneOffset
property.
boolean
Specifies whether to show or hide the clear icon
Specifies the initial view of the Calendar when it is opened. With the help of this property, initial view can be changed to year or decade view.
Date
Gets or sets the start date of the date range selection.
boolean
Specifies the component to act as strict which allows entering only a valid date range in a DateRangePicker.
For more details refer to
Strict Mode
documentation.
Date[]
| DateRange
Gets or sets the start and end date of the Calendar.
<input id="daterangepicker" type="text">
import { DateRangePicker } from '@syncfusion/ej2-calendars';
let daterangepicker: DateRangePicker = new DateRangePicker({
value:[new Date(), new Date("12/12/2019")]
});
daterangepicker.appendTo('#daterangepicker');
boolean
Determines whether the week number of the Calendar is to be displayed or not. The week number is displayed in every week row.
For more details about weekNumber refer to
Calendar with week number
documentation.
Specifies the rule for defining the first week of the year.
number
| string
Specifies the width of the DateRangePicker component.
number
specifies the z-index value of the dateRangePicker popup element.