Skip to main content


sets the value for a TimePicker control

setValue(value: Date | number | string | any[] | object): void;


  • value: Date | number | string | array | object - the value to be set for the control


// set the value as a string

// set the value as a Date object
form.getItem("timepicker").setValue(new Date('January 10, 2019 17:54:00'));

// set the value as an array

// set the value as a number

// set the value as an object
form.getItem("timepicker").setValue({hour: 10, minute: 50, AM: true});

1. The value of a timepicker control set as an array should have the following elements:

  • the hour value
  • the minutes value
  • the "AM/PM" identifier for 12-hour format as a string

2. The value set as an object:

  • for the 24-hour format contains key:value pairs for hours, minutes and their values:
    {hour: 0, minute: 39}
  • for the 12-hour format contains key:value pairs for for hours, minutes, am/pm identifiers and their values:
    {hour: 6, minute: 0, AM: true}

3. The date set as a number is the number of milliseconds since January 1, 1970, 00:00:00 UTC returned by the getTime() method of the Date object.

Change log:

The ability to set the value as a number, as an array, or as an object is added in v7.0.