日期格式化的跨年问题
通常格式化日期时，都是使用的YYYY/MM/dd来格式化日期，但是在遇到跨年日期时，就会遇到很神奇的现象，如下：
1
2
3
4
5
6
7
8
9
10
11
| final Calendar calendar = Calendar.getInstance();
// 2020-12-26
calendar.set(2020, 11, 26);
final Date date1226 = calendar.getTime();
// 2020-12-27
calendar.set(2020, 11, 27);
final Date date1227 = calendar.getTime();
// YYYY
final DateFormat Y = new SimpleDateFormat("YYYY/MM/dd");
System.out.println("2020-12-26用YYYY/MM/dd表示:" + Y.format(date1226));
System.out.println("2020-12-27用YYYY/MM/dd表示:" + Y.format(date1227));
|
上述代码输出如下：
1
2
| 2020-12-26用YYYY/MM/dd表示:2020/12/26
2020-12-27用YYYY/MM/dd表示:2021/12/27
|
可以看到，只是一天之差，格式化后却相差了整整一年！这是因为YYYY是基于周最后一天所在年份来格式化年份的，周日是每周第一天。而2020-12-27这天是周日，这一周最后一天属于2021年，于是就发生了上述的神奇现象。下面是官方文档：
Java’s DateTimeFormatter pattern “YYYY” gives you the week-based-year, (by default, ISO-8601 standard) the year of the Thursday of that week.
所以，想要得到正确的结果，需要使用yyyy来替代YYYY，如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
| final Calendar calendar = Calendar.getInstance();
// 2020-12-26
calendar.set(2020, 11, 26);
final Date date1226 = calendar.getTime();
// 2020-12-27
calendar.set(2020, 11, 27);
final Date date1227 = calendar.getTime();
// YYYY
final DateFormat Y = new SimpleDateFormat("YYYY/MM/dd");
System.out.println("2020-12-26用YYYY/MM/dd表示:" + Y.format(date1226));
System.out.println("2020-12-27用YYYY/MM/dd表示:" + Y.format(date1227));
// yyyy
final DateFormat y = new SimpleDateFormat("yyyy/MM/dd");
System.out.println("2020-12-26用yyyy/MM/dd表示:" + y.format(date1226));
System.out.println("2020-12-27用yyyy/MM/dd表示:" + y.format(date1227));
|
结果如下：
1
2
3
4
| 2020-12-26用YYYY/MM/dd表示:2020/12/26
2020-12-27用YYYY/MM/dd表示:2021/12/27
2020-12-26用yyyy/MM/dd表示:2020/12/26
2020-12-27用yyyy/MM/dd表示:2020/12/27
|
日期格式化异常
使用新的日期API格式化日期时发生如下异常：
1
2
3
4
5
| java.time.DateTimeException: Field DayOfYear cannot be printed as the value 320 exceeds the maximum print width of 2
at java.time.format.DateTimeFormatterBuilder$NumberPrinterParser.format(DateTimeFormatterBuilder.java:2548)
at java.time.format.DateTimeFormatterBuilder$CompositePrinterParser.format(DateTimeFormatterBuilder.java:2179)
at java.time.format.DateTimeFormatter.formatTo(DateTimeFormatter.java:1746)
at java.time.format.DateTimeFormatter.format(DateTimeFormatter.java:1720)
|
这个跟日期格式有关，这里我使用的是YYMMDD来格式化日期：
1
| String currentDate = DateTimeFormatter.ofPattern("yyMMDD").format(LocalDateTime.now())
|
如果当前日期是从四月的10号（闰年是四月9号）即之后的日期，就会遇到上述的异常。原因是格式化字符串中的D指的是一年的第几天，而这里用了两个D，表明天数是两位数（不足两位数会补前缀0）。如果使用了前文提及的日期，也就是说当前属于一年的100天以上的天数（即天数是3位数），与格式化指定的两位数冲突，因此抛出异常。
这里想要的是每个月的天数，应当使用d，而不是大写的D。其实关于这类格式化字符需要注意大小写的问题，比如y和Y的含义也是不一样的。
JDK 8新的日期和时间API
新版本的日期时间API主要分为：LocalDate、LocalTime、LocalDateTime、ZonedDateTime四个类。
其中关系如下：
1
2
3
4
5
| LocalDateTime = LocalDate + LocalTime
ZonedDateTime = LocalDateTime + ZoneOffset + ZoneId
// ZoneId是时区id
// ZoneOffset继承自ZoneId，表示时区对应的时间偏移量，比如东八区对比零时区的偏移量是+08:00，即快了八个小时
|
GMT，即格林尼治标准时间，也就是世界时。GMT的正午是指当太阳横穿格林尼治子午线（本初子午线）时的时间。但由于地球自转不均匀不规则，导致GMT不精确，现在已经不再作为世界标准时间使用。
UTC，即协调世界时。UTC是以原子时秒长为基础，在时刻上尽量接近于GMT的一种时间计量系统。为确保UTC与GMT相差不会超过0.9秒，在有需要的情况下会在UTC内加上正或负闰秒。UTC现在作为世界标准时间使用。
计算机中的UNIX时间戳，是以GMT/UTC时间「1970-01-01T00:00:00」为起点，到具体时间的秒数，不考虑闰秒。这么做当然是为了简化计算机对时间操作的复杂度。Java调试时经常使用到的System.currentTimeMillis()就是获取该时间戳对应的时间毫秒值。
本地日期API
在不需要处理时区时使用：LocalDate、LocalTime、LocalDateTime，也就是获取系统默认时区的日期时间。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
| // 本地日期
LocalDate localDate = LocalDate.now();
System.out.println(localDate); // 2021-05-12
System.out.println(localDate.getYear()); // 2021
System.out.println(localDate.getMonthValue()); // 5
System.out.println(localDate.getDayOfMonth()); // 12
System.out.println(localDate.withYear(2017).withMonth(7).withDayOfMonth(1)); // 2017-07-01
// 本地时间
LocalTime localTime = LocalTime.now();
System.out.println(localTime); // 00:13:19.738
System.out.println(localTime.getHour()); // 0
System.out.println(localTime.plusHours(1)); // 01:13:19.738
// 本地日期时间
LocalDateTime localDateTime = LocalDateTime.now();
System.out.println(localDateTime); // 2021-05-12T00:13:19.738
System.out.println(localDateTime.toLocalDate()); // 2021-05-12
System.out.println(localDateTime.toLocalTime()); // 00:13:19.738
System.out.println(localDateTime.getHour()); // 0
// 指定日期
System.out.println(LocalDate.of(2017, 7, 1)); // 2017-07-01
System.out.println(LocalTime.of(0, 0)); // 00:00
// 解析日期字符串
System.out.println(LocalTime.parse("20:15:30")); // 20:15:30
|
时区日期API
时区日期类是ZonedDateTime：
1
2
3
4
5
6
7
8
9
10
| // 时区日期时间
ZonedDateTime zonedDateTime = ZonedDateTime.now();
System.out.println(zonedDateTime); // 2021-05-12T08:22:21.404+08:00[Asia/Shanghai]
System.out.println(zonedDateTime.getYear()); // 2021
System.out.println(zonedDateTime.getOffset()); // +08:00
System.out.println(zonedDateTime.getZone()); // Asia/Shanghai
System.out.println(ZoneId.systemDefault()); // Asia/Shanghai
System.out.println(ZoneId.SHORT_IDS.get("CTT"));// Asia/Shanghai
|
日期和时区的转换
可以给本地日期加上时区信息，以此获取对应的时区日期。
时区日期在转换时区时可以分为两种，一种是本地日期不变，单纯改变时区；另一种是将一个时区日期转换为其他时区的日期，此时不仅会改变时区，还会改变本地日期。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
| LocalDate localDate = LocalDate.parse("2021-01-05");
// LocalDate转换为LocalDateTime
LocalDateTime localDateTime = LocalDateTime.of(localDate, LocalTime.MIN);
// 指定为东八区时间
ZonedDateTime zonedDateTime = localDateTime.atZone(ZoneId.of("UTC+08:00"));
System.out.println(localDate); // 2021-01-05
System.out.println(localDateTime); // 2021-01-05T00:00
System.out.println(zonedDateTime); // 2021-01-05T00:00+08:00[UTC+08:00]
// 日期格式化
// 2021-01-05T00:00:00.000Z
System.out.println(localDateTime.format(DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'")));
System.out.println(zonedDateTime.toLocalDateTime()); // 2021-01-05T00:00
System.out.println(zonedDateTime.toOffsetDateTime()); // 2021-01-05T00:00+08:00
System.out.println(zonedDateTime.getOffset()); // +08:00
System.out.println(zonedDateTime.getZone()); // UTC+08:00
// 换算为零时区时间
ZonedDateTime withZoneSameInstant = zonedDateTime.withZoneSameInstant(ZoneId.of("Z"));
// 单纯修改时区信息
ZonedDateTime withZoneSameLocal = zonedDateTime.withZoneSameLocal(ZoneId.of("Z"));
System.out.println(withZoneSameInstant.toLocalDateTime()); // 2021-01-04T16:00
System.out.println(withZoneSameLocal.toLocalDateTime()); // 2021-01-05T00:00
|
java.sql包下的类和新的日期类的转换：
1
2
3
4
5
6
7
8
9
10
11
12
13
| // 2021-05-01
LocalDate localDate = LocalDate.of(2021, 5, 1);
// 2021-05-01
final Date sqlDate = Date.valueOf(localDate);
// 2021-05-01
localDate = sqlDate.toLocalDate();
// 2021-05-01T00:16:44.032
LocalDateTime localDateTime = LocalDateTime.of(localDate, LocalTime.now());
// 2021-05-01 00:16:44.032
final Timestamp timestamp = Timestamp.valueOf(localDateTime);
// 2021-05-01T00:16:44.032
localDateTime = timestamp.toLocalDateTime();
|
获取月份、年份的最后一天
JDK 8提供了TemporalAdjusters工具类来实现调整时间的功能：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| // 2021-07-27
final LocalDate localDate = LocalDate.now();
// 2021-07-01
System.out.println(localDate.with(TemporalAdjusters.firstDayOfMonth()));
// 2021-01-01
System.out.println(localDate.with(TemporalAdjusters.firstDayOfYear()));
// 2021-08-01
System.out.println(localDate.with(TemporalAdjusters.firstDayOfNextMonth()));
// 2022-01-01
System.out.println(localDate.with(TemporalAdjusters.firstDayOfNextYear()));
// 当月第一个周一： 2021-07-05
System.out.println(localDate.with(TemporalAdjusters.firstInMonth(DayOfWeek.MONDAY)));
// 当月最后一个周五： 2021-07-30
System.out.println(localDate.with(TemporalAdjusters.lastInMonth(DayOfWeek.FRIDAY)));
|
比较两个日期
1
2
3
4
5
6
7
8
9
10
11
12
| final LocalDate date1 = LocalDate.of(2021, 5, 1);
final LocalDate date2 = LocalDate.of(2021, 5, 2);
final LocalDate date3 = LocalDate.of(2021, 6, 2);
// 1
System.out.println(Period.between(date1, date2).getDays());
// 1
System.out.println(Period.between(date1, date3).getDays());
// 1
System.out.println(date1.until(date2, ChronoUnit.DAYS));
// 32
System.out.println(date1.until(date3, ChronoUnit.DAYS));
|
Period只能用来比较两个日期之间的相对时间差，比如单纯比较年份、月份或者天数之间的相对差额，在比较的时候不会计算其他的时间单位，因此在比较2021-05-01和2021-06-02的天数差是1天，而不是32天。
如果想要比较完整的天数差，需要用until()方法，要用日期更小的那个来调用这个方法，否则会得到负数结果。另外这个until()方法有两个，要使用带有时间单位的那个方法，如果不指定时间单位，返回值是Period，这样就变成Period一样的用法了。
参考链接
警告
本文最后更新于 October 11, 2021，文中内容可能已过时，请谨慎使用。
