[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]ASP.NET WebForms Controls
 [Collapse]ASP.NET MVC Extensions
  [Expand]Product Information
  [Expand]Getting Started
  [Expand]Common Concepts
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
   Reporting
  [Expand]Charting
  [Expand]Pivot Grid
   Spreadsheet
   Rich Text Editor
  [Expand]Scheduler
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Vertical Grid
  [Collapse]Data Editors
    Editor List
    Main Features
   [Expand]Common Concepts
    BinaryImage
   [Expand]Button
    ButtonEdit
    Calendar
   [Expand]Captcha
    CheckBox
    CheckBoxList
   [Expand]ColorEdit
   [Expand]ComboBox
   [Expand]DateEdit
    DropDownEdit
    Filter Control
    GridLookup
    HyperLink
    Image
    Label
    ListBox
    Memo
   [Expand]ProgressBar
    RadioButton
    RadioButtonList
    SpinEdit
    TextBox
    TimeEdit
    TokenBox
   [Expand]TrackBar
    Validation Summary
   [Expand]Strongly-Typed Editor Types
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Extensions
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

TimeEdit

TimeEdit is an editor capable of displaying and editing time values. It consists of an edit region and a pair of spin buttons, which can be used to adjust the date-time value.

Expanded Implementation Details

TimeEdit is realized by the TimeEditExtension class. Its instance can be accessed via the ExtensionsFactory.TimeEdit helper method, which is used to add a TimeEdit extension to a view. This method's parameter provides access to the TimeEdit's settings implemented by the TimeEditSettings class, allowing you to fully customize the extension.

The TimeEdit's client counterpart is represented by the ASPxClientTimeEdit object.

Expanded Declaration

TimeEdit can be added to a view in the following manner.

View code (ASPX):

View code (Razor):

Note

The Partial View should contain only the extension's code.

The code result is demonstrated in the image below.

Expanded Main Features

  • Edit Formatting

    You can specify how an editor value is represented within the edit boxes. For display and edit purposes, the edited value can be displayed in the following formats.

    View

    Affected Properties

    EditFormat="Time"

    EditFormat= "Date"

    EditFormat="DateTime"

    EditFormat="Custom"

    EditFormatString:="MMMM dd, yyyy hh:mm tt"

  • Display Formatting

    The editor display value can be formatted for display purposes when the editor is not focused. You can define the format pattern via the DisplayFormatString property.

  • Mouse and Key Support

    The TimeEdit allows for the editing of date and time values by typing directly within it (if the TimeEditSettings.Properties.AllowUserInput (ButtonEditPropertiesBase.AllowUserInput) property value is set to true), or by clicking spin buttons to increment or decrement different portions of date and time values, or by using the mouse wheel or keyboard. To enable the changing of a value via the mouse wheel, set the TimeEditSettings.Properties.AllowMouseWheel (ButtonEditPropertiesBase.AllowMouseWheel) property value to true.

  • Customizable Button Collection

    The TimeEdit extension provides a collection to maintain its custom edit buttons. Each button exposes a set of properties allowing the button's appearance and behavior to be defined. You can use the Buttons property to populate the button collection.

  • Built-in Validation

    The TimeEdit extension allows you to perform data validation both on the client and server side. See the Built-in Validation topic to learn more.

  • Full-Featured Client-Side API

    TimeEdit provides you with a comprehensive client-side API. This API is implemented using JavaScript and is exposed via the ASPxClientTimeEdit object. The ASPxClientTimeEdit object serves as a client-side equivalent of the TimeEdit extension.

Is this topic helpful?​​​​​​​