Material Calendar View 开源项目学习(三)- 日期的相关算法

这里的“算法”与大家在课本上学的那种“算法分析”的“算法”有些不同,有着更广泛的含义。

【百度百科】: 算法(Algorithm)是指解题方案的准确而完整的描述,是一系列解决问题的清晰指令,算法代表着用系统的方法描述解决问题的策略机制。

如上所述,这里的“算法”泛指解决问题的方案。那Material CalendarView 需要用到哪些跟时间计算有关的算法呢?

  1. 计算日历的页数

日历的显示使用的是ViewPager,在ViewPagerPagerAdapter中必须实现一个返回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);
  1. 显示给定日期所在的月(周)

· 月历模式:

// 返回日期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);
}

大家可以看出,跟前面算页数使用的其实是同一个算法。道理也非常简单,其实就是计算从最早的月(周)到给定的日期有多少个月(周),这个数量就是给定日期所在的页数。

  1. 显示某一页的日历

要想显示某一页的日历,就要计算这一页的所有日期并将其正确摆放(大家可以想象我们在拼一格一格拼日历)。大家一般的常识是,打开日历默认显示当日所在的那一月(周)的日历。那么整理一下思路,可知大致流程应该是:
获取今天的日期 -> 计算今天日期所在的页数 -> 计算这一页的所有日期
第一步,获取今天的日期可以使用Calendar.getInstance()
第二�步,获取今天的日期的页数可以使用上面提到的indexOf方法。
第三步,首先要明确的是本页的起始日期会受到周起始日的影响。比如今天是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 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,就算日期不巧多显示一行页没有关系,就像下面的日历似的:

Material Calendar View 开源项目学习(三)- 日期的相关算法_第1张图片

到这里数学不好的同志(其实就是我)可能就要问了,你这公式tmd怎么出来的呀?其实想明白关键点就霍然开朗了:一周有七天,逢7就进位。
上面那种情况,周的起始日(下面简称为周始日)为7,月的第一天(下面简称为月始日)为周3,周始日>月始日,结合日历一看月首日已经是下一周了,相当于已经进了一位了。那进一位加多少?加7呗,这么一来月首日(3)+7就是10了。那么周首日(7)和月首日(10)之间差多少天?7- 10 = -3天呗。
如果周始日是3,月始日是5,周始日<月始日,说明这一周还没过,没有进位,那么相差日期就是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类的相关方法就能直接转换成时间进行使用。

【总结】

日历日历,最重要的就是显示日期。与日期相关的算法已经在上文介绍的差不多了(吧???)。下一节打算介绍一下日期点按效果的高度可定制是怎么实现的。

你可能感兴趣的:(Material Calendar View 开源项目学习(三)- 日期的相关算法)