Компонент DateTimePicker представляет собой редактор для ввода даты и времени с календарем для выбора даты.
Компонент реализован классом DateTimePicker.
Компонент DateTimePicker совмещает компоненты DateTimeEdit и MonthCalendar.
Компонент работает с локальным временем, поправки на часовой пояс нужно производить самостоятельно.
Компонент имеет следующий вид:
![]()
При нажатии на кнопку вызова календаря раскрывается календарь, реализованный компонентом MonthCalendar:

Выбранное из календаря значение даты устанавливается в поле ввода, реализованном компонентом DateTimeEdit.
Также дата может быть введена с клавиатуры или изменена с помощью клавиш «Вверх/Вниз». При изменении даты в редакторе будет изменена отметка в календаре.
| Имя конструктора | Краткое описание | |
| DateTimePicker | Конструктор DateTimePicker создает экземпляр компонента DateTimePicker. |
| Имя свойства | Краткое описание | |
| CurrentDate | Свойство CurrentDate устанавливает дату и время для компонента. | |
| DropHeight | Свойство DropHeight устанавливает высоту области, на которой расположена раскрывающаяся панель. | |
| DropWidth | Свойство DropWidth устанавливает ширину области, на которой расположена раскрывающаяся панель. | |
| MaxDate | Свойство MaxDate устанавливает максимальное возможное значение даты и времени. | |
| MinDate | Свойство MinDate устанавливает минимальное допустимое значение даты для компонента. | |
| Mode | Свойство Mode возвращает режим отображения календаря и поля ввода компонента. | |
| MonthNames | Свойство MonthNames задаёт массив с наименованиями месяцев, которые отображаются в поле ввода редактора в режиме месяцев. | |
| NextMonthName | Свойство NextMonthName устанавливает текст всплывающей подсказки для кнопки «Следующий месяц». | |
| NextYearName | Свойство NextYearName устанавливает текст всплывающей подсказки для кнопки «Следующий год». | |
| PreviousMonthName | Свойство PreviousMonthName устанавливает текст всплывающей подсказки для кнопки «Предыдущий месяц». | |
| PreviousYearName | Свойство PreviousYearName устанавливает текст всплывающей подсказки для кнопки «Предыдущий год». | |
| ShowTime | Свойство ShowTime определяет, отображается ли время в компоненте. | |
| TextAfterHalfYear | Свойство TextAfterHalfYear устанавливает текст, который будет отображён в поле ввода после значения полугодия. | |
| TextAfterMonth | Свойство TextAfterMonth устанавливает текст, который будет отображён в поле ввода после значения месяца. | |
| TextAfterQuarter | Свойство TextAfterQuarter устанавливает текст, который будет отображён в поле ввода после значения квартала. | |
| TextAfterWeek | Свойство TextAfterWeek устанавливает текст, который будет отображён в поле ввода после значения недели. | |
| TextAfterYear | Свойство TextAfterYear устанавливает текст, который будет отображён в поле ввода после значения года. |
| Имя метода | Краткое описание | |
| getCalendar | Метод getCalendar возвращает календарь. | |
| getDateTimeEdit | Метод getDateTimeEdit возвращает компонент для ввода даты и времени. |
| Имя события | Краткое описание | |
| DateTimeChange | Событие DateTimeChange наступает при изменении даты. | |
| SelectDay | Событие SelectDay наступает при выборе дня в календаре. | |
| TextChange | Событие TextChange наступает при изменении значения в поле ввода. |
| Имя свойства | Краткое описание | |
| CloseOnContentClick | Свойство CloseOnContentClick определяет возможность закрытия панели компонента по нажатию на заголовок. | |
| EnableEdit | Свойство EnableEdit устанавливает возможность ввода. | |
| IsDropHasCombosWidth | Свойство IsDropHasCombosWidth устанавливает признак независимости ширины раскрывающейся панели от ширины редактора ввода. | |
| IsHint | Свойство IsHint определяет отображение подсказки при наведении курсора мыши на кнопку открытия раскрывающейся панели. | |
| NoCreateEditors | Свойство NoCreateEditors определяет признак того, что заголовок отобразится простым текстом, а не в редакторах компонентов TextBox или MaskEdit. | |
| OpenOnContentClick | Свойство OpenOnContentClick определяет возможность раскрытия панели компонента по нажатию на заголовок. | |
| OpenOnIconClick | Свойство OpenOnIconClick определяет возможность раскрытия панели компонента по нажатию на пиктограмму заголовка. | |
| OpenOnKeyDown | Свойство OpenOnKeyDown определяет возможность открытия всплывающей панели по нажатию кнопки клавиатуры. | |
| UseMask | Свойство UseMask устанавливает возможность использования редактора маски. |
| Имя метода | Краткое описание | |
| applyNotValidCSS | Метод applyNotValidCSS устанавливает стиль, определяющий подсветку некорректно введенного значения редактора ввода. | |
| applyValidCSS | Метод applyValidCSS устанавливает стиль, определяющий подсветку корректно введенного значения редактора ввода. | |
| getContentNode | Метод getContentNode возвращает DOM-узел компонента редактора ввода. | |
| getDropPanel | Метод getDropPanel возвращает раскрывающуюся часть компонента. | |
| getIconHeight | Метод getIconHeight возвращает значение высоты пиктограммы редактора ввода. | |
| getIconWidth | Метод getIconeWidth возвращает значение ширины пиктограммы редактора ввода. | |
| getMaskEdit | Метод getMaskEdit возвращает редактор ввода данных, соответствующих определенному шаблону. | |
| getTextBox | Метод getTextBox возвращает текстовое поле редактора ввода. | |
| setIconImageClass | Метод setIconImageClass меняет имя класса компонента пиктограммы редактора ввода. | |
| showDropPanel | Метод showDropPanel отображает раскрывающуюся часть компонента. |
| Имя события | Краткое описание | |
| TextChanged | Событие TextChanged наступает при изменении текста в редакторе. | |
| ValueChanged | Событие ValueChanged наступает после изменения содержимого редактора ввода. |
| Имя свойства | Краткое описание | |
| Свойство Anchors определяет позицию компонента, размещенного внутри контейнера. | ||
| Свойство Animation устанавливает параметры анимации для компонента. | ||
| Bottom | Свойство Bottom устанавливает отступ снизу при размещении компонента внутри LayoutPanel. | |
| Свойство Content устанавливает содержимое компонента. | ||
| Свойство ContextMenu устанавливает контекстное меню для компонента. | ||
| Свойство Data предназначено для хранения любых пользовательских данных. | ||
| DataContext | Свойство DataContext содержит объект с данными. | |
| Свойство Enabled устанавливает, является ли компонент доступным для использования. | ||
| Свойство Height устанавливает высоту компонента. | ||
| Свойство IsResizable определяет, можно ли изменять размеры компонента. | ||
| Свойство IsRTL устанавливает направление текста справа налево. | ||
| Свойство IsVisible определяет, отображается ли компонент. | ||
| Свойство Left устанавливает отступ слева при размещении компонента внутри GridPanel. | ||
| Свойство Offset определяет координаты корневой DOM-вершины элемента управления. | ||
| Свойство Opacity определяет прозрачность компонента. | ||
| Свойство Parent определяет родительский компонент элемента управления. | ||
| Свойство ParentNode устанавливает родительскую DOM-вершину. | ||
| Свойство ResourceKey устанавливает ресурсный ключ для компонента. | ||
| Right | Свойство Right устанавливает отступ справа при размещении компонента внутри LayoutPanel. | |
| Свойство Rotate устанавливает угол поворота компонента. | ||
| Свойство ShowToolTip определяет, включена ли возможность отображать всплывающую подсказку компонента. | ||
| Свойство Style устанавливает стиль для компонента. | ||
| Свойство TabIndex задает последовательность перехода элемента управления внутри контейнера. | ||
| Свойство Tag устанавливает JSON-объект, ассоциированный с компонентом. | ||
| Свойство ToolTip определяет текст всплывающей подсказки компонента. | ||
| Свойство Top устанавливает отступ сверху при размещении компонента внутри GridPanel. | ||
| Свойство Value задает значение компоненту. | ||
| Свойство Width устанавливает ширину компонента. |
| Имя метода | Краткое описание | |
| Метод addClass добавляет CSS-класс к компоненту. | ||
| addEvent | Метод addEvent добавляет обработчик события на DOM-вершину. | |
| addEventHandler | Метод addEventHandler добавляет обработчик события на DOM-вершину. | |
| addEvents | Метод addEvents добавляет массив обработчиков событий на DOM-вершину. | |
| Метод addStateClass добавляет CSS-класс к компоненту и удаляет прежний CSS-класс. | ||
| addStyleBySelector | Метод addStyleBySelector создает блок со стилем с указанным css-селектором. | |
| Метод addToNode добавляет компонент в указанную вершину. | ||
| bindEvents | Метод bindEvents подписывает элемент на все стандартные события. | |
| Метод clearStylesCache очищает кэш стилей компонента. | ||
| Метод getAnchorFlags возвращает JSON-объект с настройками текущей позиции компонента. | ||
| Метод getClass возвращает текущие css-классы компонента. | ||
| Метод getCssStyle возвращает стили для указанной вершины. | ||
| Метод getDomNode возвращает главную DOM-вершину компонента. | ||
| Метод getFocused определяет наличие фокуса у компонента. | ||
| getFunctionByName | Метод getFunctionByName возвращает функцию по имени. | |
| getIsBinded | Метод getIsBinded возвращает признак подписи элемента на события DOM-вершины. | |
| Метод hasClass определяет, задан ли для корневой DOM-вершины элемента управления указанный CSS-класс. | ||
| Метод hide скрывает элемент управления. | ||
| Метод hideToolTip очищает таймаут появления подсказки и скрывает ее, если она был показана. | ||
| Метод isResingNow определяет, изменяются ли в данный момент размеры компонента. | ||
| refreshBindingProperty | Метод refreshBindingProperty обновляет привязанное свойство по имени. | |
| refreshItemsStyle | Метод refreshItemsStyle обновляет CSS-стили дочерних элементов. | |
| refreshStyle | Метод refreshStyle обновляет CSS-стили элемента. | |
| Метод removeClass удаляет CSS-класс из компонента. | ||
| Метод removeEvent удаляет обработчик события у DOM-вершины. | ||
| removeEventHandler | Метод removeEventHandler удаляет обработчик события DOM-вершины. | |
| removeFromDOM | Метод removeFromDOM удаляет вершину из DOM-структуры. | |
| Метод removeStateClasses удаляет CSS-классы компонента. | ||
| Метод setDraggable устанавливает возможность перетаскивания компонента на html-странице. | ||
| Метод setFocus устанавливает фокус компонента. | ||
| Метод setIsHovered отображает компонент как при наведении на него курсора. | ||
| Метод setIsPressed отображает компонент как при клике по нему. | ||
| Метод setOpacityIE8 устанавливает значение прозрачности компонента в браузере InternetExplorer 8. | ||
| Метод setSize устанавливает размеры компонента. | ||
| Метод show отображает элемент управления. | ||
| unBindEvents | Метод unBindEvents отписывает элемент от всех стандартных событий. | |
| Метод updatePosition корректирует размер и положение при абсолютном позиционировании на основе текущих параметров. | ||
| Метод updateSize обновляет размеры компонента подгонке размеров контейнера, в котором находится компонент. |
| Имя события | Краткое описание | |
| Событие Drag наступает при нажатии и удерживании клавиши мыши. | ||
| Событие DragEnd наступает при окончании перетаскивания компонента. | ||
| Событие DragStart наступает, когда начинается перетаскивание компонента. | ||
| Событие OnContextMenu наступает при вызове контекстного меню компонента. | ||
| Событие SizeChanged наступает после изменения размеров компонента. | ||
| Событие SizeChanging наступает во время изменения размеров компонента. |
| Имя свойства | Краткое описание | |
| Свойство Data ассоциирует произвольный объект с данным компонентом. | ||
| Свойство Id устанавливает идентификатор компонента. | ||
| Свойство Settings задает параметры компонента. |
| Имя метода | Краткое описание | |
| Метод clone создает копию объекта. Не реализован в PP.Ui.Control. | ||
| Метод dispose уничтожает компонент. | ||
| Метод getTypeName возвращает имя типа объекта без пространства имен, к которому он принадлежит. |
См. также: