java获取每月最后一天

2022-06-22 00:00:00 java 获取 每月

一个小问题,成为了一个坑。

相信大家对这个题目——Java获取每个月的最后一天——都不陌生吧。其实,不纠结于最后一天啦,也可以是上个月的最后一天,下个月的第一天,等等之类的。我发现网上都是写好的一些例子,提供给大家解决那些固定要获取的一个月的最后一天或者第一天,但是代码注释却又惜字如金,导致使用者在完全不理解的情况下,Ctrl+C和Ctrl+V,一个坑就暗含在了这里。

先上一组“凌乱”的代码,根据方法名,这个函数是要求得每月的最后一天:

public static String getDateLastDay(String year, String month) {

      //year="2018" month="2" 
      Calendar calendar = Calendar.getInstance();
      // 设置时间,当前时间不用设置
      calendar.set(Calendar.YEAR, Integer.parseInt(year));
      calendar.set(Calendar.MONTH, Integer.parseInt(month));

      // System.out.println(calendar.getTime());

      calendar.set(Calendar.DAY_OF_MONTH, 1); 
      calendar.set(Calendar.DATE, calendar.getActualMaximum(Calendar.DATE));
      DateFormat format = new SimpleDateFormat("yyyy-MM-dd ");
      return format.format(calendar.getTime());
}

解析:
1. 对于这两行代码:

calendar.set(Calendar.DAY_OF_MONTH, 1); 
calendar.set(Calendar.DATE, calendar.getActualMaximum(Calendar.DATE));

产生了一条冗余代码,首先Calendar.DAY_OF_MONTH和Calendar.DATE,本来就是一回事,如果你进入该行的JDK API你就会发现如下的解释:

 /**
     * Field number for <code>get</code> and <code>set</code> indicating the
     * day of the month. This is a synonym for <code>DATE</code>.
     * The first day of the month has value 1.
     *
     * @see #DATE
     */
    public final static int DAY_OF_MONTH = 5;

这里明确阐明了DAY_OF_MONTH是DATE的同义词,可以理解成别名。
因此,JDK对于 Calendar.DAY_OF_MONTH和Calendar.DATE的取值都是“5”,所以看到有人一会用Calendar.DAY_OF_MONTH进行calendar实例对象的set,一会又用Calendar.DATE进行calendar实例对象的set,可见没有理解这两行代码的意思。

  1. 那个老生常谈的问题。Calendar的体系中,month是从“0”开始数,Day却是从“1”开始数。
    对于month来讲,这句话calendar.set(Calendar.MONTH, Integer.parseInt(month)); 如果设置的是1,那么下面的这句System.out.println(calendar.getTime());打印的将是3月的当前日,可见month是从“0”开始计数;同样的,对于Day,上面的那段JDK代码中也说了“The first day of the month has value 1.” 所以,在这里java8之前的JDK版本对于Calendar的设计确实是存在着凌乱的,也是容易让我们程序员感到困惑的点。

  2. calendar.set和 calendar.add。曾经我也犯过这样的错误,把add和set混用,其实对于set来说,你按照month从0开始,day从1开始这条规则设置的某个月的第几天就是第几天,对比add,也确实是在“0和1”的基线上加天数和月数。
    如果改成这样:

Calendar calendar = Calendar.getInstance();

calendar.set(Calendar.YEAR, 2018);
calendar.set(Calendar.MONTH, 2);
System.out.println(calendar.getTime());

calendar.add(Calendar.MONTH, 3);
System.out.println(calendar.getTime());

先后打印的结果就是:

Tue Mar 06 10:50:38 CST 2018
Wed Jun 06 10:50:38 CST 2018

没有问题。
我们可以把Calendar的设置简单想成一个指针,set和add都是以你设置的日期为基准加上之前提到的“0和1”规则,进行指针移动,如果想要后退指针,那么很简单,set或者add负数就可以了。

  1. calendar.set(Calendar.DAY_OF_MONTH, 0)的作用。我们之前说了,day是从1开始的,那么这句话又是什么鬼呢。其实很容易理解,如果按照第三条贴出的代码,此时指针指向了2018-06-06,那么再执行这句话就相当于将指针的天数归零,然后后退一个月,也就是会输出2018-05-31 。记住,如果你这样执行:
Calendar calendar = Calendar.getInstance();

calendar.set(Calendar.YEAR, 2018);
calendar.set(Calendar.MONTH, 2);
System.out.println(calendar.getTime());

calendar.add(Calendar.MONTH, 3);
System.out.println(calendar.getTime());

calendar.set(Calendar.DAY_OF_MONTH, 12);
calendar.set(Calendar.DAY_OF_MONTH, 0); 

