DateTimePicker

The DateTimePicker component is an editor where the user can enter date and time, or select desired date from the calendar.

Comments

The component works with the local time, amendments for the time zone must be made manually.

Example

Clicking the calendar button opens a calendar implemented with the MonthCalendar component:

Date value selected in the calendar, is set into the entry box implemented with the DateTimeEdit component.

The date can also be entered with the keyboard and changed with the UP or DOWN keys. Mark in the calendar is changed on changing date in the editor.

Constructor

Properties

	Property name	Brief description
	CurrentDate	The CurrentDate property sets the time and date for the component.
	DropHeight	The DropHeight property sets height of the area that houses a drop-down panel.
	DropWidth	The DropWidth property sets width of the area that houses a drop-down panel.
	MaxDate	The MaxDate property seta maximum possible value of date and time.
	MinDate	The MinDate property assigns the maximum available value of date for the component.
	Mode	The Mode property returns the display mode of the calendar and the component input box.
	MonthNames	The MonthNames property sets the array with the month names that are displayed in the editor input box in the month mode.
	NextMonthName	The NextMonthName property assigns the text of the tooltip for the Next Month button.
	NextYearName	The NextYearName property sets the tooltip text for the Next Year button.
	PreviousMonthName	The PreviousMonthName property sets the tooltip text for the Previous Month button.
	PreviousYearName	The PreviousYearName property sets the text of the tooltip for the Previous Year button.
	ShowTime	The ShowTime property determines whether a date is displayed in the component.
	TextAfterHalfYear	The TextAfterHalfYear property sets the text that is displayed in the input box after the half-year value.
	TextAfterMonth	The TextAfterMonth property sets text to be shown in the input box after the month value.
	TextAfterQuarter	The TextAfterQuarter property sets the text that is displayed in the input box after the quarter value.
	TextAfterWeek	The TextAfterWeek property sets text to be shown in the input box after the week value.
	TextAfterYear	The TextAfterYear property sets text to be shown in the input box after the year value.

Methods

Events

Properties inherited from the Combo class

	Property name	Brief description
	CloseOnContentClick	The CloseOnContentClick property determines whether a component panel can be closed on clicking the header.
	EnableEdit	The EnableEdit property sets the ability of input.
	IsDropHasCombosWidth	The IsDropHasCombosWidth property sets whether drop-down panel width does not depend on the input editor width.
	IsHint	The IsHint property determines whether a tooltip is displayed on the mouse hover on the button for opening of the drop-down panel.
	NoCreateEditors	The NoCreateEditors property determines whether the header is displayed as a simple text and not in the editors of the TextBox or MaskEdit components.
	OpenOnContentClick	The OpenOnContentClick property determines whether a component panel can be opened on clicking the header.
	OpenOnIconClick	The OpenOnIconClick property determines whether a component panel can be opened on clicking the header icon.
	OpenOnKeyDown	The OpenOnKeyDown property determines whether a pop-up panel can be opened on clicking a keyboard key.
	UseMask	The UseMask property sets whether the editor mask can be used.

Methods inherited from the Combo class

	Method name	Brief description
	applyNotValidCSS	The applyNotValidCSS method sets the style that determines highlighting invalid input value of the input editor.
	applyValidCSS	The applyValidCSS property sets the style that determines highlighting of valid input value of the input editor.
	getContentNode	The getContentNode method returns the DOM node of the input editor component.
	getDropPanel	The getDropPanel method returns the drop-down part of the component.
	getIconHeight	The getIconHeight method returns value of input editor icon height.
	getIconWidth	The getIconWidth method returns value of input editor icon width.
	getMaskEdit	The getMaskEdit method returns data input editor for data corresponding to a specific template.
	getTextBox	The getTextBox method returns text box of the input editor.
	setIconImageClass	The setIconImageClass method changes class name of the input editor component icon.
	showDropPanel	The showDropPanel method displays component's drop-down part.

Events, inherited from the Combo class

Properties inherited from the Control class

	Property name	Brief description
	Anchors	The Anchors property determines position of the component placed within container.
	Animation	The Animation property determines component animation parameters.
	Bottom	The Bottom property determines a bottom margin if a component is placed inside LayoutPanel.
	Content	The Content property determines component contents.
	ContextMenu	The ContextMenu property determines a component's context menu.
	Data	The Data property is used to store any custom data.
	Enabled	The Enabled property determines whether a component can be used.
	Height	The Height property determines component height.
	IsRTL	The IsRTL property determines whether component elements are aligned to the right.
	IsVisible	The IsVisible property determines whether a component is displayed.
	Left	The Left property determines a left margin if a component is placed inside GridPanel.
	Opacity	The Opacity property determines component transparency.
	Parent	The Parent property determines a parent component of a control.
	ParentNode	The ParentNode property determines a parent DOM node.
	ResourceKey	The ResourceKey property determines a component resource key.
	Right	The Right property determines a right margin if a component is placed inside LayoutPanel.
	Rotate	The Rotate property determines a component rotation angle.
	ShowToolTip	The ShowToolTip property determines whether a tooltip of the component can be displayed.
	Style	The Style property determines a component style.
	TabIndex	The TabIndex property determines the order of the control element passing inside the container.
	Tag	The Tag property determines a JSON object associated with the component.
	ToolTip	The ToolTip property determines text of component tooltip.
	Top	The Top property determines a top margin if a component is placed inside GridPanel.
	Value	The Value property determines a component value.
	Width	The Width property determines component width.

