Skip to content

Most visited

Recently visited

navigation
Added in API level 1

TimePickerDialog

public class TimePickerDialog
extends AlertDialog implements DialogInterface.OnClickListener, TimePicker.OnTimeChangedListener

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


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 (e.g. 

Inherited constants

From class android.app.AlertDialog
From interface android.content.DialogInterface

Public constructors

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

Creates a new time picker dialog.

TimePickerDialog(Context context, int themeResId, TimePickerDialog.OnTimeSetListener listener, int hourOfDay, int minute, boolean is24HourView)

Creates a new time picker dialog with the specified theme.

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 minuteOfHour)

Sets the current time.

Inherited methods

From class android.app.AlertDialog
From class android.app.Dialog
From class java.lang.Object
From interface android.content.DialogInterface
From interface android.view.Window.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.View.OnCreateContextMenuListener
From interface android.content.DialogInterface.OnClickListener
From interface android.widget.TimePicker.OnTimeChangedListener

Public constructors

TimePickerDialog

Added in API level 1
TimePickerDialog (Context context, 
                TimePickerDialog.OnTimeSetListener listener, 
                int hourOfDay, 
                int minute, 
                boolean is24HourView)

Creates a new time picker dialog.

Parameters
context Context: the parent context
listener TimePickerDialog.OnTimeSetListener: the listener to call when the time is set
hourOfDay int: the initial hour
minute int: the initial minute
is24HourView boolean: whether this is a 24 hour view or AM/PM

TimePickerDialog

Added in API level 1
TimePickerDialog (Context context, 
                int themeResId, 
                TimePickerDialog.OnTimeSetListener listener, 
                int hourOfDay, 
                int minute, 
                boolean is24HourView)

Creates a new time picker dialog with the specified theme.

Parameters
context Context: the parent context
themeResId int: the resource ID of the theme to apply to this dialog
listener TimePickerDialog.OnTimeSetListener: the listener to call when the time is set
hourOfDay int: the initial hour
minute int: the initial minute
is24HourView boolean: Whether this is a 24 hour view, or AM/PM.

Public methods

onClick

Added in API level 1
void onClick (DialogInterface dialog, 
                int which)

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

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

onRestoreInstanceState

Added in API level 1
void onRestoreInstanceState (Bundle savedInstanceState)

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 Bundle: The state of the dialog previously saved by onSaveInstanceState().

onSaveInstanceState

Added in API level 1
Bundle onSaveInstanceState ()

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
Bundle A bundle with the state of the dialog.

onTimeChanged

Added in API level 1
void onTimeChanged (TimePicker view, 
                int hourOfDay, 
                int minute)

Parameters
view TimePicker
hourOfDay int
minute int

updateTime

Added in API level 1
void updateTime (int hourOfDay, 
                int minuteOfHour)

Sets the current time.

Parameters
hourOfDay int: The current hour within the day.
minuteOfHour int: The current minute within the hour.
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.