Android 提供现成可用的对话框式控件，供用户选择时间或日期。这些 选择器 提供控件，用于选择时间（小时、分钟、上午/下午）或日期（月、日、年）的各个部分。
使用这些选择器有助于确保用户选择的时间或日期有效、格式正确，并根据用户所在的区域设置进行调整。
我们建议您使用 DialogFragment 来托管每个时间或日期选择器。DialogFragment 为您管理对话框生命周期，并允许您在不同的布局配置中显示选择器，例如在手持设备上的基本对话框中，或在大屏幕上作为布局的嵌入部分。
创建时间选择器
要使用 DialogFragment 显示 TimePickerDialog，请定义一个扩展 DialogFragment 的 fragment 类，然后从 fragment 的 onCreateDialog() 方法返回 TimePickerDialog。
为时间选择器扩展 DialogFragment
要为 TimePickerDialog 定义 DialogFragment，请执行以下操作
- 定义
onCreateDialog()方法，使其返回TimePickerDialog的实例。 - 实现
TimePickerDialog.OnTimeSetListener接口，以在用户设置时间时接收回调。
以下是一个示例
Kotlin
class TimePickerFragment : DialogFragment(), TimePickerDialog.OnTimeSetListener { override fun onCreateDialog(savedInstanceState: Bundle): Dialog { // Use the current time as the default values for the picker. val c = Calendar.getInstance() val hour = c.get(Calendar.HOUR_OF_DAY) val minute = c.get(Calendar.MINUTE) // Create a new instance of TimePickerDialog and return it. return TimePickerDialog(activity, this, hour, minute, DateFormat.is24HourFormat(activity)) } override fun onTimeSet(view: TimePicker, hourOfDay: Int, minute: Int) { // Do something with the time the user picks. } }
Java
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 the user picks. } }
有关构造函数参数的信息，请参阅 TimePickerDialog 类。
现在，您只需一个将此 fragment 的实例添加到 Activity 的事件即可。
显示时间选择器
按照前面的示例定义 DialogFragment 后，您可以创建一个 DialogFragment 实例并调用 show() 方法来显示时间选择器。
例如，以下是一个按钮，点击该按钮会调用一个方法来显示对话框
<Button android:id="@+id/pickTime" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Pick time" />
当用户点击此按钮时，系统会调用以下方法
Kotlin
findViewById<Button>(R.id.pickTime).setOnClickListener { TimePickerFragment().show(supportFragmentManager, "timePicker") }
Java
findViewById<Button>(R.id.pickTime).setOnClickListener { TimePickerFragment().show(supportFragmentManager, "timePicker"); }
此方法会调用前面示例中定义的新的 DialogFragment 实例上的 show()。 show() 方法需要一个 FragmentManager 实例和一个 fragment 的唯一标签名称。
创建日期选择器
创建 DatePickerDialog 与创建 TimePickerDialog 类似。区别在于您为 fragment 创建的对话框。
要使用 DialogFragment 显示 DatePickerDialog，请定义一个扩展 DialogFragment 的 fragment 类，然后从 fragment 的 onCreateDialog() 方法返回 DatePickerDialog。
为日期选择器扩展 DialogFragment
要为 DatePickerDialog 定义 DialogFragment，请执行以下操作
- 定义
onCreateDialog()方法，使其返回DatePickerDialog的实例。 - 实现
DatePickerDialog.OnDateSetListener接口，以在用户设置日期时接收回调。
以下是一个示例
Kotlin
class DatePickerFragment : DialogFragment(), DatePickerDialog.OnDateSetListener { override fun onCreateDialog(savedInstanceState: Bundle): Dialog { // Use the current date as the default date in the picker. val c = Calendar.getInstance() val year = c.get(Calendar.YEAR) val month = c.get(Calendar.MONTH) val day = c.get(Calendar.DAY_OF_MONTH) // Create a new instance of DatePickerDialog and return it. return DatePickerDialog(requireContext(), this, year, month, day) } override fun onDateSet(view: DatePicker, year: Int, month: Int, day: Int) { // Do something with the date the user picks. } }
Java
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(requireContext(), this, year, month, day); } public void onDateSet(DatePicker view, int year, int month, int day) { // Do something with the date the user picks. } }
有关构造函数参数的信息，请参阅 DatePickerDialog 类。
您只需一个将此 fragment 的实例添加到 Activity 的事件即可。
显示日期选择器
按照前面的示例定义 DialogFragment 后，您可以创建一个 DialogFragment 实例并调用 show() 来显示日期选择器。
例如，以下是一个按钮，点击该按钮会调用一个方法来显示对话框
<Button android:id="@+id/pickDate" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Pick date"/>
当用户点击此按钮时，系统会调用以下方法
Kotlin
findViewById<Button>(R.id.pickDate).setOnClickListener { val newFragment = DatePickerFragment() newFragment.show(supportFragmentManager, "datePicker") }
Java
findViewById<Button>(R.id.pickDate).setOnClickListener { val newFragment = DatePickerFragment(); newFragment.show(supportFragmentManager, "datePicker"); }
此方法会调用前面示例中定义的新的 DialogFragment 实例上的 show()。 show() 方法需要一个 FragmentManager 实例和一个 fragment 的唯一标签名称。
将选择器与自动填充功能结合使用
2017 年，Android 推出了自动填充框架，该框架允许用户保存可用于在不同应用中填写表单的数据。选择器通过提供一个 UI，让用户能够更改存储日期或时间数据的字段的值，在自动填充场景中非常有用。例如，在信用卡表单中，日期选择器允许用户输入或更改其信用卡的到期日期。
由于选择器是对话框，因此它们不会与其他字段一起显示在 Activity 中。要在选择器不可见时显示选择器数据，您可以使用另一个视图，例如 EditText，它可以在选择器不可见时显示值。
EditText 对象原生期望类型为 AUTOFILL_TYPE_TEXT 的自动填充数据。相反，自动填充服务将数据保存为 AUTOFILL_TYPE_DATE，以创建其适当的表示形式。为了解决类型不一致的问题，我们建议您创建一个继承自 EditText 的自定义视图，并实现正确处理 AUTOFILL_TYPE_DATE 类型值所需的方法。
执行以下步骤创建 EditText 的子类，该子类可以处理 AUTOFILL_TYPE_DATE 类型的值
- 创建一个继承自
EditText的类。 - 实现
getAutofillType()方法，该方法返回AUTOFILL_TYPE_DATE。 - 实现
getAutofillValue()方法，该方法返回一个AutofillValue对象，该对象以毫秒为单位表示日期。要创建返回对象，请使用forDate()方法生成AutofillValue对象。 - 实现
autofill()方法。此方法提供处理AutofillValue参数的逻辑，该参数的类型为AUTOFILL_TYPE_DATE。要处理该参数，请创建其适当的字符串表示形式，例如mm/yyyy。使用字符串表示形式设置视图的text属性。 - 实现用户想要编辑自定义
EditText子类中的日期时显示选择器的功能。视图会使用用户在选择器上选择的值的字符串表示形式更新text属性。
有关处理 AUTOFILL_TYPE_DATE 值的 EditText 子类的示例，请参阅自动填充框架示例（Java 版或 Kotlin 版）。
要了解如何为自定义视图提供自动填充支持，请参阅自动填充框架。