这里的“算法”与大家在课本上学的那种“算法分析”的“算法”有些不同,有着更广泛的含义。
【百度百科】: 算法(Algorithm)是指解题方案的准确而完整的描述,是一系列解决问题的清晰指令,算法代表着用系统的方法描述解决问题的策略机制。
如上所述,这里的“算法”泛指解决问题的方案。那Material CalendarView 需要用到哪些跟时间计算有关的算法呢?
-
计算日历的页数
日历的显示使用的是ViewPager
,在ViewPager
的PagerAdapter
中必须实现一个返回page的数量方法。page的数量由两个因素决定:日历的显示模式(周历、月历)和时间范围。
· 月历模式的页数:
int yearDiff = maxDay.getYear() - minDay.getYear();
int monthDiff = maxDay.getMonth() - minDay.getMonth();
int monthCount = (yearDiff * 12) + monthDiff + 1;
// 例如时间范围是2000年1月到2099年12月,那么一共有(2099-2000)*12+(12-1)+1个月(page页)
· 周历模式的页数:
long millisDiff = max.getTime().getTime() - min.getTime().getTime();
int dstOffsetMax = max.get(Calendar.DST_OFFSET);
int dstOffsetMin = min.get(Calendar.DST_OFFSET);
long dayDiff = TimeUnit.DAYS.convert(millisDiff + dstOffsetMax - dstOffsetMin, TimeUnit.MILLISECONDS);
int weekCount = (int) (dayDiff / 7);
-
显示给定日期所在的月(周)
· 月历模式:
// 返回日期day所在的页数
@Override
public int indexOf(CalendarDay day) {
int yDiff = day.getYear() - min.getYear();
int mDiff = day.getMonth() - min.getMonth();
return (yDiff * 12) + mDiff;
}
· 日历模式
// 返回日期day所在的页数
@Override
public int indexOf(CalendarDay day) {
return weekNumberDifference(min, day);
}
//
private int weekNumberDifference(@NonNull CalendarDay min, @NonNull CalendarDay max) {
long millisDiff = max.getDate().getTime() - min.getDate().getTime();
int dstOffsetMax = max.getCalendar().get(Calendar.DST_OFFSET);
int dstOffsetMin = min.getCalendar().get(Calendar.DST_OFFSET);
long dayDiff = TimeUnit.DAYS.convert(millisDiff + dstOffsetMax - dstOffsetMin, TimeUnit.MILLISECONDS);
return (int) (dayDiff / DAYS_IN_WEEK);
}
大家可以看出,跟前面算页数使用的其实是同一个算法。道理也非常简单,其实就是计算从最早的月(周)到给定的日期有多少个月(周),这个数量就是给定日期所在的页数。
-
显示某一页的日历
要想显示某一页的日历,就要计算这一页的所有日期并将其正确摆放(大家可以想象我们在拼一格一格拼日历)。大家一般的常识是,打开日历默认显示当日所在的那一月(周)的日历。那么整理一下思路,可知大致流程应该是:
<b><i>获取今天的日期 -> 计算今天日期所在的页数 -> 计算这一页的所有日期</i></b>
第一步,获取今天的日期可以使用Calendar.getInstance()
。
第二�步,获取今天的日期的页数可以使用上面提到的indexOf
方法。
第三步,首先要明确的是本页的起始日期会受到<u>周起始日</u>的影响。比如今天是3号,那么以下两图分别代表周起始日是周日与周三的两种情况:
下面贴出作者计算这个时间起始时间的代码:
protected Calendar resetAndGetWorkingCalendar() {
getFirstViewDay().copyTo(tempWorkingCalendar);
//noinspection ResourceType
tempWorkingCalendar.setFirstDayOfWeek(getFirstDayOfWeek());
int dow = CalendarUtils.getDayOfWeek(tempWorkingCalendar);
int delta = getFirstDayOfWeek() - dow;
//If the delta is positive, we want to remove a week
boolean removeRow = showOtherMonths(showOtherDates) ? delta >= 0 : delta > 0;
if (removeRow) {
delta -= DEFAULT_DAYS_IN_WEEK;
}
tempWorkingCalendar.add(DATE, delta);
return tempWorkingCalendar;
}
截取的代码是关键部分,很多变量不是在这里声明和赋值的,所以大家先不用过度关注实现细节,这里着重讲作者的实现思路。
- 月历模式:
① 计算当月1日是周几
② 计算当月1日和周起始日的间隔日子数。公式是:
如果:周起始日>当月第一天是周几
日子差值 = 周起始日 - (当月第一天是周几 + 7);
如果:周起始日<=月起始日
日子差值 = 周起始日 - 当月第一天是周几
拿上面的公式来套一下日历:
日子差值 = 周起始日|7 - (当月第一天是周几|3 + 一周有多少天|7) = -3
根据上面的计算结果,第一天的日期,应该是当月首日挪-3天,即当月首日的前3天的日期——28日。
接着只需要从这个日期开始,添加“日历格子”就行
@Override
protected void buildDayViews(Collection<DayView> dayViews, Calendar calendar) {
for (int r = 0; r < DEFAULT_MAX_WEEKS; r++) {
for (int i = 0; i < DEFAULT_DAYS_IN_WEEK; i++) {
addDayView(dayViews, calendar);
}
}
}
上面的DEFAULT_MAX_WEEKS
固定为6,就算日期不巧多显示一行页没有关系,就像下面的日历似的:
到这里数学不好的同志(其实就是我)可能就要问了,你这公式tmd怎么出来的呀?其实想明白关键点就霍然开朗了:一周有七天,逢7就进位。
上面那种情况,周的起始日(下面简称为<b><u>周始日</u></b>)为7,月的第一天(下面简称为<b><u>月始日</u></b>)为周3,<b><u>周始日</u></b>><b><u>月始日</u></b>,结合日历一看月首日已经是下一周了,相当于已经进了一位了。那进一位加多少?加7呗,这么一来月首日(3)+7就是10了。那么周首日(7)和月首日(10)之间差多少天?7- 10 = -3天呗。
如果<b><u>周始日</u></b>是3,<b><u>月始日</u></b>是5,<b><u>周始日</u></b><<b><u>月始日</u></b>,说明这一周还没过,没有进位,那么相差日期就是3 - 5 = -2 天。
- 周历模式:
周历模式就没什么好说了,按照可以按照页数直接算出当周的第一天是几号
@Override
public CalendarDay getItem(int position) {
long minMillis = min.getDate().getTime();
long millisOffset = TimeUnit.MILLISECONDS.convert(
position * DAYS_IN_WEEK,
TimeUnit.DAYS);
long positionMillis = minMillis + millisOffset;
return CalendarDay.from(new Date(positionMillis));
}
算法的思路是,最小日期的毫秒数,加上前面页数的毫秒数,就是当周第一天的毫秒数了,然后使用Calendar
类的相关方法就能直接转换成时间进行使用。
【总结】
日历日历,最重要的就是显示日期。与日期相关的算法已经在上文介绍的差不多了(吧???)。下一节打算介绍一下日期点按效果的高度可定制是怎么实现的。