第 12 章 新的日期和时间API

旧时间日期 API 表

Java8 时间日期 API 表

这些新类都位于 java.time 包下。提供了统一风格的 API。
下表所有类都实现了 Temporal 接口。
如：获取年、月、日、周、时、分、秒等方法。

12.1 LocalDate、LocalTime、Instant、Duration 以及 Period

12.1.1 使用 LocalDate 和 LocalTime

代码清单12-1 创建一个LocalDate对象并读取其值

LocalDate date = LocalDate.of(2014, 3, 18); 
int year = date.getYear(); 
Month month = date.getMonth();
int day = date.getDayOfMonth(); 
DayOfWeek dow = date.getDayOfWeek(); 
int len = date.lengthOfMonth();
boolean leap = date.isLeapYear();
1
2
3
4
5
6
7

使用工厂方法从系统时钟中获取当前的日期

LocalDate today = LocalDate.now();
1

代码清单12-2 使用TemporalField读取LocalDate的值

2022年07月04日

int year = date.get(ChronoField.YEAR); 
int month = date.get(ChronoField.MONTH_OF_YEAR); 
int day = date.get(ChronoField.DAY_OF_MONTH);
1
2
3

代码清单12-3 创建LocalTime并读取其值

LocalTime time = LocalTime.of(13, 45, 20); 
int hour = time.getHour(); 
int minute = time.getMinute(); 
int second = time.getSecond();
1
2
3
4

LocalDate 和 LocalTime 都可以通过静态方法 parse 解析代表它们的字符串创建。

LocalDate date = LocalDate.parse("2022-07-04"); 
LocalTime time = LocalTime.parse("20:53:12");
1
2

12.1.2 合并日期和时间

代码清单12-4 直接创建LocalDateTime对象，或者通过合并日期和时间的方式创建

// 2014-03-18T13:45:20 
LocalDateTime dt1 = LocalDateTime.of(2014, Month.MARCH, 18, 13, 45, 20); 
LocalDateTime dt2 = LocalDateTime.of(date, time); 
LocalDateTime dt3 = date.atTime(13, 45, 20); 
LocalDateTime dt4 = date.atTime(time); 
LocalDateTime dt5 = time.atDate(date);
1
2
3
4
5
6

从 LocalDateTime中 提取 LocalDate 或者 LocalTime 组件：

LocalDate date1 = dt1.toLocalDate(); 
LocalTime time1 = dt1.toLocalTime();
1
2

12.1.3 机器的日期和时间格式

使用 秒 和 纳秒 创建实例。以下都是：3秒之后。

Instant.ofEpochSecond(3);		// 3秒之后
Instant.ofEpochSecond(3, 0);	// 3秒之后 + 0纳秒
Instant.ofEpochSecond(2, 1_000_000_000); // 2秒之后 + 10亿纳秒(1秒)
Instant.ofEpochSecond(4, -1_000_000_000); // 4秒之后 - 10亿纳秒(1秒)
1
2
3
4

12.1.4 定义 Duration 或 Period

代码清单12-5 创建Duration和Period对象

分别用于表示时间或日期之间的时长。

Duration threeMinutes = Duration.ofMinutes(3); 
Duration threeMinutes = Duration.of(3, ChronoUnit.MINUTES); 

Period tenDays = Period.ofDays(10); 
Period threeWeeks = Period.ofWeeks(3); 
Period twoYearsSixMonthsOneDay = Period.of(2, 6, 1);
1
2
3
4
5
6

表12-1 日期-时间类中表示时间间隔的通用方法

Duration类和Period类共享了很多相似的方法，参见表12-1所示。

12.2 操纵、解析和格式化日期

代码清单12-6 以比较直观的方式操纵LocalDate的属性

LocalDate date1 = LocalDate.of(2014, 3, 18); // 2014-03-18
LocalDate date2 = date1.withYear(2011); // 2011-03-18
LocalDate date3 = date2.withDayOfMonth(25); // 2011-03-25
LocalDate date4 = date3.with(ChronoField.MONTH_OF_YEAR, 9); // 2011-09-25
1
2
3
4

代码清单12-7 以相对方式修改LocalDate对象的属性

LocalDate date1 = LocalDate.of(2014, 3, 18); // 2014-03-18
LocalDate date2 = date1.plusWeeks(1);  // 2014-03-25
LocalDate date3 = date2.minusYears(3);  // 2011-03-25
LocalDate date4 = date3.plus(6, ChronoUnit.MONTHS); // 2011-09-25
1
2
3
4

表12-2 表示时间点的日期时间类的通用方法

大概你已经猜到，像LocalDate、LocalTime、LocalDateTime以及Instant这样表示时
间点的日期时间类提供了大量通用的方法，表12-2对这些通用的方法进行了总结。

12.2.1 使用 TemporalAdjuster

代码清单12-8 使用预定义的TemporalAdjuster

import static java.time.temporal.TemporalAdjusters.*; 
LocalDate date1 = LocalDate.of(2014, 3, 18); // 2014-03-18
LocalDate date2 = date1.with(nextOrSame(DayOfWeek.SUNDAY)); // 2014-03-23
LocalDate date3 = date2.with(lastDayOfMonth()); // 2014-03-31
1
2
3
4

