Search results

DatePickerComponent

Represents the Essential JS 2 Angular DatePicker Component.

<ejs-datepicker [value]='date'></ejs-datepicker>

Properties

allowEdit

boolean

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.

Defaults to true

cssClass

string

Specifies the root CSS class of the DatePicker that allows to customize the appearance by overriding the styles.

Defaults to null

depth

string

Sets the maximum level of view such as month, year, and decade in the Calendar. Depth view should be smaller than the start view to restrict its view navigation.

Defaults to Month

view
Description
Month
Calendar view shows up to the days of the month.
Year
Calendar view shows up to the months of the year.
Decade
Calendar view shows up to the years of the decade.
> For more details about depth refer to calendarViewdocumentation.

enablePersistence

boolean

Enable or disable persisting component’s state between page reloads. If enabled, following list of states will be persisted.

  1. value

Defaults to false

enableRtl

boolean

When set to true, enables RTL mode of the component that displays the content in the right-to-left direction.

Defaults to false

enabled

boolean

Specifies the component to be disabled or not.

Defaults to true

firstDayOfWeek

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.

Defaults to 0

floatLabelType

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.

Defaults to Syncfusion.EJ2.Inputs.FloatLabelType.Never

format

string

Specifies the format of the value that to be displayed in component. By default, the format is based on the culture.

Defaults to null

locale

string

Overrides the global culture and localization value for this component. Default global culture is ‘en-US’.

Defaults to undefined

max

Date

Gets or sets the maximum date that can be selected in the Calendar.

Defaults to new Date(2099, 11, 31)

min

Date

Gets or sets the minimum date that can be selected in the Calendar.

Defaults to new Date(1900, 00, 01)

placeholder

string

Specifies the placeholder text that displayed in textbox.

Defaults to null

readonly

boolean

Specifies the component in readonly state. When the Component is readonly it does not allow user input.

Defaults to false

showClearButton

boolean

Specifies whether to show or hide the clear icon in textbox.

Defaults to true

showTodayButton

boolean

Specifies whether the today button is to be displayed or not.

Defaults to true

start

string

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.

Defaults to Month

View
Description
Month
Calendar view shows the days of the month.
Year
Calendar view shows the months of the year.
Decade
Calendar view shows the years of the decade.
> For more details about start refer tocalendarViewdocumentation.

strictMode

boolean

Specifies the component to act as strict. So that, it allows to enter only a valid date value within a specified range or else it will resets to previous value. By default, strictMode is in false. it allows invalid or out-of-range date value with highlighted error class.

Defaults to false> For more details refer toStrict Mode documentation.

value

Date

Gets or sets the selected date of the Calendar.

Defaults to null

weekNumber

boolean

Determines whether the week number of the year is to be displayed in the calendar or not.

Defaults to false> For more details about weekNumber refer toCalendar with week numberdocumentation.

width

number | string

Specifies the width of the DatePicker component.

Defaults to null

zIndex

number

specifies the z-index value of the datePicker popup element.

Defaults to 1000

Methods

addDate

This method is used to add the single or multiple dates to the values property of the Calendar.

Parameter Type Description
dates Date | Date[] Specifies the date or dates to be added to the values property of the Calendar.

Returns void

currentView

Gets the current view of the DatePicker.

Returns string

destroy

To destroy the widget.

Returns void

focusIn

Sets the focus to widget for interaction.

Returns void

focusOut

Remove the focus from widget, if the widget is in focus state.

Returns void

getPersistData

Gets the properties to be maintained upon browser refresh.

Returns string

hide

Hide the Calendar.

Returns void

Navigates to specified month or year or decade view of the DatePicker.

Parameter Type Description
view string Specifies the view of the calendar.
date Date Specifies the focused date in a view.

Returns void

removeDate

This method is used to remove the single or multiple dates from the values property of the Calendar.

Parameter Type Description
dates Date | Date[] Specifies the date or dates which need to be removed from the values property of the Calendar.

Returns void

show

Shows the Calendar.

Returns void

Events

blur

EmitType<BlurEventArgs>

Triggers when the input loses the focus.

change

EmitType<ChangedEventArgs>

Triggers when the Calendar value is changed.

close

EmitType<PreventableEventArgs|PopupObjectArgs>

Triggers when the popup is closed.

created

EmitType<Object>

Triggers when the component is created.

destroyed

EmitType<Object>

Triggers when the component is destroyed.

focus

EmitType<FocusEventArgs>

Triggers when the input gets focus.

Triggers when the Calendar is navigated to another level or within the same level of view.

open

EmitType<PreventableEventArgs|PopupObjectArgs>

Triggers when the popup is opened.

renderDayCell

EmitType<RenderDayCellEventArgs>

Triggers when each day cell of the Calendar is rendered.