Key Features

The purpose of this help article is to show you the key features of the Date and Time Picker control for Xamarin.

DateTime Picker

The snippet below shows a simple Date and Time Picker definition:

<telerikInput:RadDateTimePicker MinimumDate="2019,12,25" 
                                MaximumDate="2020,02,14"
                                Placeholder="Pick date and time!"
                                AreSpinnerHeadersVisible="True"/>

In addition to this, you need to add the following namespace:

xmlns:telerikInput="clr-namespace:Telerik.XamarinForms.Input;assembly=Telerik.XamarinForms.Input"

Here is how the Date and Time Picker looks when Date and Time Format String is applied:

Date Picker

Date Range

RadDateTime Picker allows you to define a minimum date and maximum date and choose a date in between through the following properties:

  • MinimumDate(DateTime): Defines a date which marks the deginning of the range of the available dates. The default value is DateTime(2000,1,1, 0, 0, 0).

  • MaximumDate(DateTime): Defines a date which marks the end of the range of the available dates to choose from. The default value is DateTime(2099, 12, 31, 23, 59, 59).

Current Selected Date

  • Date(DateTime?): Defines the current date selection. The default value is null.

DefaultHighlightedDate

RadDateTime Picker DefaultHighlightedDate(DateTime) defines the System.DateTime which will be used to pre-scroll each spinner when RadDateTimePicker.Date property is set to null.

Example

<telerikInput:RadDateTimePicker SelectedDate="{x:Null}"
                                DefaultDisplayDate="2020,02,14"
                                SpinnerFormatString="d"/>

Incremental Time Steps

By default, the time component of the DateTime Picker increments or decrements 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.

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 datetime format.

Date Picker Mode

The snippet below shows a simple Date Picker definition:

<telerikInput:RadDateTimePicker MinimumDate="2019,12,25" 
                                MaximumDate="2020,02,14"
                                SpinnerFormat="d"/>

In addition to this, you need to add the following namespace:

xmlns:telerikInput="clr-namespace:Telerik.XamarinForms.Input;assembly=Telerik.XamarinForms.Input"

Here is how the Date Picker looks when Date Format String is applied:

Date Picker

Time Picker Mode

The snippet below shows a simple Time Picker definition:

<telerikInput:RadDateTimePicker MinimumDate="2020,01,01 9:00:00" 
                                MaximumDate="2021,02,01 18:00:00"
                                SpinnerFormat="T"
                                DisplayStringFormat="HH:mm:ss"
                                Placeholder="Pick a time!"
                                AreSpinnerHeadersVisible="True"/>

In addition to this, you need to add the following namespace:

xmlns:telerikInput="clr-namespace:Telerik.XamarinForms.Input;assembly=Telerik.XamarinForms.Input"

Here is how the Time Picker looks when Time Format String is applied:

Date Picker

A sample Key Features example can be found in the DateTimePicker/Features folder of the SDK Samples Browser application.

See Also

In this article
Not finding the help you need? Improve this article