Android 中文 API （20） —— DatePicker

冷不防 2022-03-28 04:46 222阅读 0赞

**前言**

本章翻译的是android.widget.DatePicker，版本为Android 2.2 r1，译为日期选择器。欢迎更多朋友一起参与Android API 的中文翻译行动!我的邮箱over140@gmail.com。

**声明**

欢迎转载，但请保留文章原始出处:)

博客园：http://www.cnblogs.com

农民伯伯： http://www.cnblogs.com/over140/

**正文**

一、结构

***public class DatePicker extends FrameLayout***

java.lang.Object

[android.view.View][]

android.view.ViewGroup

android.widget.FrameLayout

android.widget.DatePicker

二、概述

![2010-10-27_1.jpg][]

一个选择年月日的日历布局视图。对于对话框样式的日历视图，参见`DatePickerDialog`.

三、公共方法

public int getDayOfMonth ()

获取选择的天数

public int getMonth ()

获取选择的月份。（注意：返回数值为0..11，需要自己\+1来显示）

public int getYear ()

获取选择的年份

public void init (int year, int monthOfYear, int dayOfMonth, DatePicker.OnDateChangedListener onDateChangedListener)

初始化状态。（译者注：初始化年月日）

参数

year 初始年（译者注：注意使用*new Date()*初始化年时，需要\+1900，如下：*date.getYear() + 1900*）

monthOfYear 初始月。

dayOfMonth 初始日。

onDateChangedListener 日期改变时通知用户的事件监听，可以为空(null)。

public void setEnabled (boolean enabled)

设置视图的启用状态。该启用状态随子类的不同而有不同的解释。

参数

enabled 设置为true表示启动视图，反之禁用。

public void updateDate (int year, int monthOfYear, int dayOfMonth)

更新日期

四、受保护方法

protected void dispatchRestoreInstanceState (SparseArray<Parcelable> container)

重写使我们能够完全控制这小部件的保存或恢复。（译者注：此处直接调用了父类的*ViewGroup. dispatchThawSelfOnly*方法）

参数

container SparseArray 持有保存以前的状态。The SparseArray which holds previously saved state.

protected void onRestoreInstanceState (Parcelable state)

允许视图重新应用以前通过onSaveInstanceState()生成代表内部的状态。这个函数决不调用一个空的状态。

参数

state The frozen state that had previously been returned by onSaveInstanceState().

返回以前调用onSaveInstanceState()保存下来的状态。

protected Parcelable onSaveInstanceState ()

允许视图生成一个代表内部的状态，以后可用于创建一个与之相同的新的实例。这种状态应该只包含非持久或以后不能够重建的信息。例如，你决不存储你当前在屏幕上的位置，因为这会在视图的层面上重新计算放置一个新的实例。

你可以存储到这里的一些例子：一个文本框中当前光标的位置（但通常不是文字本身，文字通常保存在内容提供者(content provider)或其他持久的储存中），一个列表视图中的当前选中项。

返回值

返回一个包含视图当前状态的Parcelable对象，或没有什么状态保存时返回null。默认实现返回null。

五、补充

5.1　　如果只想显示年月或者是月日，可以取巧用android:layout\_marginLeft属性控制显示隐藏控件一部分。

5.2　　如果用Date初始化的时候，需要注意年的问题：

Date date  =  new  Date();  
dpDate.init(date.getYear()  \+  1900 , date.getMonth(),  1 ,  null );

代码说明：dpDate为DatePicker控件。

5.3　　相关文章链接

[DatePicker的一些问题][DatePicker]

[日期選擇器(DatePicker)和時間選擇器(TimePicker)][DatePicker_TimePicker]

[Android中动态输入日期与时间-DatePicker与TimePicker应用][Android_-DatePicker_TimePicker]

**结束**

为了节约时间，从本章开始不提供PDF和WORD格式下载，定期出CHM格式的合集供大家下载。此外文章随时可能更新，请大家保持链接。

[android.view.View]: http://www.cnblogs.com/over140/archive/2010/09/11/1823806.html
[2010-10-27_1.jpg]: /images/20220328/333b1a102c04494b981e18ffd2df0f61.png
[DatePicker]: http://hi.baidu.com/lfcaolibin/blog/item/3625db9640a1fd6655fb9611.html
[DatePicker_TimePicker]: http://androidbiancheng.blogspot.com/2010/01/datepickertimepicker.html
[Android_-DatePicker_TimePicker]: http://www.hidroid.net/droid/bbs/viewthread.php?tid=202