日历组件的使用汇总

最近项目中用到自定义日历组件,找来找去,最后发现GitHub的material-calendarview这个项目最贴近以上需求,稍作修改就能用了,简单记录下基本知识点。

首先是到两个基本的Java类

Date类

在JDK1.0中,Date类是唯一的一个代表时间的类,但是由于Date类不便于实现国际化,所以从JDK1.1版本开始,推荐使用Calendar类进行时间和日期处理。这里简单介绍一下Date类的使用。

1、使用Date类代表当前系统时间

Date d = new Date();

使用Date类的默认构造方法创建出的对象就代表当前时间,由于Date类覆盖了toString方法,所以可以直接输出Date类型的对象,显示的结果如下:

Sun Mar 08 16:35:58 CST 2017

在该格式中,Sun代表Sunday(周日),Mar代表March(三月),08代表8号,CST代表China Standard Time(中国标准时间,也就是北京时间(东八区))。

2、使用Date类代表指定的时间

Date d1 = new Date(2017-1900,3-1,9);

System.out.println(d1);

使用带参数的构造方法,可以构造指定日期的Date类对象,Date类中年份的参数应该是实际需要代表的年份减去1900,实际需要代表的月份减去1以后的值。例如上面的示例代码代表就是2019年9月9号。

实际代表具体的年月日时分秒的日期对象,和这个类似。

3、获得Date对象中的信息

Date d2 = new Date();//年份

int year = d2.getYear() + 1900;//月份

int month = d2.getMonth() + 1;//日期

int date = d2.getDate();//小时

int hour = d2.getHours();//分钟

int minute = d2.getMinutes();//秒

int second = d2.getSeconds();//星期几

int day = d2.getDay();

System.out.println("年份:" + year);

System.out.println("月份:" + month);

System.out.println("日期:" + date);

System.out.println("小时:" + hour);

System.out.println("分钟:" + minute);

System.out.println("秒:" + second);

System.out.println("星期:" + day);

使用Date类中对应的get方法,可以获得Date类对象中相关的信息,需要注意的是使用getYear获得是Date对象中年份减去1900以后的值,所以需要显示对应的年份则需要在返回值的基础上加上1900,月份类似。在Date类中还提供了getDay方法,用于获得Date对象代表的时间是星期几,Date类规定周日是0,周一是1,周二是2,后续的依次类推。

4、Date对象和相对时间之间的互转

Date d3 = new Date(2017-1900,9-18,10);

long time = 1290876532190L;

//将Date类的对象转换为相对时间

long t = d3.getTime();

System.out.println(t);

//将相对时间转换为Date类的对象

Date d4 = new Date(time);

System.out.println(d4);

使用Date对象中的getTime方法,可以将Date类的对象转换为相对时间,使用Date类的构造方法,可以将相对时间转换为Date类的对象。经过转换以后,既方便了时间的计算,也使时间显示比较直观了。

Calendar类

从JDK1.1版本开始,在处理日期和时间时,系统推荐使用Calendar类进行实现。在设计上,Calendar类的功能要比Date类强大很多,而且在实现方式上也比Date类要复杂一些,下面就介绍一下Calendar类的使用。

Calendar类是一个抽象类,在实际使用时实现特定的子类的对象,创建对象的过程对程序员来说是透明的,只需要使用getInstance方法创建即可。

1、使用Calendar类代表当前时间

Calendar c = Calendar.getInstance();

由于Calendar类是抽象类,且Calendar类的构造方法是protected的,所以无法使用Calendar类的构造方法来创建对象,API中提供了getInstance方法用来创建对象。

使用该方法获得的Calendar对象就代表当前的系统时间,由于Calendar类toString实现的没有Date类那么直观,所以直接输出Calendar类的对象意义不大。

2、使用Calendar类代表指定的时间

Calendar c1 = Calendar.getInstance();

c1.set(2017, 3 - 1, 9);

使用Calendar类代表特定的时间,需要首先创建一个Calendar的对象,然后再设定该对象中的年月日参数来完成。

set方法的声明为:

public final void set(int year,int month,int date)

以上示例代码设置的时间为2017年3月9日,其参数的结构和Date类不一样。Calendar类中年份的数值直接书写,月份的值为实际的月份值减1,日期的值就是实际的日期值。

