Android provides controls for the user to pick a time or pick a date as ready-to-use dialogs. Each picker provides controls for selecting each part of the time (hour, minute, AM/PM) or date (month, day, year). Using these pickers helps ensure that your users can pick a time or date that is valid, formatted correctly, and adjusted to the user's locale.
We recommend that you use {@link android.support.v4.app.DialogFragment} to host each time or date picker. The {@link android.support.v4.app.DialogFragment} manages the dialog lifecycle for you and allows you to display the pickers in different layout configurations, such as in a basic dialog on handsets or as an embedded part of the layout on large screens.
Although {@link android.app.DialogFragment} was first added to the platform in Android 3.0 (API level 11), if your app supports versions of Android older than 3.0—even as low as Android 1.6—you can use the {@link android.support.v4.app.DialogFragment} class that's available in the support library for backward compatibility.
Note: The code samples below show how to create dialogs for a time picker and date picker using the support library APIs for {@link android.support.v4.app.DialogFragment}. If your app's {@code minSdkVersion} is 11 or higher, you can instead use the platform version of {@link android.app.DialogFragment}.
To display a {@link android.app.TimePickerDialog} using {@link android.support.v4.app.DialogFragment}, you need to define a fragment class that extends {@link android.support.v4.app.DialogFragment} and return a {@link android.app.TimePickerDialog} from the fragment's {@link android.support.v4.app.DialogFragment#onCreateDialog onCreateDialog()} method.
Note: If your app supports versions of Android older than 3.0, be sure you've set up your Android project with the support library as described in Setting Up a Project to Use a Library.
To define a {@link android.support.v4.app.DialogFragment} for a {@link android.app.TimePickerDialog}, you must:
Here's an example:
public static class TimePickerFragment extends DialogFragment
implements TimePickerDialog.OnTimeSetListener {
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
// Use the current time as the default values for the picker
final Calendar c = Calendar.getInstance();
int hour = c.get(Calendar.HOUR_OF_DAY);
int minute = c.get(Calendar.MINUTE);
// Create a new instance of TimePickerDialog and return it
return new TimePickerDialog(getActivity(), this, hour, minute,
DateFormat.is24HourFormat(getActivity()));
}
public void onTimeSet(TimePicker view, int hourOfDay, int minute) {
// Do something with the time chosen by the user
}
}
See the {@link android.app.TimePickerDialog} class for information about the constructor arguments.
Now all you need is an event that adds an instance of this fragment to your activity.
Once you've defined a {@link android.support.v4.app.DialogFragment} like the one shown above, you can display the time picker by creating an instance of the {@link android.support.v4.app.DialogFragment} and calling {@link android.support.v4.app.DialogFragment#show show()}.
For example, here's a button that, when clicked, calls a method to show the dialog:
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/pick_time"
android:onClick="showTimePickerDialog" />
When the user clicks this button, the system calls the following method:
public void showTimePickerDialog(View v) {
DialogFragment newFragment = new TimePickerFragment();
newFragment.show(getSupportFragmentManager(), "timePicker");
}
This method calls {@link android.support.v4.app.DialogFragment#show show()} on a new instance of the {@link android.support.v4.app.DialogFragment} defined above. The {@link android.support.v4.app.DialogFragment#show show()} method requires an instance of {@link android.support.v4.app.FragmentManager} and a unique tag name for the fragment.
Caution: If your app supports versions of Android lower than 3.0, be sure that you call {@link android.support.v4.app.FragmentActivity#getSupportFragmentManager()} to acquire an instance of {@link android.support.v4.app.FragmentManager}. Also make sure that your activity that displays the time picker extends {@link android.support.v4.app.FragmentActivity} instead of the standard {@link android.app.Activity} class.
Creating a {@link android.app.DatePickerDialog} is just like creating a {@link android.app.TimePickerDialog}. The only difference is the dialog you create for the fragment.
To display a {@link android.app.DatePickerDialog} using {@link android.support.v4.app.DialogFragment}, you need to define a fragment class that extends {@link android.support.v4.app.DialogFragment} and return a {@link android.app.DatePickerDialog} from the fragment's {@link android.support.v4.app.DialogFragment#onCreateDialog onCreateDialog()} method.
Note: If your app supports versions of Android older than 3.0, be sure you've set up your Android project with the support library as described in Setting Up a Project to Use a Library.
To define a {@link android.support.v4.app.DialogFragment} for a {@link android.app.DatePickerDialog}, you must:
Here's an example:
public static class DatePickerFragment extends DialogFragment
implements DatePickerDialog.OnDateSetListener {
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
// Use the current date as the default date in the picker
final Calendar c = Calendar.getInstance();
int year = c.get(Calendar.YEAR);
int month = c.get(Calendar.MONTH);
int day = c.get(Calendar.DAY_OF_MONTH);
// Create a new instance of DatePickerDialog and return it
return new DatePickerDialog(getActivity(), this, year, month, day);
}
public void onDateSet(DatePicker view, int year, int month, int day) {
// Do something with the date chosen by the user
}
}
See the {@link android.app.DatePickerDialog} class for information about the constructor arguments.
Now all you need is an event that adds an instance of this fragment to your activity.
Once you've defined a {@link android.support.v4.app.DialogFragment} like the one shown above, you can display the date picker by creating an instance of the {@link android.support.v4.app.DialogFragment} and calling {@link android.support.v4.app.DialogFragment#show show()}.
For example, here's a button that, when clicked, calls a method to show the dialog:
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/pick_date"
android:onClick="showDatePickerDialog" />
When the user clicks this button, the system calls the following method:
public void showDatePickerDialog(View v) {
DialogFragment newFragment = new DatePickerFragment();
newFragment.show(getSupportFragmentManager(), "datePicker");
}
This method calls {@link android.support.v4.app.DialogFragment#show show()} on a new instance of the {@link android.support.v4.app.DialogFragment} defined above. The {@link android.support.v4.app.DialogFragment#show show()} method requires an instance of {@link android.support.v4.app.FragmentManager} and a unique tag name for the fragment.
Caution: If your app supports versions of Android lower than 3.0, be sure that you call {@link android.support.v4.app.FragmentActivity#getSupportFragmentManager()} to acquire an instance of {@link android.support.v4.app.FragmentManager}. Also make sure that your activity that displays the time picker extends {@link android.support.v4.app.FragmentActivity} instead of the standard {@link android.app.Activity} class.