Android日期显示和日期选择库

日期显示和选择类库，可以用来选择一段连续的和多个不连续的日期，具体的ui完全抽象出来了，可以高度自定义（github地址）

支持的功能:

1、选择一段连续的和多个不连续的日期
2、提供了两个工具类（singlemonthselector、calendarselector）用来处理单个月和多个连续月日期的选择
3、可以拦截选择事件，当选择的日期长度有限制或某些特殊的日期不可以选择时，可以中断这次选择事件
4、singlemonthselector、calendarselector两个工具类都支持状态保存，可以restore之前的状态
5、ui显示可以非常灵活的进行自定义，可以为每个月中的天指定不同的layout，还可以为每月的行和列（6行7列）指定不同的装饰器
6、一个礼拜的第一天并不完全一致，现在支持(sunday、saturday、monday)三种
7、为了在layout的时候能实时的查看具体的显示样式，所以提供了editor mode支持，在开发调试的时候还是比较方便的
8、支持api+8以上版本

如何使用

在gradle文件中加入依赖

compile 'com.tubb.calendarselector.library:calendar-selector:0.1.1'

使用monthview来显示月，这个是我们的自定义view，主要工作是组合显示某个月的天数

<com.tubb.calendarselector.library.monthview
 android:id="@+id/ssmv"
 android:layout_width="match_parent"
 android:layout_height="300dp"
 sc:sc_firstday_week="sunday"
 sc:sc_draw_monthday_only="false"
 sc:sc_month="2016-3"/>

为了方便，我们提供两个工具类来进行日期的选择功能，singlemonthselector用来进行单个月的选择，calendarselector用来进行多个连续月的选择，
我们也为这两个工具类提供了状态保持的功能，为了在必要的时候进行状态的恢复，给用户更好一点的体验，具体使用可以查看statesavedactivity

使用singlemonthselector

singlemonthselector.bind(monthview);

使用calendarselector (这里有点要注意的是：还不支持listview，针对这种情况直接使用recyclerview好了)

calendarselector.bind(containerviewgroup, monthview, itemposition);

我们为这两个日期选择工具类都提供了两种模式来支持选择连续(segment)和不连续(interval)的一段时间

segment mode

selector = new calendarselector(data, calendarselector.mode.segment);
selector.setsegmentselectlistener(new segmentselectlistener() {
 @override
 public void onsegmentselect(fullday startday, fullday endday) {
  log.d(tag, "segment select " + startday.tostring() + " : " + endday.tostring());
 }

 @override
 public boolean oninterceptselect(fullday selectingday) { // one day intercept
  if(scdateutils.istoday(selectingday.getyear(), selectingday.getmonth(), selectingday.getday())){
   toast.maketext(calendarselectoractivity.this, "today can't be selected", toast.length_short).show();
   return true;
  }
  return super.oninterceptselect(selectingday);
 }

 @override
 public boolean oninterceptselect(fullday startday, fullday endday) { // segment days intercept
  int differdays = scdateutils.countdays(startday.getyear(), startday.getmonth(), startday.getday(),
    endday.getyear(), endday.getmonth(), endday.getday());
  log.d(tag, "differdays " + differdays);
  if(differdays > 10) {
   toast.maketext(calendarselectoractivity.this, "selected days can't more than 10", toast.length_short).show();
   return true;
  }
  return super.oninterceptselect(startday, endday);
 }

 @override
 public void selectedsameday(fullday sameday) { // selected the same day
  super.selectedsameday(sameday);
 }
});

interval mode

selector = new singlemonthselector(calendarselector.mode.interval);
selector.setintervalselectlistener(new intervalselectlistener() {
 @override
 public void onintervalselect(list<fullday> selecteddays) {
  log.d(tag, "interval selected days " + selecteddays.tostring());
 }

 @override
 public boolean oninterceptselect(list<fullday> selecteddays, fullday selectingday) {
  if(selecteddays.size() >= 5) {
   toast.maketext(singlemonthselectoractivity.this, "selected days can't more than 5", toast.length_long).show();
   return true;
  }
  return super.oninterceptselect(selecteddays, selectingday);
 }
});

在这两种模式下我们都提供了选择事件的拦截功能，这样就有能力来实现一些限制，比如日期长度的限制、某些特殊日期不可选择等

具体如何使用可以查看示例程序 singlemonthselectoractivity 和 calendarselectoractivity

如何自定义

我们为monthview的显示提供了非常灵活的自定义功能，monthview本身就是一个功能完善的自定义view，并且具体某天的显示都可以在layout文件中配置