如果只设定某个字段,例如日期的值,则可以使用如下set方法:

public void set(int field,int value)

在该方法中,参数field代表要设置的字段的类型,常见类型如下:

Calendar.YEAR——年份

Calendar.MONTH——月份

Calendar.DATE——日期

Calendar.DAY_OF_MONTH——日期,和上面的字段完全相同

Calendar.HOUR——12小时制的小时数

Calendar.HOUR_OF_DAY——24小时制的小时数

Calendar.MINUTE——分钟

Calendar.SECOND——秒

Calendar.DAY_OF_WEEK——星期几

后续的参数value代表,设置成的值。例如:

c1.set(Calendar.DATE,10);

该代码的作用是将c1对象代表的时间中日期设置为10号,其它所有的数值会被重新计算,例如星期几以及对应的相对时间数值等。

3、获得Calendar类中的信息

Calendar c2 = Calendar.getInstance();//年份

int year = c2.get(Calendar.YEAR);//月份

int month = c2.get(Calendar.MONTH) + 1;//日期

int date = c2.get(Calendar.DATE);//小时

int hour = c2.get(Calendar.HOUR_OF_DAY);//分钟

int minute = c2.get(Calendar.MINUTE);//秒

int second = c2.get(Calendar.SECOND);//星期几

int day = c2.get(Calendar.DAY_OF_WEEK);

System.out.println("年份:" + year);

System.out.println("月份:" + month);

System.out.println("日期:" + date);

System.out.println("小时:" + hour);

System.out.println("分钟:" + minute);

System.out.println("秒:" + second);

System.out.println("星期:" + day);

使用Calendar类中的get方法可以获得Calendar对象中对应的信息,get方法的声明如下:

public int get(int field)

其中参数field代表需要获得的字段的值,字段说明和上面的set方法保持一致。需要说明的是,获得的月份为实际的月份值减1,获得的星期的值和Date类不一样。在Calendar类中,周日是1,周一是2,周二是3,依次类推。

4、其它方法说明

其实Calendar类中还提供了很多其它有用的方法,下面简单的介绍几个常见方法的使用。

a、add方法

public abstract void add(int field,int amount)

该方法的作用是在Calendar对象中的某个字段上增加或减少一定的数值,增加是amount的值为正,减少时amount的值为负。

例如在计算一下当前时间100天以后的日期,代码如下:

Calendar c3 = Calendar.getInstance();

c3.add(Calendar.DATE, 100);

int year1 = c3.get(Calendar.YEAR);//月份

int month1 = c3.get(Calendar.MONTH) + 1;//日期

int date1 = c3.get(Calendar.DATE);

System.out.println(year1 + "年" + month1 + "月" + date1 + "日");

这里add方法是指在c3对象的Calendar.DATE,也就是日期字段上增加100,类内部会重新计算该日期对象中其它各字段的值,从而获得100天以后的日期

b、after方法

public boolean after(Object when)

该方法的作用是判断当前日期对象是否在when对象的后面,如果在when对象的后面则返回true,否则返回false。例如:

Calendar c4 = Calendar.getInstance();

c4.set(2007, 10 - 1, 10);

Calendar c5 = Calendar.getInstance();

c5.set(2017, 10 - 1, 10);

boolean b = c5.after(c4);

System.out.println(b);

另外一个类似的方法是before,该方法是判断当前日期对象是否位于另外一个日期对象之前。

c、getTime方法

public final Date getTime()

该方法的作用是将Calendar类型的对象转换为对应的Date类对象,两者代表相同的时间点。

类似的方法是setTime,该方法的作用是将Date对象转换为对应的Calendar对象,该方法的声明如下:

public final void setTime(Date date)

转换的示例代码如下:

Date d = new Date();

Calendar c6 = Calendar.getInstance();//Calendar类型的对象转换为Date对象

Date d1 = c6.getTime();//Date类型的对象转换为Calendar对象

Calendar c7 = Calendar.getInstance();

c7.setTime(d);

5、Calendar对象和相对时间之间的互转

Calendar c8 = Calendar.getInstance();

long t = 1252785271098L;

//将Calendar对象转换为相对时间

long t1 = c8.getTimeInMillis();

//将相对时间转换为Calendar对象

Calendar c9 = Calendar.getInstance();

c9.setTimeInMillis(t1);

