DateTimePickerModel API in Angular DateTimePicker API component

Interface for a class DateTimePicker

Properties

blur

EmitType<Object>

Triggers when input loses the focus.

change

EmitType<ChangedEventArgs>

Triggers when the Calendar value is changed.

cleared

EmitType<ClearedEventArgs>

Triggers when datetimepicker value is cleared using clear button.

close

EmitType<Object>

Triggers when popup is closed.

created

EmitType<Object>

Triggers when DateTimePicker is created.

destroyed

EmitType<Object>

Triggers when DateTimePicker is destroyed.

focus

EmitType<Object>

Triggers when input gets focus.

navigated

EmitType<NavigatedEventArgs>

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

open

EmitType<Object>

Triggers when popup is opened.

renderDayCell

EmitType<RenderDayCellEventArgs>

Triggers when each day cell of the Calendar is rendered.

allowEdit

boolean

Support for allowEdit has been provided from v16.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.

calendarMode

CalendarType

Gets or sets the Calendar’s Type like gregorian or islamic.

cssClass

string

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

dayHeaderFormat

DayHeaderFormats

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.

depth

CalendarView

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.

enableMask

boolean

Specifies whether it is a masked datetimepicker or not. By default the datetimepicker component render without masked input. If you need masked datetimepicker input then specify it as true.

enablePersistence

boolean

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

1. value

enableRtl

boolean

Enable or disable rendering component in right to left direction.

enabled

boolean

Specifies the component to be disabled or not.

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.

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.

format

string | FormatObject

Specifies the format of the value that to be displayed in component. By default, the format is based on the culture. You can set the format to “format:‘dd/MM/yyyy hh:mm’” or “format:{skeleton:‘medium’}” either in string or object.

To know more about the date format standards, refer to the Internationalization Date Format Internationalization section.

fullScreenMode

boolean

Specifies the component popup display full screen in mobile devices.

htmlAttributes

{ : }

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.

<ejs-datetimepicker [htmlAttributes]="htmlAttributes"></ejs-datetimepicker>

import { Component, ViewEncapsulation } from '@angular/core';

@Component({
  selector: 'app-root',
  styleUrls: ['app.component.css'],
  templateUrl: 'app.component.html',
  encapsulation: ViewEncapsulation.None
})

export class AppComponent {
  constructor() { }
  public htmlAttributes = { name: "appointment", placeholder:"Select a date and time" };
}

keyConfigs

{ : }

Customizes the key actions in DateTimePicker. For example, when using German keyboard, the key actions can be customized using these shortcuts. Input Navigation

Calendar Navigation (Use the following list of keys to navigate the currently focused Calendar after the popup has opened).

TimePicker Navigation (Use the below list of shortcut keys to interact with the TimePicker after the TimePicker Popup has opened).

<ejs-datetimepicker [keyConfigs]="keyConfigs"></ejs-datetimepicker>

import { Component, ViewEncapsulation } from '@angular/core';

@Component({
  selector: 'app-root',
  styleUrls: ['app.component.css'],
  templateUrl: 'app.component.html',
  encapsulation: ViewEncapsulation.None
})

export class AppComponent {
  constructor() { }
  public keyConfigs = {
    select: "space",
    home: "ctrl+home",
    end: "ctrl+end"
  };
}

locale

string

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

maskPlaceholder

MaskPlaceholderModel

Specifies the mask placeholder to be displayed on masked datetimepicker.

max

Date

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

maxTime

Date

Gets or sets the maximum time that can be selected in the time popup of the DateTimePicker.

min

Date

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

minTime

Date

Gets or sets the minimum time that can be selected in the time popup of the DateTimePicker.

openOnFocus

boolean

By default, the popup opens while clicking on the datetimepicker icon. If you want to open the popup while focusing the datetime input then specify its value as true.

placeholder

string

Specifies the placeholder text that to be is displayed in textbox.

readonly

boolean

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

scrollTo

Date

Specifies the scroll bar position if there is no value is selected in the timepicker popup list or the given value is not present in the timepicker popup list.

<ejs-datetimepicker [scrollTo]="scrollTo"></ejs-datetimepicker>

import { Component, ViewEncapsulation } from '@angular/core';

@Component({
  selector: 'app-root',
  styleUrls: ['app.component.css'],
  templateUrl: 'app.component.html',
  encapsulation: ViewEncapsulation.None
})

export class AppComponent {
  constructor() { }
  public scrollTo = new Date("1/1/2018 5:30 PM");
}

serverTimezoneOffset

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.

showClearButton

boolean

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

showTodayButton

boolean

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

start

CalendarView

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.

step

number

Specifies the time interval between the two adjacent time values in the time popup list .

strictMode

boolean

Specifies the component to act as strict. So that, it allows to enter only a valid date and time 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 value with highlighted error class.

timeFormat

string

Specifies the format of the time value that to be displayed in time popup list.

value

Date

Gets or sets the selected date of the Calendar.

weekNumber

boolean

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

weekRule

WeekRule

Specifies the rule for defining the first week of the year.

width

number | string

Specifies the width of the DatePicker component.

zIndex

number

specifies the z-index value of the popup element.