TimePicker

TimePickers enable users to select time values from a predefined set or type them into an input field for precise scheduling.

TimePicker Overview

The TimePicker component is a useful tool that enables users to select time values either from a time selector popup or by entering new values directly. It is a crucial interface tool for applications that require precise time settings, such as appointment booking, event planning, or task scheduling. With the TimePicker, users can choose hours and minutes available in AM/PM or 24-hour formats. It offers incremental adjustments for detailed control, ensuring accurate and efficient time selection.

Live Demo

States
Modifiers
Size
Fill Mode
Roundness

Appearance

The TimePicker component provides built-in styling options that grant visually appealing and flexible rendering experience.

Apart from the default vision of the Telerik and Kendo UI TimePicker, the component supports alternative styling options that enable you to configure the individual aspects of its appearance.

States

Depending on the action you want to imply through its appearance, the Telerik and Kendo UI TimePicker can acquire various states which you can set by using the following classes:

  • A TimePicker in its normal state is fully active, but the user is not interacting with it. This is the default state of the component. It can contain an explanatory placeholder text or an already prefilled text.
  • k-hover—The hover state of a TimePicker is applied when the user hovers over the component but does not click it. The mouse pointer changes to indicate that you can type into the component.
  • k-focus—The focus state of the TimePicker is triggered when the user navigates to the component by keyboard, voice, or mouse click. This state highlights the DatePicker so that it covers all accessibility requirements.
  • k-invalid—The invalid state of the TimePicker indicates that the input validation requirements are not met. The user is notified that the entered data is incorrect and must be revised so that the input operation can complete.
  • k-invalid k-focus—The invalid focus state is a result of spotlighting a TimePicker whose value or input type does not pass the validation requirements.
  • k-disabled—The disabled state of the TimePicker indicates that the user cannot interact with the component. When disabled, the component has no interactive behavior, it is faded out and slightly out of focus, which helps the user to distinguish it from the active elements on the page.

Anatomy

The anatomy of the TimePicker summarizes the elements of the component.

The next image shows the anatomy of a TimePicker and includes the following elements:

A Telerik and Kendo UI TimePicker component.
  1. Input field
  2. Icon button
  3. Label (optional when used in the Form component)
  4. Hint text (optional when used in the Form component)
  5. Placeholder or preselected value
  6. Clear icon
  7. Popup with time selector and footer
  8. Header with time and flat button
  9. Column title
  10. Column with list items
  11. Highlight
  12. Action buttons

Size

The TimePicker provides the size configuration option that enables you to control how big or small the rendered TimePickers will be. Options for size customization are also at your disposal.

size provides the following available options:

  • small—Renders small TimePickers, which are suitable for compact components, such as Toolbars, where the available space is limited.
  • medium (default)—Renders medium TimePickers.
  • large—Renders large TimePickers, which are suitable for adaptive designs.
  • none—Does not set a size and allows you to add your own, custom value.
Three Telerik and Kendo UI TimePicker components demonstrating the small, default medium, and large sizes respectively.
  1. Small
  2. Medium (default)
  3. Large

Fill Mode

The TimePicker provides the fillMode configuration option that enables you to visually achieve a certain atmosphere in your app. TimePicker also provides options for fill-mode customization. By default, the TimePicker is rendered in solid colors.

fillMode provides the following available options:

  • solid (default)—The solid fill mode focuses on the layout and emphasizes the text field. It can be wrapped in a container with a different background color making the TimePicker stand out.
  • outline—The outline fill mode focuses less on the text field. The outlined TimePicker does not have a background fill and can blend with the surrounding UI environment.
  • flat—The flat fill mode emphasizes less the text field and more the data input. Also, the flat fill mode reduces additional visual noise and focuses on the content.
  • none—Does not set a fillMode and allows you to add your own, custom value.  
Three Telerik and Kendo UI TimePicker components demonstrating the default solid, outline, and flat fill modes respectively.
  1. Solid (default)
  2. Outline
  3. Flat

Border Radius

The TimePicker provides the rounded option that enables you to control the border radius of the rendered input field. The defined value for the border-radius significantly affects the look-and-feel of the UI. The TimePicker also provides options for border-radius customization.

rounded provides the following available options:

  • small—Renders a border radius of 2 px.
  • medium (default)—Renders a border radius of 4 px.
  • large—Renders a border radius of 6 px.
  • full—Renders a border radius of 9999 px.
  • none—Does not set a rounded value and allows you to add your own, custom value.
Four Telerik and Kendo UI TimePicker components demonstrating the small, default medium, large, and full fill modes respectively.
  1. Small
  2. Medium (default)
  3. Large
  4. Full

Framework-Specific Documentation

For specific information about the component, refer to its official product documentation:

Feedback