在转换时,使用Calendar类中的getTimeInMillis方法可以将Calendar对象转换为相对时间。在将相对时间转换为Calendar对象时,首先创建一个Calendar对象,然后再使用Calendar类的setTimeInMillis方法设置时间即可。

MaterialCalendarView

项目开源地址:

https://github.com/prolificinteractive/material-calendarview

集成清单

添加compile 'com.prolificinteractive:material-calendarview:1.4.0'

添加日历控件到布局中

xmlns:app="http://schemas.android.com/apk/res-auto"

android:id="@+id/calendarView"

android:layout_width="match_parent"

android:layout_height="wrap_content"

app:mcv_showOtherDates="all"

app:mcv_selectionColor="#00F"

/>

功能展示

material-calendarview项目提供9个Sample来展示其功能用法

一、对照组:OldCalendarViewActivity

采用系统控件CalendarView,实现一个点击显示日期的功能,可惜在低版本Android手机上没有material的样式,颜值很低,不能用。

二、基本用法:BasicActivity

绑定控件

@Bind(R.id.calendarView)

MaterialCalendarView widget;

OnDateSelectedListener:用来监听选中日期的变化,

/**

* The callback used to indicate a date has been selected or deselected

*/

public interface OnDateSelectedListener {

/**

* Called when a user clicks on a day.

* There is no logic to prevent multiple calls for the same date and state.

*

* @param widget  the view associated with this listener

* @param date    the date that was selected or unselected

* @param selected true if the day is now selected, false otherwise

*/

void onDateSelected(@NonNull MaterialCalendarView widget, @NonNull CalendarDay date, boolean selected);

}

OnMonthChangedListener:用来接听页面滑动的变化,这个有点名不副实,因为在周模式的时候,滑动页面是按周来变化的

/**

* The callback used to indicate the user changes the displayed month

*/

public interface OnMonthChangedListener {

/**

* Called upon change of the selected day

*

* @param widget the view associated with this listener

* @param date  the month picked, as the first day of the month

*/

void onMonthChanged(MaterialCalendarView widget, CalendarDay date);

}

getSelectedDate():获取被选中的日期。

private String getSelectedDatesString() {

CalendarDay date = widget.getSelectedDate();

if (date == null) {

return "No Selection";

}

return FORMATTER.format(date.getDate());

}

三、修饰选中日期:BasicActivityDecorated

设置日期范围

widget.setShowOtherDates(MaterialCalendarView.SHOW_ALL);

Calendar instance = Calendar.getInstance();

widget.setSelectedDate(instance.getTime());

Calendar instance1 = Calendar.getInstance();

instance1.set(instance1.get(Calendar.YEAR), Calendar.JANUARY, 1);

Calendar instance2 = Calendar.getInstance();

instance2.set(instance2.get(Calendar.YEAR), Calendar.DECEMBER, 31);

widget.state().edit()

.setMinimumDate(instance1.getTime())

.setMaximumDate(instance2.getTime())

.commit();

增加日期修饰

widget.addDecorators(

new MySelectorDecorator(this),

new HighlightWeekendsDecorator(),

oneDayDecorator

);

案例提供了三种修饰:

对选中日期增加指定背景图层

public class MySelectorDecorator implements DayViewDecorator {

private final Drawable drawable;

public MySelectorDecorator(Activity context) {

drawable = context.getResources().getDrawable(R.drawable.my_selector);

}

@Override

public boolean shouldDecorate(CalendarDay day) {

return true;

}

@Override

public void decorate(DayViewFacade view) {

view.setSelectionDrawable(drawable);

}

}

对周末增加指定背景图层

/**

* Highlight Saturdays and Sundays with a background

*/

public class HighlightWeekendsDecorator implements DayViewDecorator {

private final Calendar calendar = Calendar.getInstance();

private final Drawable highlightDrawable;

private static final int color = Color.parseColor("#228BC34A");

public HighlightWeekendsDecorator() {

highlightDrawable = new ColorDrawable(color);

}

@Override

public boolean shouldDecorate(CalendarDay day) {

day.copyTo(calendar);

int weekDay = calendar.get(Calendar.DAY_OF_WEEK);

return weekDay == Calendar.SATURDAY || weekDay == Calendar.SUNDAY;

}

@Override

public void decorate(DayViewFacade view) {

view.setBackgroundDrawable(highlightDrawable);

}

}

