Android原生时间控件DatePicker——月份由英文转数字

网上有很多优秀的开源时间控件，可以满足我们大部分的需求。

但有时候还是会碰到系统自带的DatePicker，这个控件默认的月份显示为英文，如JANUARY、FEBRUARY等。

如何将月份由英文改成数字，这是个好玩的问题。

庖丁解牛

DatePicker并没有提供相关api可以实现我们的需求，所以需要我们自己来分析。

查看DatePicke的源码，它的布局文件是date_picker.xml，如下所示：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="fill_parent"    android:layout_height="fill_parent"    android:layout_gravity="center_horizontal"    android:orientation="horizontal"    android:gravity="center">    <LinearLayout android:id="@+id/pickers"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_weight="1"        android:orientation="horizontal"        android:gravity="center">        <!-- Month -->        <NumberPicker            android:id="@+id/month"            android:layout_width="wrap_content"            android:layout_height="wrap_content"            android:layout_marginStart="1dip"            android:layout_marginEnd="1dip"            android:focusable="true"            android:focusableInTouchMode="true"            />        <!-- Day -->        <NumberPicker            android:id="@+id/day"            android:layout_width="wrap_content"            android:layout_height="wrap_content"            android:layout_marginStart="1dip"            android:layout_marginEnd="1dip"            android:focusable="true"            android:focusableInTouchMode="true"            />        <!-- Year -->        <NumberPicker            android:id="@+id/year"            android:layout_width="wrap_content"            android:layout_height="wrap_content"            android:layout_marginStart="1dip"            android:layout_marginEnd="1dip"            android:focusable="true"            android:focusableInTouchMode="true"            />    </LinearLayout>    <!-- calendar view -->    <CalendarView        android:id="@+id/calendar_view"        android:layout_width="245dip"        android:layout_height="280dip"        android:layout_marginStart="44dip"        android:layout_weight="1"        android:focusable="true"        android:focusableInTouchMode="true"        android:visibility="gone"        /></LinearLayout>

可以很轻松地发现，月份就是一个id为month的NumberPicker控件。

在DatePicker中以month控件为线索，很快发现NumberPicker下的这个方法：

    /**     * Sets the values to be displayed.     *     * @param displayedValues The displayed values.     */    public void setDisplayedValues(String[] displayedValues) {        ...        ...        ...    }

该方法参数为一个String数组，该数组每一项就是展示的月份数据。

所以如果我们自己调用该方法，传入以数字表示的月份，就达到目的啦！

寻找调用时机

在DatePicker源码中，直接调用setDisplayedValues方法的地方有两处，

一处是在构造函数中：

public DatePicker(Context context, AttributeSet attrs, int defStyle) {        super(context, attrs, defStyle);        ......        OnValueChangeListener onChangeListener = new OnValueChangeListener() {            public void onValueChange(NumberPicker picker, int oldVal, int newVal) {               ......                updateSpinners();                updateCalendarView();                notifyDateChanged();            }        };       ......        // month        mMonthSpinner = (NumberPicker) findViewById(R.id.month);        mMonthSpinner.setMinValue(0);        mMonthSpinner.setMaxValue(mNumberOfMonths - 1);        mMonthSpinner.setDisplayedValues(mShortMonths);        mMonthSpinner.setOnLongPressUpdateInterval(200);        mMonthSpinner.setOnValueChangedListener(onChangeListener);        mMonthSpinnerInput =(EditText)mMonthSpinner.findViewById(R.id.numberpicker_input);        ......}

mShortMonths就是默认的英文月份，就不展开介绍了。

构造函数中在第X行调用了setDisplayedValues方法，完成了展示月份数据的设置。

同时mMonthSpinner的值监听器为onChangeListener，当月份变化时会回调onValueChange方法，该方法中又会调用updateSpinners方法，这是另一处直接调用setDisplayedValues方法的地方：

private void updateSpinners() {      ......        // make sure the month names are a zero based array        // with the months in the month spinner        String[] displayedValues = Arrays.copyOfRange(mShortMonths,                mMonthSpinner.getMinValue(), mMonthSpinner.getMaxValue() + 1);        mMonthSpinner.setDisplayedValues(displayedValues);      ......    }

而updateSpinners方法除了会在上述的监听器中被调用，还要其他方法中也会调用，例如：

    /**     * Initialize the state. If the provided values designate an inconsistent     * date the values are normalized before updating the spinners.     *     * @param year The initial year.     * @param monthOfYear The initial month <strong>starting from zero</strong>.     * @param dayOfMonth The initial day of the month.     * @param onDateChangedListener How user is notified date is changed by     *            user, can be null.     */    public void init(int year, int monthOfYear, int dayOfMonth,            OnDateChangedListener onDateChangedListener) {        setDate(year, monthOfYear, dayOfMonth);        updateSpinners();        updateCalendarView();        mOnDateChangedListener = onDateChangedListener;    }        /**     * Sets the maximal date supported by this {@link DatePicker} in     * milliseconds since January 1, 1970 00:00:00 in     * {@link TimeZone#getDefault()} time zone.     *     * @param maxDate The maximal supported date.     */    public void setMaxDate(long maxDate) {        mTempDate.setTimeInMillis(maxDate);        if (mTempDate.get(Calendar.YEAR) == mMaxDate.get(Calendar.YEAR)                && mTempDate.get(Calendar.DAY_OF_YEAR) != mMaxDate.get(Calendar.DAY_OF_YEAR)) {            return;        }        mMaxDate.setTimeInMillis(maxDate);        mCalendarView.setMaxDate(maxDate);        if (mCurrentDate.after(mMaxDate)) {            mCurrentDate.setTimeInMillis(mMaxDate.getTimeInMillis());            updateCalendarView();        }        updateSpinners();    }

以上所有直接或间接调用setDisplayedValues方法的地方都会将月份重置为英文显示，所以我们自己调用setDisplayedValues方法的时机就是在这些方法被调用之后。

也就是说，我们的调用时机在DatePicker构造函数之后、init()、setMaxDate()等方法之后和onDateChanged()方法之中。

轻松实现

知道了在何时调用何方法后，我们来具体实现这一需求。

首先准备好展示的月份数组：

String months[] = {"1月", "2月", "3月", "4月", "5月", "6月",            "7月", "8月", "9月", "10月", "11月", "12月"};

假设mDatePicker就是目标DatePicker控件，因为DatePicker没有提供可以获取到月份控件的api，所以需要自己想办法获取到月份控件，再调用它的setDisplayedValues方法。

分析之前的date_picker.xml文件，可以写出下面这行代码：

((NumberPicker) ((ViewGroup) ((ViewGroup) mDatePicker.getChildAt(0)).getChildAt(0)).getChildAt(0)).setDisplayedValues(months);

通过调用这行代码，就实现了替换掉英文月份的目标！