先设置了日子12,这时变成2018-06-12,再执行归零操作,那么还是变为2018-05-31,所以这句话就是将当前指针指向的日期回退到上个月的最后一天。

  1. calendar.getActualMaximum(Calendar.DATE))。在最初的凌乱代码中贴出的calendar.getActualMaximum(Calendar.DATE))这句话需要跟“归零”操作区分开,这句话是真真正正的求当前指针指向的月份的最后一天。强烈不建议把calendar.getActualMaximum(Calendar.DATE))放在calendar.set中,因为会让你对指针走到哪里了产生困惑,尤其在加入了“归零”操作的代码中,比如:
Calendar calendar = Calendar.getInstance();

calendar.set(Calendar.YEAR, 2018);
calendar.set(Calendar.MONTH, 2);
System.out.println(calendar.getTime()); //此处是三月

calendar.add(Calendar.MONTH, 3); 
System.out.println(calendar.getTime()); //此处是六月

calendar.set(Calendar.DAY_OF_MONTH, 12);
System.out.println(calendar.getTime()); //此处是6.12
calendar.set(Calendar.DAY_OF_MONTH, 0); //此处是5.31

System.out.println(calendar.getActualMaximum(Calendar.DATE)); 
//此处是5月份的31天
System.out.println(calendar.getTime()); //此处是5.31

calendar.set(Calendar.DATE, calendar.getActualMaximum(Calendar.DATE));

DateFormat format = new SimpleDateFormat("yyyy-MM-dd");
System.out.print(format.format(calendar.getTime()));

我想这个例子看了我如下的操作以后,大家都会有困惑的:以上代码最后输出的是2018-05-31,如果你理解了之前讲的,这个结果是没有问题的。但是,如果我把这行:System.out.println(calendar.getTime()); //此处是5.31 注释掉,大家可以试一下,最后的输出结果是2018-07-01。
为什么?这个留给大家作为思考题,因为需要自己跟代码才有印象,总之这里的结果如同执行了——
calendar.add(Calendar.DATE, calendar.getActualMaximum(Calendar.DATE));—— “add”方法,而不是“set”方法,因为结果就是在5.31的基础上加上了31天,正好是7.1。

困惑吧,实话说我都没有信息继续深究了,因为太凌乱了,所以,最好就是不要这样写。即不夹杂“归零”操作,也不在set方法中使用这句代码calendar.getActualMaximum(Calendar.DATE),calendar.getActualMaximum()方法就是获得当前月的最大天数,就只是这么用就好了。

  1. 这里还要提到的一个Tip就是DateFormat是线程不安全的,也就是说如果两个线程同时操作最初代码片段中的最后两句话,结果会出现意想不到的事情。

那么,既然Calendar有这样那样的问题,而且时不时会出现凌乱的代码——也可以看出这是JDK最初设计上的一些瑕疵——那么JDK对这部分有没有升级呢?答案当然是肯定的。下面我就介绍一下Java8针对Calendar实现的一个完全的修改。

Java8中引入了LocalDate、LocalTime、Instant、Duration和Period,这也是Oracle在原生的Java API中为引入对日期和时间的高质量的支持整合第三方日期和时间库Joda-Time的基础上提出的。它们都存在于java.time包下:

LocalDate localDate = LocalDate.of(2018, 2, 6);
int year = localDate.getYear();
Month month = localDate.getMonth();
int day = localDate.getDayOfMonth();
DayOfWeek dow = localDate.getDayOfWeek();
int len = localDate.lengthOfMonth();
boolean bool = localDate.isLeapYear();
LocalDate today = LocalDate.now();

System.out.println(year); // 2018
System.out.println(month); // FEBRUARY
System.out.println(day); // 6
System.out.println(dow); // TUESDAY
System.out.println(len); // 28
System.out.println(bool); // false
System.out.println(today); // 2018-02-06

是不是一目了然呢,或许都不用做过多的解释,你就能获取你想要的日期的某一个部分了。而且,最后一个用LocalDate.now()直接获取的是格式化好的日期格式,而不是看起来有点凌乱的这种格式“Sat Feb 10 06:38:55 CST 2018”,是不是很优雅呢。(最后一个是判断闰年,提醒大家,不要自己判断闰年,但是测试的时候一定要考虑到这个规则:能被4和400整除的是闰年,能被100整除的不是闰年)。

同样的新的日期时间JDK也提供了可读性强的枚举类型来实现如上的代码,比如:

int year_value = localDate.get(ChronoField.YEAR);
int month_value = localDate.get(ChronoField.MONTH_OF_YEAR);
int day_value = localDate.get(ChronoField.DAY_OF_MONTH);

System.out.println(year_value);    // 2018
System.out.println(month_value);    // 2
System.out.println(day_value);    // 6

/* * YEAR( * "Year", * ChronoUnit.YEARS, * ChronoUnit.FOREVER, * ValueRange * .of(-999999999L, * 999999999L), * "year" */