Methods inherited from the Control class

	Method name	Brief description
	addClass	The addClass method adds a CSS class to the component.
	addEventHandler	The addEventHandler method adds an event handler to a DOM node.
	addStateClass	The addStateClass method adds a CSS class to the component and removes the previous CSS class.
	addToNode	The addToNode method adds a component to the specified node.
	bindEvents	The bindEvents method subscribes an element to all available events.
	getAnchorFlags	The getAnchorFlags method returns JSON object that contains settings of the current component's position.
	getClass	The getClass method returns the current CSS classes of the component.
	getCssStyle	The getCssStyle method returns style for the specified node.
	getDomNode	The getDomNode method returns main DOM node of the component.
	getFocused	The getFocused method determines whether the component is focused.
	getIsBinded	The getIsBinded method returns whether an element is subscribed to all DOM node events.
	hide	The hide method hides a control.
	hideToolTip	The hideToolTip method clears tooltip timeout and hides the tooltip if it is shown.
	refreshStyle	The refreshStyle method refreshes element CSS styles.
	removeClass	The removeClass method removes CSS class from the component.
	removeEventHandler	The removeEventHandler method removes event handler from DOM node.
	removeFromDOM	The removeFromDOM method removes node from the DOM structure.
	removeStateClasses	The removeStateClasses method removes CSS classes of the component.
	setDraggable	The setDraggable method determines whether a component can be dragged on the HTML page.
	setFocus	The setFocus method sets the component focus.
	setIsHovered	The setIsHovered method sets up component displaying only on mouseover.
	setSize	The setSize method establishes the sizes of the component.
	show	The show method displays a control.
	unBindEvents	The unBindEvents method unsubscribes an element from all standard events.
	updatePosition	The updatePosition method updates size and position when absolute positioning based on the current parameters is used.
	updateSize	The updateSize method updates the component size on changing the size of the container that contains the component.

Events inherited from the Control class

Properties inherited from the class Object

Methods inherited from the class Object

	Method name	Brief description
	clone	The clone method creates an object copy.
	dispose	The dispose method deletes the component.
	getHashCode	The getHashCode method returns hash code of repository object.
	getId	The getId method returns repository object identifier.
	getSettings	The getSettings method returns repository object settings.
	getTypeName	The getTypeName method returns the name of the object type without the namespace, to which it belongs.
	isEqual	The isEqual method determines whether the specified object is equal to the current repository object.
	isLive	The isLive method determines validity of repository object.
	removeAllEvents	The removeAllEvents method removes all object event handlers by the specified context.
	setId	The setId method determines a repository object identifier.
	setSettings	The setSettings method determines repository object settings.
	defineProps	The defineProps method creates get and set methods from name array for the specified class.
	keys	The keys method returns array of methods and properties names for the specified object.

	Method name	Brief description
	getCalendar	The getCalendar method returns the calendar.
	getDateTimeEdit	The getDateTimeEdit method returns the component for time and date input.

	Event name	Brief description
	DateTimeChange	The DateTimeChange event occurs on changing the date.
	SelectDay	The SelectDay event occurs when picking the date in the calendar.
	TextChange	The TextChange event occurs on changing the value in the input box.

	Event name	Brief description
	TextChanged	The TextChanged event occurs on changing text in the editor.
	ValueChanged	The ValueChanged event occurs after changing input editor contents.

	Event name	Brief description
	Drag	The Drag event occurs on clicking and holding the mouse button.
	DragEnd	The DragEnd event occurs when dragging the component finishes.
	DragStart	The DragStart event occurs when dragging the component starts.
	OnContextMenu	The OnContextMenu event occurs on calling context menu of the component.
	SizeChanged	The SizeChanged event occurs after the component is resized.
	SizeChanging	The SizeChanging event occurs during component resize.

	Constructor name	Brief description
	DateTimePicker	The DateTimePicker constructor creates an instance of the DateTimePicker component.

	Property name	Brief description
	Id	The Id property determines a repository object identifier.