DatePickerDialog
  public
  
  
  
  class
  DatePickerDialog
  
  
  
  
  
  
  
    extends AlertDialog
  
  
  
  
  
      implements
      
        DatePicker.OnDateChangedListener, 
      
        DialogInterface.OnClickListener
      
  
  
| java.lang.Object | |||
| ↳ | android.app.Dialog | ||
| ↳ | android.app.AlertDialog | ||
| ↳ | android.app.DatePickerDialog | ||
A simple dialog containing an DatePicker.
 
See the Pickers guide.
Summary
| Nested classes | |
|---|---|
| 
        
        
        
        
        interface | DatePickerDialog.OnDateSetListenerThe listener used to indicate the user has finished selecting a date. | 
| Inherited constants | 
|---|
| Public constructors | |
|---|---|
| 
      DatePickerDialog(Context context)
      Creates a new date picker dialog for the current date using the parent context's default date picker dialog theme. | |
| 
      DatePickerDialog(Context context, DatePickerDialog.OnDateSetListener listener, int year, int month, int dayOfMonth)
      Creates a new date picker dialog for the specified date using the parent context's default date picker dialog theme. | |
| 
      DatePickerDialog(Context context, int themeResId)
      Creates a new date picker dialog for the current date. | |
| 
      DatePickerDialog(Context context, int themeResId, DatePickerDialog.OnDateSetListener listener, int year, int monthOfYear, int dayOfMonth)
      Creates a new date picker dialog for the specified date. | |
| Public methods | |
|---|---|
| 
        
        
        
        
        
        DatePicker | 
      getDatePicker()
      Returns the  | 
| 
        
        
        
        
        
        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 dayOfMonth)
      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 | 
      setOnDateSetListener(DatePickerDialog.OnDateSetListener listener)
      Sets the listener to call when the user sets the date. | 
| 
        
        
        
        
        
        void | 
      updateDate(int year, int month, int dayOfMonth)
      Sets the current date. | 
| Inherited methods | |
|---|---|
Public constructors
DatePickerDialog
public DatePickerDialog (Context context)
Creates a new date picker dialog for the current date using the parent context's default date picker dialog theme.
| Parameters | |
|---|---|
| context | Context: the parent context
 This value cannot benull. | 
DatePickerDialog
public DatePickerDialog (Context context, DatePickerDialog.OnDateSetListener listener, int year, int month, int dayOfMonth)
Creates a new date picker dialog for the specified date using the parent context's default date picker dialog theme.
| Parameters | |
|---|---|
| context | Context: the parent context
 This value cannot benull. | 
| listener | DatePickerDialog.OnDateSetListener: the listener to call when the user sets the date
 This value may benull. | 
| year | int: the initially selected year | 
| month | int: the initially selected month (0-11 for compatibility withCalendar.MONTH) | 
| dayOfMonth | int: the initially selected day of month (1-31, depending
                   on month) | 
DatePickerDialog
public DatePickerDialog (Context context, int themeResId)
Creates a new date picker dialog for the current date.
| Parameters | |
|---|---|
| context | Context: the parent context
 This value cannot benull. | 
| themeResId | int: the resource ID of the theme against which to inflate
                   this dialog, or0to use the parentcontext's default alert dialog theme | 
DatePickerDialog
public DatePickerDialog (Context context, int themeResId, DatePickerDialog.OnDateSetListener listener, int year, int monthOfYear, int dayOfMonth)
Creates a new date picker dialog for the specified date.
| Parameters | |
|---|---|
| context | Context: the parent context
 This value cannot benull. | 
| themeResId | int: the resource ID of the theme against which to inflate
                   this dialog, or0to use the parentcontext's default alert dialog theme | 
| listener | DatePickerDialog.OnDateSetListener: the listener to call when the user sets the date
 This value may benull. | 
| year | int: the initially selected year | 
| monthOfYear | int: the initially selected month of the year (0-11 for
                    compatibility withCalendar.MONTH) | 
| dayOfMonth | int: the initially selected day of month (1-31, depending
                   on month) | 
Public methods
getDatePicker
public DatePicker getDatePicker ()
Returns the DatePicker contained in this dialog.
| Returns | |
|---|---|
| DatePicker | the date picker
 This value cannot be null. | 
onClick
public void onClick (DialogInterface dialog, int which)
This method will be invoked when a button in the dialog is clicked.
| Parameters | |
|---|---|
| dialog | DialogInterface: This value cannot benull. | 
| which | int: the button that was clicked (ex.DialogInterface.BUTTON_POSITIVE) or the position
              of the item clicked | 
onDateChanged
public void onDateChanged (DatePicker view, int year, int month, int dayOfMonth)
Called upon a date change.
| Parameters | |
|---|---|
| view | DatePicker: This value cannot benull. | 
| year | int: The year that was set. | 
| month | int: The month that was set (0-11) for compatibility
            withCalendar. | 
| dayOfMonth | int: The day of the month that was set. | 
onRestoreInstanceState
public 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 byonSaveInstanceState().
 This value cannot benull. | 
onSaveInstanceState
public 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.
 This value cannot be null. | 
setOnDateSetListener
public void setOnDateSetListener (DatePickerDialog.OnDateSetListener listener)
Sets the listener to call when the user sets the date.
| Parameters | |
|---|---|
| listener | DatePickerDialog.OnDateSetListener: the listener to call when the user sets the date
 This value may benull. | 
updateDate
public void updateDate (int year, 
                int month, 
                int dayOfMonth)Sets the current date.
| Parameters | |
|---|---|
| year | int: the year | 
| month | int: the month (0-11 for compatibility withCalendar.MONTH) | 
| dayOfMonth | int: the day of month (1-31, depending on month) | 
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
