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();}};......// monthmMonthSpinner = (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 spinnerString[] 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);

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