to top
Android APIs
public class

DatePickerDialog

extends AlertDialog
implements DialogInterface.OnClickListener DatePicker.OnDateChangedListener
java.lang.Object
   ↳ android.app.Dialog
     ↳ android.app.AlertDialog
       ↳ android.app.DatePickerDialog

Class Overview

A simple dialog containing an DatePicker.

See the Date Picker tutorial.

Summary

Nested Classes
interface DatePickerDialog.OnDateSetListener The callback used to indicate the user is done filling in the date. 
[Expand]
Inherited Constants
From class android.app.AlertDialog
From interface android.content.DialogInterface
Public Constructors
DatePickerDialog(Context context, DatePickerDialog.OnDateSetListener callBack, int year, int monthOfYear, int dayOfMonth)
DatePickerDialog(Context context, int theme, DatePickerDialog.OnDateSetListener callBack, int year, int monthOfYear, int dayOfMonth)
Public Methods
DatePicker getDatePicker()
Gets the DatePicker contained in this dialog.
void onClick(DialogInterface dialog, int which)
This method will be invoked when a button in the dialog is clicked.
void onDateChanged(DatePicker view, int year, int month, int day)
Called upon a date change.
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 updateDate(int year, int monthOfYear, int dayOfMonth)
Sets the current date.
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
From interface android.content.DialogInterface
From interface android.content.DialogInterface.OnClickListener
From interface android.view.KeyEvent.Callback
From interface android.view.View.OnCreateContextMenuListener
From interface android.view.Window.Callback
From interface android.widget.DatePicker.OnDateChangedListener

Public Constructors

public DatePickerDialog (Context context, DatePickerDialog.OnDateSetListener callBack, int year, int monthOfYear, int dayOfMonth)

Since: API Level 1

Parameters
context The context the dialog is to run in.
callBack How the parent is notified that the date is set.
year The initial year of the dialog.
monthOfYear The initial month of the dialog.
dayOfMonth The initial day of the dialog.

public DatePickerDialog (Context context, int theme, DatePickerDialog.OnDateSetListener callBack, int year, int monthOfYear, int dayOfMonth)

Since: API Level 1

Parameters
context The context the dialog is to run in.
theme the theme to apply to this dialog
callBack How the parent is notified that the date is set.
year The initial year of the dialog.
monthOfYear The initial month of the dialog.
dayOfMonth The initial day of the dialog.

Public Methods

public DatePicker getDatePicker ()

Since: API Level 11

Gets the DatePicker contained in this dialog.

Returns
  • The calendar view.

public void onClick (DialogInterface dialog, int which)

Since: 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 onDateChanged (DatePicker view, int year, int month, int day)

Since: API Level 1

Called upon a date change.

Parameters
view The view associated with this listener.
year The year that was set.
month The month that was set (0-11) for compatibility with Calendar.
day The day of the month that was set.

public void onRestoreInstanceState (Bundle savedInstanceState)

Since: 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 ()

Since: 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 updateDate (int year, int monthOfYear, int dayOfMonth)

Since: API Level 1

Sets the current date.

Parameters
year The date year.
monthOfYear The date month.
dayOfMonth The date day of month.

Protected Methods

protected void onStop ()

Since: API Level 1

Called to tell you that you're stopping.