# Mask Type: Time Only | WPF Controls | DevExpress Documentation The **TimeOnly** masks work similar to [Date-Time masks](/WPF/6947/controls-and-libraries/data-editors/common-features/masked-input/mask-type-date-time) and change the editor’s [EditValue](/WPF/DevExpress.Xpf.Editors.BaseEdit.EditValue) property type to [TimeOnly](https://learn.microsoft.com/dotnet/api/system.timeonly). ![TimeOnly Mask Example](/WPF/images/TimeOnly_Mask_Example.png) ## TimeOnly Mask Modes The DevExpress WPF Data Editors support the following input modes for **TimeOnly** masks: - `TimeOnly` - supports only manual navigation between editable mask parts. - `TimeOnlyAdvancingCaret` - enables automatic navigation between mask parts. If a user completes a part of the value, the caret moves to the next editable part. ### Enable TimeOnly Masks To enable a particular **TimeOnly** mask mode, set the [TextEdit.MaskType](/WPF/DevExpress.Xpf.Editors.TextEdit.MaskType) property (or the [TextEditSettings.MaskType](/WPF/DevExpress.Xpf.Editors.Settings.TextEditSettings.MaskType) for in-place editors) to [TimeOnly](/WPF/DevExpress.Xpf.Editors.MaskType) or [TimeOnlyAdvancingCaret](/WPF/DevExpress.Xpf.Editors.MaskType). Use the [TextEdit.Mask](/WPF/DevExpress.Xpf.Editors.TextEdit.Mask) property (or [TextEditSettings.Mask](/WPF/DevExpress.Xpf.Editors.Settings.TextEditSettings.Mask) for in-place editors) to specify the mask itself. ### Mask as a Display Format **TimeOnly** masks are similar to the display formats described in the [Date and Time Format Strings](https://docs.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings) document. You can use the editor’s mask as a display format specifier. If an editor loses input focus, the display text still uses the specified custom format. To enable this functionality, use the [TextEdit.MaskUseAsDisplayFormat](/WPF/DevExpress.Xpf.Editors.TextEdit.MaskUseAsDisplayFormat) property ([TextEditSettings.MaskUseAsDisplayFormat](/WPF/DevExpress.Xpf.Editors.Settings.TextEditSettings.MaskUseAsDisplayFormat) for in-place editors). ## Predefined Masks Predefined masks allow users to edit [TimeOnly](https://learn.microsoft.com/dotnet/api/system.timeonly) values according to common patterns. The table below lists the available masks. | Standard Mask | Name | Description | Samples Culture: English (U.S.) | | --- | --- | --- | --- | | `t` | Short time | The mask matches the pattern specified by the [ShortTimePattern](https://learn.microsoft.com/dotnet/api/system.globalization.datetimeformatinfo.shorttimepattern#system-globalization-datetimeformatinfo-shorttimepattern) property. | ![CD_Mask_DateTime_t-short](/WPF/images/cd_mask_datetime_t-short4160.png) | | `T` | Long time | The mask matches the pattern specified by the [LongTimePattern](https://learn.microsoft.com/dotnet/api/system.globalization.datetimeformatinfo.longtimepattern#system-globalization-datetimeformatinfo-longtimepattern) property. | ![CD_Mask_DateTime_T-long](/WPF/images/cd_mask_datetime_t-long4161.png) | ## Custom Masks Use the following mask specifiers to create custom **TimeOnly** masks: | Mask Specifier | Description | Sample | | --- | --- | --- | | `f` or `F` | Fractions of a second displayed as one digit. | 1 - 9 | | `ff` or `FF` | Fractions of a second displayed as two digits. | 01 - 99 | | `fff` or `FFF` | Fractions of a second displayed as three digits. | 001 - 999 | | `ffff` or `FFFF` | Fractions of a second displayed as four read-only digits. | 0001 - 9999 | | `fffff` or `FFFFF` | Fractions of a second displayed as five read-only digits. | 00001 - 99999 | | `ffffff` or `FFFFFF` | Fractions of a second displayed as six read-only digits. | 000001 - 999999 | | `fffffff` or `FFFFFFF` | Fractions of a second displayed as seven read-only digits. | 0000001 - 9999999 | | `h` | Hours in the 12-hours format. | 1 - 12 | | `hh` | Hours in the 12-hours format, starts with zero for single-digit values. | 01 - 12 | | `H` | Hours in the 24-hours format. | 0 - 23 | | `HH` | Hours in the 24-hours format, starts with zero for single-digit values. | 00 - 23 | | `m` | Minutes. | 0 - 59 | | `mm` | Minutes, starts with zero for single-digit values. | 00 - 59 | | `s` | Seconds. | 0 - 59 | | `ss` | Seconds, starts with zero for single-digit values. | 00 - 59 | | `t` | The first character of a time designator. | A, P | | `tt` | A time designator. | AM, PM | | `:` | A time separator.


The [TimeSeparator](https://learn.microsoft.com/dotnet/api/system.globalization.datetimeformatinfo.timeseparator#system-globalization-datetimeformatinfo-timeseparator) property returns the time separator for the current culture. | `:` in the en-US culture | | `\` | The escape character that allows you to insert a following character as a text. | `\H\H` is interpreted as a `HH` text | | `'` or `"` | A read-only custom string. | ‘Current time:’ | If you use a mask specifier as a single character, it is interpreted as a predefined mask. To use a custom specifier which matches one of the standard specifiers, precede this specifier with the `%` character (`%t`). ## User Capabilities - The `Up Arrow` and `Down Arrow` keys increase and decrease the focused part of the time value. - The mouse wheel increases and decreases the focused part of the time value. - The `Space` key moves the caret to the next part of the time value. - The time separator character moves the caret to the next part of the time value. - The `Left Arrow` and `Right Arrow` keys move the caret to the previous or next part of the time value. ## Example The following code sample binds the [TextEdit](/WPF/DevExpress.Xpf.Editors.TextEdit) to a [TimeOnly](https://learn.microsoft.com/dotnet/api/system.timeonly) field and specifies an input mask: ![TimeOnly Mask Example](/WPF/images/TimeOnly_Mask_Example.png) - XAML 
<dxe:TextEdit EditValue="{Binding TimeOnlyValue}" 
              MaskType="TimeOnly" Mask="HH:mm:ss:fff" 
              MaskUseAsDisplayFormat="True"/>
- C# - VB.NET 
public class ViewModel : ViewModelBase {
    public TimeOnly TimeOnlyValue { get; set; } = new TimeOnly(22, 45, 13, 185);
}