DatePickerDialog
public
class
DatePickerDialog
extends AlertDialog
implements
DialogInterface.OnClickListener,
DatePicker.OnDateChangedListener
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.OnDateSetListener
The 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, int themeResId)
Creates a new date picker dialog for the current date. |
|
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, 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 be null . |
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 be null . |
themeResId |
int : the resource ID of the theme against which to inflate
this dialog, or 0 to use the parent
context 's default alert dialog theme |
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 be null . |
listener |
DatePickerDialog.OnDateSetListener : the listener to call when the user sets the date
This value may be null . |
year |
int : the initially selected year |
month |
int : the initially selected month (0-11 for compatibility with
Calendar#MONTH ) |
dayOfMonth |
int : the initially selected day of month (1-31, depending
on month) |
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 be null . |
themeResId |
int : the resource ID of the theme against which to inflate
this dialog, or 0 to use the parent
context 's default alert dialog theme |
listener |
DatePickerDialog.OnDateSetListener : the listener to call when the user sets the date
This value may be null . |
year |
int : the initially selected year |
monthOfYear |
int : the initially selected month of the year (0-11 for
compatibility with Calendar#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 be null . |
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 be null . |
year |
int : The year that was set. |
month |
int : The month that was set (0-11) for compatibility
with Calendar . |
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 by
onSaveInstanceState() .
This value cannot be null . |
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 be null . |
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 with
Calendar#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 2024-04-11 UTC.