Android中文API——DatePicker&TimePicker

  在Android中,时间日期控件相对来说还是比较丰富的。其中,DatePicker用来实现日期输入设置,TimePicker用来实现时间输入设置。DatePickerDialog用来显示日期对话框,TimePickerDialog用来显示时间对话框。AnalogClock用来显示一个指针式时钟,DigitalClock用来显示一个数字式时钟。

  下面就分别对这些时间日期控件做一个简单的介绍。

 

1.DatePicker

  在Android中,DatePicker用来实现日期输入设置,日期的设置范围为1900年1月1日至2100年12月31日。

1.1常用xml属性

  DatePicker的常用xml属性如图1所示:

Android中文API——DatePicker&TimePicker_第1张图片

图1 DatePicker常用xml属性

  其中,android:calendarViewShown[boolean]用于设置是否显示calendar view;android:endYear[int]用于设置截至日期;android:maxDate[int]用于设置最大的日期;android:minDate[int]用于设置最小的日期;android:spinnersShown[boolean]用于设置是否显示spinners;android:startYear[int]用于设置起始日期。

1.2常用方法

  DatePicker的常用方法有以下一些:

(1)public CalendarView getCalendarView();   //获取CalendarView

(2)public boolean getCalendarViewShown();   //获取CalendarView是否显示

(3)public int getDayOfMonth();         //获取当前日期的日

(4)public long getMaxDate();            //获取最大日期

(5)public long getMinDate();            //获取最小日期

(6)public int getMonth();               //获取当前日期的月

(7)public boolean getSpinnersShown();        //获取Spinners是否显示

(8)public int getYear();             //获取当前日期的年

(9)public void init(int year,int monthOfYear,int dayOfMonth,

DatePicker.OnDateChangedListener onDateChangedListener);     //初始化日期

(10)public void setCalendarViewShown(boolean shown);      //设置是否显示CalendarView

(11)public void setMaxDate(long maxDate);       //设置最大日期

(12)public void setMinDate(long minDate);        //设置最小日期

(13)public void setSpinnersShown(boolean shown);   //设置是否显示Spinners

(14)public void updateDate(int year,int month,int dayOfMonth);    //更新当前日期

 

2.TimePicker

  在Android中,TimePicker用来实现时间输入设置,可以选择12或24小时模式。TimePicker的常用方法有以下一些:

(1)public Integer getCurrentHour();       //获取当前时间的小时

(2)public Integer getCurrentMinute();       //获取当前时间的分钟

(3)public boolean is24HourView();        //获取是否为24小时模式

(4)public void setCurrentHour(Integer currentHour);            //设置当前时间的小时

(5)public void setCurrentMinute(Integer currentMinute);      //设置当前时间的分钟

(6)public void setIs24HourView(Boolean is24HourView);      //设置24小时模式

 

3.DatePickerDialog

  在Android中,DatePickerDialog用来显示日期对话框。DatePickerDialog的常用方法有以下一些:

(1)public DatePicker getDatePicker();                                //获取DatePicker中的日期值 

(2)public void onClick(DialogInterface dialog,int which);       //响应对话框中的点击事件

(3)public void onDateChanged(DatePicker view,int year,int month,int day);       //响应日期改变事件

(4)public void updateDate(int year,int monthOfYear,int dayOfMonth);              //更新当前日期

 

4.TimePickerDialog

  在Android中,TimePickerDialog用来显示时间对话框。TimePickerDialog的常用方法有以下一些:

(1)public void onClick(DialogInterface dialog,int which);                             //响应对话框中的点击事件

(2)public void onTimeChanged(TimePicker view,int hourOfDay,int minute);    //响应时间改变事件

(3)public void updateTime(int hourOfDay,int minuteOfHour);                       //更新当前时间

 

5.AnalogClock

  在Android中,AnalogClock用于显示指针式时钟,该时钟仅有时钟和分钟两个指针。

 

6.DigitalClock

  在Android中,DigitalClock用来显示数字式时钟,显示格式为HH:MM:SS AM/PM。

 

7.实例

  清楚了上面一些关于时间日期控件的属性和方法之后,我们就可以很容易的使用时间日期控件了。

  在本例中,我们通过DatePicker实现了日期输入设置控件的显示,通过TimePicker实现了时间输入设置控件的显示。并在主界面中中添加了两个Button控件,分别用于弹出日期设置对话框DatePickerDialog和时间设置对话框TimePickerDialog。主界面如图2所示:

Android中文API——DatePicker&TimePicker_第2张图片