表12-3 TemporalAdjuster类中的工厂方法

表12-3提供了TemporalAdjuster中包含的工厂方法列表。

代码清单12-9 TemporalAdjuster接口

TemporalAdjuster 是一个 函数式接口

@FunctionalInterface 
public interface TemporalAdjuster { 
 Temporal adjustInto(Temporal temporal); 
}
1
2
3
4

12.2.2 打印输出及解析日期时间对象

java.time.format 这个包下都是时间格式化相关的内容 。最重要的比如：DateTimeFormatter

• 使用了两个不同的格式器生成了字符串

LocalDate date = LocalDate.of(2014, 3, 18);
String s1 = date.format(DateTimeFormatter.BASIC_ISO_DATE); // 20140318
String s2 = date.format(DateTimeFormatter.ISO_LOCAL_DATE); // 2014-03-18
1
2
3

• 以使用工厂方法parse达到重创该日期对象
  和老的java.util.DateFormat相比较，所有的DateTimeFormatter实例都是线程安全的。

LocalDate date1 = LocalDate.parse("20140318", DateTimeFormatter.BASIC_ISO_DATE); 
LocalDate date2 = LocalDate.parse("2014-03-18", DateTimeFormatter.ISO_LOCAL_DATE);
1
2

代码清单12-10 按照某个模式创建DateTimeFormatter

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");
LocalDate date1 = LocalDate.of(2014, 3, 18); 
String formattedDate = date1.format(formatter); 
LocalDate date2 = LocalDate.parse(formattedDate, formatter);
1
2
3
4

代码清单12-11 创建一个本地化的DateTimeFormatter

DateTimeFormatter italianFormatter = DateTimeFormatter.ofPattern("d. MMMM yyyy", Locale.ITALIAN); 
LocalDate date1 = LocalDate.of(2014, 3, 18); 
String formattedDate = date.format(italianFormatter); // 18. marzo 2014 
LocalDate date2 = LocalDate.parse(formattedDate, italianFormatter);
1
2
3
4

代码清单12-12 构造一个DateTimeFormatter

DateTimeFormatter italianFormatter = new DateTimeFormatterBuilder() 
 .appendText(ChronoField.DAY_OF_MONTH) 
 .appendLiteral(". ") 
 .appendText(ChronoField.MONTH_OF_YEAR) 
 .appendLiteral(" ") 
 .appendText(ChronoField.YEAR) 
 .parseCaseInsensitive() 
 .toFormatter(Locale.ITALIAN);
1
2
3
4
5
6
7
8

12.3 处理不同的时区和历法

代码清单12-13 为时间点添加时区信息

LocalDate date = LocalDate.of(2014, Month.MARCH, 18); 
ZonedDateTime zdt1 = date.atStartOfDay(romeZone); 
LocalDateTime dateTime = LocalDateTime.of(2014, Month.MARCH, 18, 13, 45); 
ZonedDateTime zdt2 = dateTime.atZone(romeZone); 
Instant instant = Instant.now(); 
ZonedDateTime zdt3 = instant.atZone(romeZone);
1
2
3
4
5
6

通过ZoneId，你还可以将LocalDateTime转换为Instant：

LocalDateTime dateTime = LocalDateTime.of(2014, Month.MARCH, 18, 13, 45); 
Instant instantFromDateTime = dateTime.toInstant(romeZone); 
1
2

你也可以通过反向的方式得到LocalDateTime对象：

Instant instant = Instant.now(); 
LocalDateTime timeFromInstant = LocalDateTime.ofInstant(instant, romeZone);
1
2

12.3.1 利用和 UTC/格林尼治时间的固定偏差计算时区

“纽约落后于伦敦5小时”。

ZoneOffset newYorkOffset = ZoneOffset.of("-05:00");
1

12.3.2 使用别的日历系统

略。。。

12.4 小结

• 这一章中，你应该掌握下面这些内容。

1. Java 8之前老版的java.util.Date类以及其他用于建模日期时间的类有很多不一致及设计上的缺陷，包括易变性以及糟糕的偏移值、默认值和命名。
2. 新版的日期和时间API中，日期-时间对象是不可变的。
3. 新的API提供了两种不同的时间表示方式，有效地区分了运行时人和机器的不同需求。
4. 你可以用绝对或者相对的方式操纵日期和时间，操作的结果总是返回一个新的实例，老的日期时间对象不会发生变化。
5. TemporalAdjuster让你能够用更精细的方式操纵日期，不再局限于一次只能改变它的一个值，并且你还可按照需求定义自己的日期转换器。
6. 你现在可以按照特定的格式需求，定义自己的格式器，打印输出或者解析日期时间对象。这些格式器可以通过模板创建，也可以自己编程创建，并且它们都是线程安全的。
7. 你可以用相对于某个地区/位置的方式，或者以与UTC/格林尼治时间的绝对偏差的方式表示时区，并将其应用到日期时间对象上，对其进行本地化。
8. 你现在可以使用不同于ISO-8601标准系统的其他日历系统了。

参考资料

笑虾 ：Java 学习笔记 - Java8的日期时间 LocalDateTime
笑虾 ：Java 学习笔记 - 时间日期常用案列