对选中日期增加指定修饰

/**

* Decorate a day by making the text big and bold

*/

public class OneDayDecorator implements DayViewDecorator {

private CalendarDay date;

public OneDayDecorator() {

date = CalendarDay.today();

}

@Override

public boolean shouldDecorate(CalendarDay day) {

return date != null && day.equals(date);

}

@Override

public void decorate(DayViewFacade view) {

view.addSpan(new StyleSpan(Typeface.BOLD));

view.addSpan(new RelativeSizeSpan(3.0f));

}

/**

* We're changing the internals, so make sure to call {@linkplain MaterialCalendarView#invalidateDecorators()}

*/

public void setDate(Date date) {

this.date = CalendarDay.from(date);

}

}

对特定日期增加红点修饰

/**

* Decorate several days with a dot

*/

public class EventDecorator implements DayViewDecorator {

private int color;

private HashSet dates;

public EventDecorator(int color, Collection dates) {

this.color = color;

this.dates = new HashSet<>(dates);

}

@Override

public boolean shouldDecorate(CalendarDay day) {

return dates.contains(day);

}

@Override

public void decorate(DayViewFacade view) {

view.addSpan(new DotSpan(5, color));

}

}

四、模式切换:SwappableBasicActivityDecorated

切换周模式、月模式

@OnClick(R.id.button_weeks)

public void onSetWeekMode() {

widget.state().edit()

.setCalendarDisplayMode(CalendarMode.WEEKS)

.commit();

}

@OnClick(R.id.button_months)

public void onSetMonthMode() {

widget.state().edit()

.setCalendarDisplayMode(CalendarMode.MONTHS)

.commit();

}

五、日期禁用:DisableDaysActivity

核心代码是:

DayViewFacade view

view.setDaysDisabled(true);

这个作者非常喜欢用装饰模式。所以对DayViewFacade的修饰可以无穷的累加。只要集成DayViewDecorator就可以。

/**

* Decorate Day views with drawables and text manipulation

*/

public interface DayViewDecorator {

/**

* Determine if a specific day should be decorated

*

* @param day {@linkplain CalendarDay} to possibly decorate

* @return true if this decorator should be applied to the provided day

*/

boolean shouldDecorate(CalendarDay day);

/**

* Set decoration options onto a facade to be applied to all relevant days

*

* @param view View to decorate

*/

void decorate(DayViewFacade view);

}

六、透过xml自定义控件:CustomizeXmlActivity

xml中能设置的属性很多,常用的如下:

mcv_showOtherDates:日期范围

mcv_firstDayOfWeek:一周的第一天

mcv_calendarMode:日历模式

七、透过java自定义控件:CustomizeCodeActivity

效果和xml是一致的。

widget.setShowOtherDates(MaterialCalendarView.SHOW_ALL);widget.setArrowColor(getResources().getColor(R.color.sample_primary));widget.setLeftArrowMask(getResources().getDrawable(R.drawable.ic_navigation_arrow_back));widget.setRightArrowMask(getResources().getDrawable(R.drawable.ic_navigation_arrow_forward));widget.setSelectionColor(getResources().getColor(R.color.sample_primary));widget.setHeaderTextAppearance(R.style.TextAppearance_AppCompat_Medium);widget.setWeekDayTextAppearance(R.style.TextAppearance_AppCompat_Medium);widget.setDateTextAppearance(R.style.CustomDayTextAppearance);widget.setTitleFormatter(newMonthArrayTitleFormatter(getResources().getTextArray(R.array.custom_months)));widget.setWeekDayFormatter(newArrayWeekDayFormatter(getResources().getTextArray(R.array.custom_weekdays)));widget.setTileSize((int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP,36, getResources().getDisplayMetrics()));CalendarDay today = CalendarDay.from(2016,5,2);widget.setCurrentDate(today);widget.setSelectedDate(today);widget.state().edit()        .setFirstDayOfWeek(Calendar.WEDNESDAY)        .setMinimumDate(CalendarDay.from(2016,4,3))        .setMaximumDate(CalendarDay.from(2016,5,12))        .setCalendarDisplayMode(CalendarMode.WEEKS)        .commit();

八、完整的设置展示DynamicSettersActivity

推荐阅读更多精彩内容