New to Telerik UI for .NET MAUI? Start a free 30-day trial

.NET MAUI DatePicker Formatting

Telerik UI for .NET MAUI DatePicker provides formatting options both when the picker dialog is open and when a date value is picked.

DisplayString Format

The DisplayStringFormat property defines the format of the string that will be visualized when the picker dialog is closed.

The format set for DisplayStringFormat has to be a valid date format.

The following example demonstrates how to set the DisplayStringFormat definition.

1. Define the control and the DisplayStringFormat.

<telerik:RadDatePicker DefaultHighlightedDate="2020,05,15"
                       DisplayStringFormat="yyyy/MMM/dd"
                       Placeholder="Pick a date!"
                       SpinnerFormat="dd/MMM/yyyy"
                       AreSpinnerHeadersVisible="False"/>

2. Add the following namespace:

xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"

Spinner Format

The DatePicker allows you to use standard or custom date format strings through its SpinnerFormat property. Depending on what format is set, the picker visualizes spinner controls with prepopulated values that can be picked.

The SpinnerFormat property defines the string format for the spinners. The default format is "g".

SpinnerFormat="MMMM dd"

The following example demonstrates how to set the SpinnerFormat property to the "MMMM dd" format.

<telerik:RadDatePicker SpinnerFormat="MMMM dd" />

The following image shows the result:

DatePicker Spinner Format

SpinnerFormat="dd"

The following example demonstrates how to set the SpinnerFormat property to the "dd" format.

<telerik:RadDatePicker SpinnerFormat="dd" />

The following image shows the result:

DatePicker Spinner Format

SpinnerFormat="MMM yyyy"

The following example demonstrates how to set the SpinnerFormat property to the "MM yyyy" format.

<telerik:RadDatePicker SpinnerFormat="MMM yyyy" />

The following image shows the result:

DatePicker Spinner Format

SpinnerFormat="yyyy/dd/MMM"

The following example demonstrates how to set the SpinnerFormat property to the "yyyy/dd/MMM" format.

<telerik:RadDatePicker SpinnerFormat="yyyy/dd/MMM" />

The following image shows the result:

DatePicker Spinner Format

Standard Date Format Strings

The available Standard Date Format Strings, which can be set to the SpinnerFormat and DisplayStringFormat properties, are described in the following table.

Supported Standard Date Format String Description
"d" A Short Date Format. The invariant culture format is MM/dd/yyyy.
"G" A Short Date "d" and Long Time "T" specifier.
"g" A Short Date "d" and Short Time "t" specifier.
"M" A Month Format specifier.
"m" A Month Format specifier.
"Y" A Year Month Format specifier.
"y" A Year Month Format specifier.

Custom Date Format Strings

The available custom date format strings, which can be set to the SpinnerFormat and DisplayStringFormat properties, are described in the following table.

Currently, the DatePicker does not support any standard date formats, which contain a long date inside them. For more information, refer to the official Microsoft documentation on Standard Date Format Strings.

The DatePicker supports the following custom date format strings:

  • "d"
  • "dd"
  • "M"
  • "MM"
  • "MMM"
  • "MMMM"
  • "y"
  • "yyy"
  • "yyyy"

Supported Separators

When SpinnerFormat is set and the device culture is changed, the separators used for the format string won't be changed.

The DatePicker supports the following date format separators:

  • "-"
  • "."
  • ","
  • " "
  • ":"
  • "/"

See Also

In this article