java8新的日期和时间API-蒲公英云

LocalDate 、 LocalTime 、 Instant 、 Duration 以及 Period

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();
LocalDate today = LocalDate.now();

TemporalField

TemporalField 是一个接口，它定义了如何访问 temporal 对象某个字段的值，ChronoField 枚举实现了这一接口，所以你可以很
方便地使用 get 方法得到枚举元素的值

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

LocalDate 和 LocalTime 都可以通过解析代表它们的字符串创建。使用静态方法 parse ，你可以实现这一目的：

LocalDate date = LocalDate.parse("2014-03-18");
LocalTime time = LocalTime.parse("13:45:20");

你可以向 parse 方法传递一个 DateTimeFormatter 。

LocalDateTime：

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);
LocalDate date1 = dt1.toLocalDate();
LocalTime time1 = dt1.toLocalTime();

Instant :这也是新的 java.time.Instant 类对时间建模的方式，基本上它是以Unix元年时间（传统的设定为UTC时区1970年1月1日午夜时分）开始所经历的秒数进行计算。

Duration:前为止，你看到的所有类都实现了 Temporal 接口， Temporal 接口定义了如何读取和操纵为时间建模的对象的值,

你可以创建两个 LocalTimes 对象、两个 LocalDateTimes:

Duration d1 = Duration.between(time1, time2);
Duration d1 = Duration.between(dateTime1, dateTime2);
Duration d2 = Duration.between(instant1, instant2);

如果你需要以年、月或者日的方式对多个时间单位建模，可以使用 Period 类。使用该类的工厂方法 between ，你可以使用得到两个 LocalDate 之间的时长，如下所示：

Period tenDays = Period.between(LocalDate.of(2014, 3, 8),
LocalDate.of(2014, 3, 18));
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);

Duration 类和 Period 类共享了很多相似的方法:

方 法 名  是否是静态方法  方法描述
between  是  创建两个时间点之间的 interval
from  是  由一个临时时间点创建 interval
of  是  由它的组成部分创建 interval的实例
parse  是  由字符串创建 interval 的实例
addTo  否  创建该 interval 的副本，并将其叠加到某个指定的 temporal 对象
get  否  读取该 interval 的状态
isNegative  否  检查该 interval 是否为负值，不包含零
isZero  否  检查该 interval 的时长是否为零
minus  否  通过减去一定的时间创建该 interval 的副本
multipliedBy  否  将 interval 的值乘以某个标量创建该 interval 的副本
negated  否  以忽略某个时长的方式创建该 interval 的副本
plus  否  以增加某个指定的时长的方式创建该 interval 的副本
subtractFrom  否  从指定的 temporal 对象中减去该 interval

操纵、解析和格式化日期

LocalDate date1 = LocalDate.of(2014, 3, 18);
LocalDate date2 = date1.withYear(2011);
LocalDate date3 = date2.withDayOfMonth(25);
LocalDate date4 = date3.with(ChronoField.MONTH_OF_YEAR, 9);
LocalDate date1 = LocalDate.of(2014, 3, 18);
LocalDate date2 = date1.plusWeeks(1);
LocalDate date3 = date2.minusYears(3);
LocalDate date4 = date3.plus(6, ChronoUnit.MONTHS);

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

from  是  依据传入的 Temporal 对象创建对象实例
now  是  依据系统时钟创建 Temporal 对象
of  是  由 Temporal 对象的某个部分创建该对象的实例
parse  是  由字符串创建 Temporal 对象的实例
atOffset  否  将 Temporal 对象和某个时区偏移相结合
atZone  否  将 Temporal 对象和某个时区相结合
format  否  使用某个指定的格式器将 Temporal 对象转换为字符串（ Instant 类不提供该方法）
get  否  读取 Temporal 对象的某一部分的值
minus  否 创建 Temporal 对象的一个副本，通过将当前 Temporal 对象的值减去一定的时长创建该副本
plus  否 创建 Temporal 对象的一个副本，通过将当前 Temporal 对象的值加上一定的时长创建该副本
with  否  以该 Temporal 对象为模板，对某些状态进行修改创建该对象的副本

TemporalAdjuster

import static java.time.temporal.TemporalAdjusters.*;
LocalDate date1 = LocalDate.of(2014, 3, 18);
LocalDate date2 = date1.with(nextOrSame(DayOfWeek.SUNDAY));
LocalDate date3 = date2.with(lastDayOfMonth());

TemporalAdjuster 类中的工厂方法

dayOfWeekInMonth  创建一个新的日期，它的值为同一个月中每一周的第几天
firstDayOfMonth  创建一个新的日期，它的值为当月的第一天
firstDayOfNextMonth  创建一个新的日期，它的值为下月的第一天
firstDayOfNextYear  创建一个新的日期，它的值为明年的第一天
firstDayOfYear  创建一个新的日期，它的值为当年的第一天
firstInMonth  创建一个新的日期，它的值为同一个月中，第一个符合星期几要求的值
lastDayOfMonth  创建一个新的日期，它的值为当月的最后一天
lastDayOfNextMonth  创建一个新的日期，它的值为下月的最后一天
lastDayOfNextYear  创建一个新的日期，它的值为明年的最后一天
lastDayOfYear  创建一个新的日期，它的值为今年的最后一天
lastInMonth  创建一个新的日期，它的值为同一个月中，最后一个符合星期几要求的值
next/previous 创建一个新的日期，并将其值设定为日期调整后或者调整前，第一个符合指定星期几要求的日期
nextOrSame/previousOrSame 创建一个新的日期，并将其值设定为日期调整后或者调整前，第一个符合指定星
期几要求的日期，如果该日期已经符合要求，直接返回该对象

格式化日期和解析日期

LocalDate date = LocalDate.of(2014, 3, 18);
String s1 = date.format(DateTimeFormatter.BASIC_ISO_DATE);
String s2 = date.format(DateTimeFormatter.ISO_LOCAL_DATE);
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);

处理不同的时区：

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);