Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Added in API level 1

public class

TimePickerDialog

extends AlertDialog
implements DialogInterface.OnClickListener TimePicker.OnTimeChangedListener

java.lang.Object
↳	android.app.Dialog
	↳	android.app.AlertDialog
		↳	android.app.TimePickerDialog

Class Overview

A dialog that prompts the user for the time of day using a TimePicker .

See the Pickers guide.

Summary

Nested Classes
interface	TimePickerDialog.OnTimeSetListener	The callback interface used to indicate the user is done filling in the time (they clicked on the 'Set' button).

[Expand]

Inherited Constants

From class android.app.AlertDialog

From interface android.content.DialogInterface

Public Constructors
	TimePickerDialog ( Context context, TimePickerDialog.OnTimeSetListener callBack, int hourOfDay, int minute, boolean is24HourView)
	TimePickerDialog ( Context context, int theme, TimePickerDialog.OnTimeSetListener callBack, int hourOfDay, int minute, boolean is24HourView)

Public Methods
void	onClick ( DialogInterface dialog, int which) This method will be invoked when a button in the dialog is clicked.
void	onRestoreInstanceState ( Bundle savedInstanceState) Restore the state of the dialog from a previously saved bundle.
Bundle	onSaveInstanceState () Saves the state of the dialog into a bundle.
void	onTimeChanged ( TimePicker view, int hourOfDay, int minute)
void	updateTime (int hourOfDay, int minutOfHour)

Protected Methods
void	onStop () Called to tell you that you're stopping.

[Expand]

Inherited Methods

From class android.app.AlertDialog

From class android.app.Dialog

From class java.lang.Object

Object	clone () Creates and returns a copy of this `Object` .
boolean	equals ( Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize () Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class <?>	getClass () Returns the unique instance of `Class` that represents this object's class.
int	hashCode () Returns an integer hash code for this object.
final void	notify () Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll () Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString () Returns a string containing a concise, human-readable description of this object.
final void	wait () Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait (long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait (long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface android.content.DialogInterface

From interface android.content.DialogInterface.OnClickListener

From interface android.view.KeyEvent.Callback

abstract boolean	onKeyDown (int keyCode, KeyEvent event) Called when a key down event has occurred.
abstract boolean	onKeyLongPress (int keyCode, KeyEvent event) Called when a long press has occurred.
abstract boolean	onKeyMultiple (int keyCode, int count, KeyEvent event) Called when multiple down/up pairs of the same key have occurred in a row.
abstract boolean	onKeyUp (int keyCode, KeyEvent event) Called when a key up event has occurred.

From interface android.view.View.OnCreateContextMenuListener

From interface android.view.Window.Callback

From interface android.widget.TimePicker.OnTimeChangedListener

Public Constructors

public TimePickerDialog ( Context context, TimePickerDialog.OnTimeSetListener callBack, int hourOfDay, int minute, boolean is24HourView)

Added in API level 1

Parameters

context	Parent.
callBack	How parent is notified.
hourOfDay	The initial hour.
minute	The initial minute.
is24HourView	Whether this is a 24 hour view, or AM/PM.

public TimePickerDialog ( Context context, int theme, TimePickerDialog.OnTimeSetListener callBack, int hourOfDay, int minute, boolean is24HourView)

Added in API level 1

Parameters

context	Parent.
theme	the theme to apply to this dialog
callBack	How parent is notified.
hourOfDay	The initial hour.
minute	The initial minute.
is24HourView	Whether this is a 24 hour view, or AM/PM.

Public Methods

public void onClick ( DialogInterface dialog, int which)

Added in API level 1

This method will be invoked when a button in the dialog is clicked.

Parameters

dialog	The dialog that received the click.
which	The button that was clicked (e.g. `BUTTON1` ) or the position of the item clicked.

public void onRestoreInstanceState ( Bundle savedInstanceState)

Added in API level 1

Restore the state of the dialog from a previously saved bundle. The default implementation restores the state of the dialog's view hierarchy that was saved in the default implementation of onSaveInstanceState() , so be sure to call through to super when overriding unless you want to do all restoring of state yourself.

Parameters

savedInstanceState	The state of the dialog previously saved by `onSaveInstanceState()` .

public Bundle onSaveInstanceState ()

Added in API level 1

Saves the state of the dialog into a bundle. The default implementation saves the state of its view hierarchy, so you'll likely want to call through to super if you override this to save additional state.

Returns

A bundle with the state of the dialog.

public void onTimeChanged ( TimePicker view, int hourOfDay, int minute)

Added in API level 1

public void updateTime (int hourOfDay, int minutOfHour)

Added in API level 1

Protected Methods

protected void onStop ()

Added in API level 1

Called to tell you that you're stopping.

Results

Interfaces

Classes

Exceptions

TimePickerDialog

Class Overview

Summary

Public Constructors

public TimePickerDialog ( Context context, TimePickerDialog.OnTimeSetListener callBack, int hourOfDay, int minute, boolean is24HourView)

Parameters

public TimePickerDialog ( Context context, int theme, TimePickerDialog.OnTimeSetListener callBack, int hourOfDay, int minute, boolean is24HourView)

Parameters

Public Methods

public void onClick ( DialogInterface dialog, int which)

Parameters

public void onRestoreInstanceState ( Bundle savedInstanceState)

Parameters

public Bundle onSaveInstanceState ()

Returns

public void onTimeChanged ( TimePicker view, int hourOfDay, int minute)

public void updateTime (int hourOfDay, int minutOfHour)

Protected Methods

protected void onStop ()