ChronoField实现了TemporalField接口,如果深入到底层代码你会发现我在最后贴出的注释样的源代码——列出了取值范围——等等,大家有兴趣可以参考。

LocalTime也是一样,可以通过getHour()、getMinute()和getSecond()方法获取小时、分钟和秒数。

上面提到了DateFormat在多线程的环境下会出现意想不到的结果,新的JDK也给我们提供了新的选择——DateTimeFormatter,所有的DateTimeFormatter实例都是线程安全的,因此我们可以用单例模式创建格式器实例,然后共享它。

LocalDate localDate = LocalDate.of(2018, 2, 6);
String str1 = localDate.format(DateTimeFormatter.BASIC_ISO_DATE);
String str2 = localDate.format(DateTimeFormatter.ISO_LOCAL_DATE);

LocalDate date1 = LocalDate.parse("20180206", DateTimeFormatter.BASIC_ISO_DATE);
LocalDate date2 = LocalDate.parse("2018-02-06", DateTimeFormatter.ISO_LOCAL_DATE);

System.out.println(str1); //20180206
System.out.println(str2); //2018-02-06

System.out.println(date1); 
//2018-02-06 ?不知道为什么这句话打印的不是期望的20180206,大家可以帮我看看,我也会在后续的博客中更新调查结果。
System.out.println(date2); //2018-02-06

正如代码显示的可以使用format方法按照DateTimeFormatter提供的静态成员变量取值进行想要的日期格式化,使用parse获取期望格式的LocalDate对象。

最后,介绍一下对日期和时间的操纵,也是对开篇提到的那段凌乱代码的一个交代。新的JDK提供了对日子和月份加减的优化处理,可读性和简洁性非常棒。

LocalDate localDate = LocalDate.of(2018, 2, 6);
LocalDate localDate1 = localDate.withYear(2019); //年份修改为2019
LocalDate localDate2 = localDate1.withDayOfMonth(25); //日改为25
LocalDate localDate3 = localDate2.with(ChronoField.MONTH_OF_YEAR, 9); //月份改为9

LocalDate localDate4 = localDate3.plusWeeks(1); //此时的日期是2019-09-25,在此基础上增加一周是2019-10-02
LocalDate localDate5 = localDate4.minusYears(3); //减去三年 2016-10-02
LocalDate localDate6 = localDate5.plus(6, ChronoUnit.MONTHS); //加上六个月2017-04-02

/* 使用TemporalAdjuster进行更复杂的日期调整 */
//获取以2017-04-02为基准,第一个符合指定星期几要求的日期,2017-04-02就是星期日,程序会直接返回该对象
LocalDate localDate7 = localDate6.with(TemporalAdjusters.nextOrSame(DayOfWeek.SUNDAY)); 
//获取2017-04-02所处月份的最后一天,同步取值还有lastDayOfNextMonth/firstDayOfMonth/firstDayOfNextMonth,等等
LocalDate localDate8 = localDate7.with(TemporalAdjusters.lastDayOfMonth()); 


System.out.println(localDate); //2018-02-06
System.out.println(localDate1); //2019-02-06
System.out.println(localDate2); //2019-02-25
System.out.println(localDate3); //2019-09-25
System.out.println(localDate4); //2019-10-02
System.out.println(localDate5); //2019-10-02
System.out.println(localDate6); //2017-04-02
System.out.println(localDate7); //2017-04-02
System.out.println(localDate8); //2017-04-30

最后的最后,再唠叨两句:
首先,新的JDK处理日期和时间的方式是在JDK8的前提下支持的,如果你的代码还是JDK7或者以下,那么你只能小心的使用Calendar了;
其次,这里针对新的日期和时间处理方式介绍的还不够详细,比如JDK8对日期和时间的处理同时还支持处理不同的时区和历法、利用和UTC/格林尼治时间的固定偏差计算时区以及使用别的日历系统,类似伊斯兰教日历这种复杂的日历。我准备再单独开一篇博客专门介绍,并且提供几个成熟且常用的工具类方法,这次就写到这里了,还要去加班 :)
最后,真的希望光大的程序员小伙伴看看英文,因为再读源码的时候你真的可以省去很多时间,同时也会增加你的耐心,因为对英文头大的同学会看不下去。同时,对于输出结果,比如很简单的Mar和May,英文的熟悉能够帮你迅速的解除类似的混淆,尤其是在焦急的解决bug的时候,我就曾经遇到过把Mar当成May对着输出结果发呆的小伙伴。

真心谢谢你能看到这里,其中的错漏之处还望海涵,我会继续努力的!

    原文作者:xinluqishi_fangye
    原文地址: https://blog.csdn.net/xinluqishi123/article/details/79248613
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。

相关文章