---
id: timepickerandroid
title: TimePickerAndroid
layout: docs
category: APIs
permalink: docs/timepickerandroid.html
next: toastandroid
previous: systrace
---

Opens the standard Android time picker dialog.

### Example

```
try {
  const {action, hour, minute} = await TimePickerAndroid.open({
    hour: 14,
    minute: 0,
    is24Hour: false, // Will display '2 PM'
  });
  if (action !== TimePickerAndroid.dismissedAction) {
    // Selected hour (0-23), minute (0-59)
  }
} catch ({code, message}) {
  console.warn('Cannot open time picker', message);
}
```


### Methods

- [`open`](docs/timepickerandroid.html#open)
- [`timeSetAction`](docs/timepickerandroid.html#timesetaction)
- [`dismissedAction`](docs/timepickerandroid.html#dismissedaction)




---

# Reference

## Methods

### `open()`

```javascript
TimePickerAndroid.open(options)
```


Opens the standard Android time picker dialog.

The available keys for the `options` object are:
  * `hour` (0-23) - the hour to show, defaults to the current time
  * `minute` (0-59) - the minute to show, defaults to the current time
  * `is24Hour` (boolean) - If `true`, the picker uses the 24-hour format. If `false`,
    the picker shows an AM/PM chooser. If undefined, the default for the current locale
    is used.
  * `mode` (`enum('clock', 'spinner', 'default')`) - set the time picker mode
    - 'clock': Show a time picker in clock mode.
    - 'spinner': Show a time picker in spinner mode.
    - 'default': Show a default time picker based on Android versions.

Returns a Promise which will be invoked an object containing `action`, `hour` (0-23),
`minute` (0-59) if the user picked a time. If the user dismissed the dialog, the Promise will
still be resolved with action being `TimePickerAndroid.dismissedAction` and all the other keys
being undefined. **Always** check whether the `action` before reading the values.




---

### `timeSetAction()`

```javascript
TimePickerAndroid.timeSetAction()
```


A time has been selected.




---

### `dismissedAction()`

```javascript
TimePickerAndroid.dismissedAction()
```


The dialog has been dismissed.