This project has moved and is read-only. For the latest updates, please go here.


Derives from Control

Represents a control that allows users to select a time.



Property Description
AllowSpin Gets or sets a value indicating whether interacting with the spinner will result in increment/decrement operations.
ClipValueToMinMax Gets or sets if the value should be clipped when minimum/maximum is reached.
EndTime Gets or sets the last time listed in the control's dropdown.
Format Gets or sets the time format displayed.
FormatString Gets or sets the format string used when Format is set to Custom.
IsOpen Gets or sets a value indicating whether the dropdown is open.
Kind Gets or sets a value indicating whether a DateTime object represents a local time, a Coordinated Universal Time (UTC), or is not specified as either local time or UTC. NOTE: Setting this property fixes a bug where losing focus on the TimePicker was incrementing time in UTC. It also fixes a bug where specifying a UTC Date was changing the date's Kind property to UnSpecified or Local.
MaxDropDownHeight Gets or sets the maximum drop-down height of the popup of the TimePicker.
Maximum Gets or sets the Maximum allowed value.
Minimum Gets or sets the Minimum allowed value.
ShowButtonSpinner Gets or sets a value indicating whether the button spinner is shown.
StartTime Gets or sets the first time listed in the control's dropdown.
TextAlignment Gets or sets the alignment of the time picker's text.
TimeInterval Gets or sets the time interval between the TimeItem items listed in the dropdown.
UpdateValueOnEnterKey Gets or sets a value indicating whether the synchronization between "Value" and "Text" should be done only on the Enter key press (and lost focus).
Value Gets or sets the DateTime value of the TimePicker.
Watermark Gets or sets the watermark to display in the control.
WatermarkTemplate Gets or sets the watermark template.


Event Description
ValueChanged Raised when the Value changes.

Support this project, check out the Plus Edition.

Last edited Jun 1, 2016 at 3:53 PM by dlafontaine, version 15


BoucherS Jun 13, 2017 at 2:23 PM 
Hi, This is a normal behavior since you are trying to display a DateTime value, but you only want to see the Date part(TimeFormat set to ShortDate)....the Time part is hidden.

Alwyn_JB Jun 8, 2017 at 6:07 PM 
When TimePicker is used as a Short DatePicker the right-hand drop-button repeats the selected date 24 times instead of listing the next 24 (or 30?) dates.

ooplex Dec 21, 2016 at 4:20 PM 
Hi, issue has been created.

BoucherS Jun 10, 2016 at 7:49 PM 
Hi, issue has been created.

pinki Jun 1, 2016 at 10:00 AM 
Great control, thank you.
It would be great, if the TimeInterval property's value would also affect the spinner interval.

BoucherS Jul 3, 2015 at 1:19 PM 
Format are : DateTimeFormat, which is : { Custom, FullDateTime, LongDate, LongTime, MonthDay, RFC1123, ShortDate, ShortTime, SortableDateTime, UniversalSortableDateTime, YearMonth }.
If "Format = Custom" is used, "FormatString" can be anything. Just hours and minutes would be : "mm:ss".

skst Jul 2, 2015 at 4:31 PM 
What are the possible values of the Format property? If Custom is used, what are the options? Can this control select seconds or just hours and minutes?

tlhintoq Jun 10, 2012 at 5:09 PM 
Am I just stupid and/or blind? Is there no actual documentation for these controls? You know, like MSDN where there is a list of methods, properties, example use and so on?

henrydee8 May 30, 2012 at 4:23 PM 
Is there a way to hide that drop-down menu button? For our purposes it's just not something we want showing.

zhoufoxcn Mar 31, 2012 at 3:57 PM 
I have been seek for it for serveral days,at the end i developed a timerpicker user control base on another open source user control.

cuiwenke Dec 29, 2011 at 1:24 AM 
very good! Thanks

ladj82 Oct 25, 2011 at 6:43 PM 
Nice component. Could you provide some sample using it inside of a "DataGridTemplateColumn.CellTemplate"... Seems that the value it's not being considered while updating the row... With a regular Textbox works fine.

skst Apr 8, 2011 at 3:13 PM 
Awesome! Thank you. This release is great and perfectly-timed, including almost every (if not every) control I need.

BTW, it should be "sneak peek." :-)