<?xml version="1.0" encoding="utf-8"?>
<framelayout xmlns:android="http://schemas.android.com/apk/res/android"
 android:layout_width="match_parent"
 android:layout_height="match_parent"
 xmlns:tools="http://schemas.android.com/tools">

 <textview
  android:id="@+id/tvday"
  android:layout_width="30dp"
  android:layout_height="30dp"
  android:textsize="@dimen/t_16"
  tools:text="0"
  android:layout_gravity="center"
  android:gravity="center"
  android:textcolor="@color/color_dayview_text_selector"
  android:background="@drawable/drawable_custom_dayview_text_bg"
  />

</framelayout>

为了比较灵活的实现上面的自定义功能，我们特意抽象出来一个接口dayviewinflater，只要实现这个接口，并进行相应的设置(monthview.setscmonth(scmonth, new customdayviewinflater(context)))就行

public class customdayviewinflater extends dayviewinflater{

 public customdayviewinflater(context context) {
  super(context);
 }

 @override
 public dayviewholder inflatedayview(viewgroup container) {
  view dayview = mlayoutinflater.inflate(r.layout.layout_dayview_custom, container, false);
  return new customdayviewholder(dayview);
 }

 public static class customdayviewholder extends dayviewholder{

  protected textview tvday;
  private int mprevmonthdaytextcolor;
  private int mnextmonthdaytextcolor;

  public customdayviewholder(view dayview) {
   super(dayview);
   tvday = (textview) dayview.findviewbyid(com.tubb.calendarselector.library.r.id.tvday);
   mprevmonthdaytextcolor = contextcompat.getcolor(mcontext, com.tubb.calendarselector.library.r.color.c_999999);
   mnextmonthdaytextcolor = contextcompat.getcolor(mcontext, com.tubb.calendarselector.library.r.color.c_999999);
  }

  @override
  public void setcurrentmonthdaytext(fullday day, boolean isselected) {
   tvday.settext(string.valueof(day.getday()));
   tvday.setselected(isselected);
  }

  @override
  public void setprevmonthdaytext(fullday day) {
   tvday.settextcolor(mprevmonthdaytextcolor);
   tvday.settext(string.valueof(day.getday()));
  }

  @override
  public void setnextmonthdaytext(fullday day) {
   tvday.settextcolor(mnextmonthdaytextcolor);
   tvday.settext(string.valueof(day.getday()));
  }

 }
}

既然是日期的选择，那么会有两种状态（选中、未选中）之间的切换，我们也把这个状态切换的接口暴露出来了（dayviewholder.setcurrentmonthdaytext(fullday day, boolean isselected)），
这样我们就可以在状态切换的时候弄些动画什么的，具体的可以查看animdayviewinflater示例程序

@override
public void setcurrentmonthdaytext(fullday day, boolean isselected) {
 boolean oldselected = tvday.isselected();
 tvday.settext(string.valueof(day.getday()));
 tvday.setselected(isselected);
 // view selected animation
 if(!oldselected && isselected){
  animatorset animatorset = new animatorset();
  animatorset.setinterpolator(animationutils.loadinterpolator(mcontext, android.r.anim.bounce_interpolator));
  animatorset.play(objectanimator.offloat(tvday, "scalex", 0.5f, 1.0f))
    .with(objectanimator.offloat(tvday, "scaley", 0.5f, 1.0f));
  animatorset.setduration(500)
    .start();
 }
}

在有些情况下可能会为monthview的行和列加一些装饰显得更美观一点，这个功能我们也是支持的，具体如何实现可以查看 decordayviewinflater示例程序

@override
public decor inflatehorizontaldecor(viewgroup container, int row, int totalrow) {
 return new decor(mlayoutinflater.inflate(r.layout.view_horizontal_decor, container, false), true);
}

@override
public decor inflateverticaldecor(viewgroup container, int col, int totalcol) {
 return new decor(mlayoutinflater.inflate(r.layout.view_vertical_decor, container, false), true);
}

我们还为 monthview提供了一些自定的属性，比如只显示本月的日期、指定一个星期的哪天为第一天，还有一些为开发调试时候方便而加入的属性等

<resources>
 <declare-styleable name="monthview">
  <!-- only draw the month day, or not, default is false -->
  <attr name="sc_draw_monthday_only" format="boolean"/>
  <!-- start day of a week, we support (sunday、monday and saturday) -->
  <attr name="sc_firstday_week" format="enum">
   <enum name="sunday" value="1"/>
   <enum name="monday" value="2"/>
   <enum name="saturday" value="7"/>
  </attr>

  <!-- editor mode only -->
  <!-- test selected days (format:1,2,3,4) -->
  <attr name="sc_selected_days" format="string"/>
  <!-- test month (format:2016-3) -->
  <attr name="sc_month" format="string"/>
 </declare-styleable>
</resources>

以上就是本文的全部内容，希望对大家学习android软件编程有所帮助。