图2 主界面

  通过DatePicker控件中的“+”和“-”按钮可以分别调整年月日的值,通过TimePicker的“+”和“-”按钮可以分别调整小时和分钟的值。要监听年月日值的改变,需要实现接口android.widget.DatePicker.OnDateChangedListener中的onDateChanged()方法;要监听小时和分钟的值的改变,需要实现接口android.widget.TimePicker.OnTimeChangedListener中的onTimeChanged()方法。具体实现方法如下:

复制代码
 1 /*
 2      * Function  :    时间改变触发函数
 3      * Param         :    view时间控件对象;hourOfDay小时;minute分钟
 4      * Author      :    博客园-依旧淡然
 5      */
 6     public void onTimeChanged(TimePicker view, int hourOfDay, int minute) {
 7         Toast.makeText(MainActivity.this, "当前时间为 " + hourOfDay + ":" + minute, 
 8                 Toast.LENGTH_LONG).show();
 9     }
10 
11     /*
12      * Function  :    日期改变触发函数
13      * Param         :    view日期控件对象;year年;monthOfYear月;dayOfMonth日
14      * Author      :    博客园-依旧淡然
15      */
16     public void onDateChanged(DatePicker view, int year, int monthOfYear, int dayOfMonth) {
17         Toast.makeText(MainActivity.this, "当前日期为" + year + "年" + monthOfYear + "月" + dayOfMonth + "日", 
18                 Toast.LENGTH_LONG).show();
19     }
复制代码

  通过对DatePicker控件和TimePicker控件进行监听,当点击DatePicker控件或TimePicker控件中的“+”或“-”按钮时,将弹出当前日期或当前时间的提示信息,如图3所示:

 图3 调整日期控件的日期值

  除此之外,我们也可以通过日期对话框DatePickerDialog和时间对话框TimePickerDialog来调整日期和时间值。通过点击按钮“通过DatePickerDialog设置日期值”可以弹出日期对话框,通过点击按钮“通过TimePickerDialog设置时间值”可以弹出时间对话框,时间设置对话框如图4所示。

Android中文API——DatePicker&TimePicker_第3张图片

图4 时间设置对话框

  在时间设置对话框中,同样可以调整时间值。需要注意的是,在DatePickerDialog控件中需要实现DatePickerDialog.OnDateSetListener接口,并实现该接口中的onDateSet()方法。在TimePickerDialog控件中需要实现TimePickerDialog.OnTimeSetListener接口,并实现该接口中的onTimeSet()方法。具体实现方法如下:

复制代码
 1 /*
 2      * Function  :        Button按钮响应
 3      * Param         :        v按钮对象
 4      * Author      :    博客园-依旧淡然
 5      */
 6     public void onClick(View v) {
 7         switch (v.getId()) {
 8         case R.id.buttonChangeDate:
 9             MyDatePickerDialog myDatePickerDialog = new MyDatePickerDialog();
10             DatePickerDialog datePickerDialog = new DatePickerDialog(MainActivity.this, 
11                     myDatePickerDialog, mDatePicker.getYear(), mDatePicker.getMonth(), mDatePicker.getDayOfMonth());
12             datePickerDialog.show();                //显示日期设置对话框
13             break;
14         case R.id.buttonChangeTime:
15             MyTimePickerDialog myTimePickerDialog = new MyTimePickerDialog();
16             TimePickerDialog timePickerDialog = new TimePickerDialog(MainActivity.this, 
17                     myTimePickerDialog, mTimePicker.getCurrentHour(), mTimePicker.getCurrentMinute(), true);
18             timePickerDialog.show();            //显示时间设置对话框
19             break;
20         }
21     }
22     
23     /*
24      * Function  :       自定义MyDatePickerDialog类,用于实现DatePickerDialog.OnDateSetListener接口,
25      *                           当点击日期设置对话框中的“设置”按钮时触发该接口方法
26      * Author      :    博客园-依旧淡然
27      */
28     public class MyDatePickerDialog implements DatePickerDialog.OnDateSetListener {
29         public void onDateSet(DatePicker view, int year, int monthOfYear, int dayOfMonth) {
30             mDatePicker.updateDate(year, monthOfYear, dayOfMonth);        //更新日期值
31         }
32     }    
33      
34     /*
35      * Function  :       自定义MyTimePickerDialog类,用于实现TimePickerDialog.OnTimeSetListener接口,
36      *                           当点击时间设置对话框中的“设置”按钮时触发该接口方法
37      * Author      :    博客园-依旧淡然
38      */
39     public class MyTimePickerDialog implements TimePickerDialog.OnTimeSetListener {
40         public void onTimeSet(TimePicker view, int hourOfDay, int minute) {
41             mTimePicker.setCurrentHour(hourOfDay);        //设置TimePicker的小时值
42             mTimePicker.setCurrentMinute(minute);            //设置TimePicker的分钟值
43         }        
44     }
复制代码

你可能感兴趣的:(android,api)