原来的Java的时间类Date、java.util.Calendar类都不太好,以语言无关方式格式化和解析日期或时间的 DateFormat 方法也有线程安全的问题
12.1 LocalDate、LocalTime、LocalDateTime、Instant、Duration 以及 Period
12.1.1 使用 LocalDate 和 LocalTime
LocalDate 类,该类的实例是一个不可变对象,它只提供了简单的日期,并不含当天的时间信息。另外,它也不附带任何与时区相关的信息。
LocalDate date = LocalDate.of(2017, 9, 21); // 2017-09-21
int year = date.getYear(); 2017
Month month = date.getMonth(); SEPTEMBER
int day = date.getDayOfMonth(); 21
DayOfWeek dow = date.getDayOfWeek(); THURSDAY
int len = date.lengthOfMonth(); 30 (days in September)
boolean leap = date.isLeapYear(); false (not a leap year)
还可以使用工厂方法 now 从系统时钟中获取当前的日期:LocalDate today = LocalDate.now();
还可以通过传递一个 TemporalField 参数给 get 方法访问同样的信息。
使用 TemporalField 读取 LocalDate 的值
int year = date.get(ChronoField.YEAR);
int month = date.get(ChronoField.MONTH_OF_YEAR);
int day = date.get(ChronoField.DAY_OF_MONTH);
或者
int year = date.getYear();
int month = date.getMonthValue();
int day = date.getDayOfMonth();
LocalDate date = LocalDate.parse("2017-09-21");
12.1.2 合并日期和时间
这个复合类名叫 LocalDateTime,是 LocalDate 和 LocalTime 的合体。它同时表示了日期和时间,但不带有时区信息,你可以直接创建,也可以通过合并日期和时间对象创建
LocalDateTime dt1 = LocalDateTime.of(2014, Month.SEPTEMBER, 21, 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);
LocalDate date1 = dt1.toLocalDate();
LocalTime time1 = dt1.toLocalTime();
12.1.3 机器的日期和时间格式
12.1.4 定义 Duration 或 Period
Duration 类的静态工厂方法 between 就是为这个目的而设计的。
Duration d1 = Duration.between(time1, time2);
Duration d1 = Duration.between(dateTime1, dateTime2);
Duration d2 = Duration.between(instant1, instant2);
由于 LocalDateTime 和 Instant 是为不同的目的而设计的,一个是为了便于人阅读使用,另一个是为了便于机器处理,因此不能将二者混用。如果你试图在这两类对象之间创建Duration,就会触发一个 DateTimeException 异常。
12.2 操纵、解析和格式化日期
如果你已经有一个 LocalDate 对象,想要创建它的一个修改版,最直接也最简单的方法是使用 withAttribute 方法。withAttribute 方法会创建对象的一个副本,并按照需要修改它的属性。
LocalDate date1 = LocalDate.of(2017, 9, 21);
LocalDate date2 = date1.withYear(2011);
LocalDate date3 = date2.withDayOfMonth(25);
LocalDate date4 = date3.with(ChronoField.MONTH_OF_YEAR, 2);
采用更通用的 with 方法能达到同样的目的,它接受的第一个参数是一个 TemporalField对象
加一段时间,或者减一段时间,plus
LocalDate date1 = LocalDate.of(2017, 9, 21);
LocalDate date2 = date1.plusWeeks(1);
LocalDate date3 = date2.minusYears(6);
LocalDate date4 = date3.plus(6, ChronoUnit.MONTHS);
12.2.1 使用 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
12.2.2 打印输出及解析日期–时间对象
新的java.time.format 包就是特别为这个目的而设计的
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
LocalDate date1 = LocalDate.parse("20140318", DateTimeFormatter.BASIC_ISO_DATE);
LocalDate date2 = LocalDate.parse("2014-03-18", DateTimeFormatter.ISO_LOCAL_DATE);
12.3 处理不同的时区和历法
12.3.1 使用时区
时区是按照一定的规则将区域划分成的标准时间相同的区间。在 ZoneRules 这个类中包含了 40 个这样的实例。ZoneId romeZone = ZoneId.of("Europe/Rome");
12.3.3 使用别的日历系统
LocalDate date = LocalDate.of(2014, Month.MARCH, 18);
JapaneseDate japaneseDate = JapaneseDate.from(date);
12.4 小结
- Java 8 之前老版的 java.util.Date 类以及其他用于建模日期和时间的类有很多不一致及设计上的缺陷,包括易变性以及糟糕的偏移值、默认值和命名。
- 新版的日期和时间 API 中,日期–时间对象是不可变的。
- 新的 API 提供了两种不同的时间表示方式,有效地区分了运行时人和机器的不同需求。
- 你可以用绝对或者相对的方式操纵日期和时间,操作的结果总是返回一个新的实例,老的日期–时间对象不会发生变化。
- TemporalAdjuster 让你能够用更精细的方式操纵日期,不再局限于一次只能改变它的一个值,并且你还可按照需求定义自己的日期转换器。
- 你现在可以按照特定的格式需求,定义自己的格式器,打印输出或者解析日期–时间对象。这些格式器可以通过模板创建,也可以自己编程创建,并且它们都是线程安全的。
- 你可以用相对于某个地区/位置的方式,或者以与 UTC/格林尼治时间的绝对偏差的方式表示时区,并将其应用到日期–时间对象上,对其进行本地化。
- 你现在可以使用不同于 ISO-8601 标准系统的其他日历系统了。