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. 显示某一页的日历

要想显示某一页的日历,就要计算这一页的所有日期并将其正确摆放(大家可以想象我们在拼一格一格拼日历)。大家一般的常识是,打开日历默认显示当日所在的那一月(周)的日历。那么整理一下思路,可知大致流程应该是:
<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类的相关方法就能直接转换成时间进行使用。

【总结】

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,921评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,635评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,393评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,836评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,833评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,685评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,043评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,694评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,671评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,670评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,779评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,424评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,027评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,984评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,214评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,108评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,517评论 2 343

推荐阅读更多精彩内容