Key Features
The purpose of this help article is to show you the key features of the Time Picker control for Xamarin.
Time Range
Time Picker allows you to define a time range and choose a time in between through the following properties:
MinimumTime(TimeSpan): Defines a time which marks the beginning of the range of the available time values. The default value is
TimeSpan.Zero
.MaximumTime(TimeSpan): Defines a time which marks the end of the range of the available time values to choose from. The default value is
TimeSpan(23, 59, 59)
.
Example
<telerikInput:RadTimePicker MinimumTime="8:00:00"
MaximumTime="19:00:00"/>
Current Selected Time
- Time(TimeSpan?): Defines the current time selection. The default value is null.
Example
<telerikInput:RadTimePicker Time="10:30:00"/>
Incremental Time Steps
By default the TimePicker increments each part of its time values by one step. You can change the default setup using the following properties:
- HourStep(int): Controls the incremental step of the hour value. Default value is 1.
- MinuteStep(int): Controls the incremental step of the minute value. Default value is 1.
- SecondStep(int): Controls the incremental step of the second value. Default value is 1.
<telerikInput:RadTimePicker HourStep="2"
MinuteStep="10"
SecondStep="30"/>
DefaultHighlightedTime
RadTime Picker DefaultHighlightedTime(TimeSpan) defines the System.TimeSpan which will be used to pre-scroll each spinner when RadTimePicker.Time property is set to null.
Example
<telerikInput:RadTimePicker DefaultHighlightedTime="11:30:00"
SpinnerFormat="t"
AreSpinnerHeadersVisible="False"/>
DisplayString Format
- DisplayStringFormat(string): Defines the format of the string that will be visualized when the picker dialog is closed.
The format set for DisplayStringFormat should be a valid time format.
Example
Here is a sample Time Picker definition:
<telerikInput:RadTimePicker DefaultHighlightedTime="11:30:00"
SpinnerFormat="t"
AreSpinnerHeadersVisible="False"/>
A sample Key Features example can be found in the TimePicker/Features folder of the SDK Samples Browser application.