All Components

TimePickerComponent

Represents the Kendo UI TimePicker component for Angular.

Selector

kendo-timepicker

Export Name

Accessible in templates as #kendoTimePickerInstance="kendo-timepicker"

Inputs

cancelButton boolean

Determines whether to display the Cancel button in the popup.

disabled boolean

Sets or gets the disabled property of the TimePicker and determines whether the component is active.

format string

Specifies the time format used to display the input value.

formatPlaceholder DateInputFormatPlaceholder

Defines the descriptions of the format sections in the input field.

  • 'wide'—Displays the full description of the format section. For example, turns MM into month. Retrieved from CLDR.
  • 'narrow'—Displays the narrow description of the format section. For example, turns MM into mo.. Retrieved from CLDR.
  • 'short'—Displays the short description of the format section. For example, turns MM into mo.. Retrieved from CLDR.
  • 'formatPattern'—Directly displays the format section. For example, turns MM into MM.
  • [CustomFormatPlaceholder](/kendo-angular-ui/components/dateinputs/api/DateInputCustomFormatPlaceholder/)— An object that defines the description of the format sections. For example, { day: 'd.', month: 'M.', year: 'y', hour: 'h.' }.
@Component({
selector: 'my-app',
template: `
<div class="row example-wrapper" style="min-height: 450px;">
 <div class="col-xs-12 col-md-6 example-col">
   <p>Full-length format description:</p>
   <kendo-timepicker formatPlaceholder="wide"></kendo-timepicker>
 </div>

 <div class="col-xs-12 col-md-6 example-col">
   <p>Narrow-length format description:</p>
   <kendo-timepicker formatPlaceholder="narrow"></kendo-timepicker>
 </div>

 <div class="col-xs-12 col-md-6 example-col">
   <p>Short-length format description:</p>
   <kendo-timepicker formatPlaceholder="short"></kendo-timepicker>
 </div>

 <div class="col-xs-12 col-md-6 example-col">
   <p>Display defined format:</p>
   <kendo-timepicker format="HH:mm:ss" formatPlaceholder="formatPattern"></kendo-timepicker>
 </div>

 <div class="col-xs-12 col-md-6 example-col">
   <p>Custom defined format descriptions</p>
   <kendo-timepicker format="HH:mm:ss"
     [formatPlaceholder]="{ hour: 'H', minute: 'm', second: 's' }"
   ></kendo-timepicker>
 </div>
</div>
`
})
class AppComponent { }

nowButton boolean

Determines whether to display the Now button in the popup.

If the current time is out of range or the incremental step is greater than 1, the Now button will be hidden.

placeholder string

Specifies the hint the TimePicker displays when its value is null.

@Component({
selector: 'my-app',
template: `
 <kendo-timepicker placeholder="Enter start..."></kendo-timepicker>
`
})
class AppComponent { }

rangeValidation boolean

Determines whether the built-in min or max validators are enforced when a form is being validated.

tabIndex number

Sets or gets the tabIndex property of the TimePicker.

title string

Sets the title of the input element of the TimePicker.

value Date

Specifies the value of the TimePicker component.

max Date

Specifies the biggest valid time value.

min Date

Specifies the smallest valid time value.

popupSettings PopupSettings

Configures the popup of the TimePicker.

The available options are:

  • animate: Boolean—Controls the popup animation. By default, the open and close animations are enabled.
  • popupClass: String—Specifies a list of CSS classes that are used to style the popup.

steps TimePickerIncrementalSteps

Configures the incremental steps of the TimePicker.

The available options are:

  • hour: Number—Controls the incremental step of the hour value.
  • minute: Number—Controls the incremental step of the minute value.
  • second: Number—Controls the incremental step of the second value.
@Component({
selector: 'my-app',
template: `
 <kendo-timepicker format="HH:mm:ss" [steps]="steps"></kendo-timepicker>
`
})
class AppComponent {
  public steps = { hour: 2, minute: 15, second: 15 };
}

If the incremental step is greater than 1, the Now button will be hidden.

Fields

isOpen boolean

Returns the current open state of the popup.

Events

close EventEmitter<PreventableEvent>

Fires each time the popup is about to close.
This event is preventable. If you cancel the event, the popup will remain open.

blur EventEmitter

Fires each time the input element gets blurred.

@Component({
selector: 'my-app',
template: `
 <kendo-timepicker (blur)="handleBlur()"></kendo-timepicker>
`
})
class AppComponent {
  public handleBlur(): void {
     console.log("Component is blurred");
  }
}

To wire the event programmatically, use the onBlur property.

focus EventEmitter

Fires each time the user focuses the input element.

@Component({
selector: 'my-app',
template: `
 <kendo-timepicker (focus)="handleFocus()"></kendo-timepicker>
`
})
class AppComponent {
  public handleFocus(): void {
     console.log("Component is focused");
  }
}

To wire the event programmatically, use the onFocus property.

open EventEmitter<PreventableEvent>

Fires each time the popup is about to open.
This event is preventable. If you cancel the event, the popup will remain closed.

valueChange EventEmitter

Fires each time the user selects a new value.

Methods

blur

Blurs the TimePicker component.

focus

Focuses the TimePicker component.

@Component({
selector: 'my-app',
template: `
 <button (click)="timepicker.focus()">Focus time picker</button>
 <kendo-timepicker #timepicker></kendo-timepicker>
`
})
class AppComponent { }

toggle

Toggles the visibility of the popup. If you use the toggle method to show or hide the popup,
the open and close events do not fire.

Parameters

show? boolean

The state of the popup.

In this article