Java8学习笔记之新日期API

Java8对日期API做了改进，提供了许多好用的方法和接口。
首先，最基本也最重要的3个对象：

• LocalDate：日期对象
• LocalTime：时间对象
• LocalDateTime：日期时间对象，是LocalDate和LocalTime的合集

对象的创建

以上这3个对象，都各自有3种创建方式。

1. 通过.now()得到当前日期时间对象。
2. 通过.of()直接指定年月日，时分秒。
3. LocalDate和LocalTime通过解析字符串创建，LocalDateTime可以通过前2个对象创建。

LocalDate对象3种创建方式以及相关方法示例

@Test
public void localDate() {
    LocalDate date = LocalDate.of(2017, 5, 3);
    int year = date.getYear();// 2017
    Month month = date.getMonth();// MAY
    int day = date.getDayOfMonth();// 3
    DayOfWeek dow = date.getDayOfWeek();// Wednesday
    int len = date.lengthOfMonth();// 31
    boolean leap = date.isLeapYear();// false
    System.out.println(year + ", " + month + ", " + day + ", " + dow + ", " + len + ", " + leap);

    LocalDate date2 = LocalDate.now();
    int year2 = date2.get(ChronoField.YEAR);// 2017
    int month2 = date2.get(ChronoField.MONTH_OF_YEAR);// 5
    int day2 = date2.get(ChronoField.DAY_OF_MONTH);// 3
    int dow2 = date2.get(ChronoField.DAY_OF_WEEK);// 3
    System.out.println(year2 + ", " + month2 + ", " + day2 + ", " + dow2);

    // 写2017-3-18会报错，DateTimeParseException异常，可以传一个DateTimeFormatter自定义格式
    LocalDate date3 = LocalDate.parse("2017-03-18");
    int year3 = date3.get(ChronoField.YEAR);
    int month3 = date3.get(ChronoField.MONTH_OF_YEAR);
    int day3 = date3.get(ChronoField.DAY_OF_MONTH);
    int dow3 = date3.get(ChronoField.DAY_OF_WEEK);
    System.out.println(year3 + ", " + month3 + ", " + day3 + ", " + dow3);
}

LocalTime对象3种创建方式以及相关方法示例

@Test
public void localTime() {
    LocalTime time = LocalTime.of(11, 06, 23);
    int hour = time.getHour();
    int minute = time.getMinute();
    int second = time.getSecond();
    System.out.println(hour + ":" + minute + ":" + second);

    LocalTime time2 = LocalTime.now();
    int hour2 = time2.get(ChronoField.HOUR_OF_DAY);
    int minute2 = time2.get(ChronoField.MINUTE_OF_HOUR);
    int second2 = time2.get(ChronoField.SECOND_OF_MINUTE);
    System.out.println(hour2 + ":" + minute2 + ":" + second2);

    // 写13:5:43会报错，DateTimeParseException异常，可以传一个DateTimeFormatter自定义格式
    LocalTime time3 = LocalTime.parse("13:05:43");
    int hour3 = time3.get(ChronoField.HOUR_OF_DAY);
    int minute3 = time3.get(ChronoField.MINUTE_OF_HOUR);
    int second3 = time3.get(ChronoField.SECOND_OF_MINUTE);
    System.out.println(hour3 + ":" + minute3 + ":" + second3);
}

LocalDateTime对象3种创建方式以及相关方法示例

@Test
public void localDateTime() {
    LocalDate date = LocalDate.now();
    LocalTime time = LocalTime.now();

    // 创建LocalDateTime
    LocalDateTime dateTime = LocalDateTime.of(2017, 5, 3, 11, 53, 23);
    LocalDateTime dateTime2 = LocalDateTime.of(date, time);
    LocalDateTime dateTime3 = date.atTime(11, 53, 23);
    LocalDateTime dateTime4 = date.atTime(time);
    LocalDateTime dateTime6 = time.atDate(date);

    // 转化
    LocalDate date2 = dateTime2.toLocalDate();
    LocalTime time2 = dateTime2.toLocalTime();
}

时间间隔对象

• Duration：可以传2个localTime对象，localDateTime对象或者Instant对象
• Period：用年，月，日建模，可以传2个localDate对象

    @Test
    public void between() {
//        Duration d1 = Duration.between(time1, time2);
//        Duration d2 = Duration.between(dateTime1, dateTime2);
//        Duration d3 = Duration.between(instant1, instant2);
        Period tenDays = Period.between(LocalDate.of(2014, 3, 8), LocalDate.of(2014, 3, 18));

        Duration threeMinutes = Duration.ofMinutes(3);
        Duration threeMinutes2 = Duration.of(3, ChronoUnit.MINUTES);
        Period tenDays2 = Period.ofDays(10);
        Period threeWeeks = Period.ofWeeks(3);
        Period twoYearsSixMonthsOneDay = Period.of(2, 6, 1);
    }

修改日期时间对象

直接使用.with()来修改对应的年月日时分秒属性

@Test
public void editDateTime() {
    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
}

在现有对象上做相对修改

@Test
public void editDateTime() {
    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
}

自定义修改日期

如果要对日期做一些复杂的修改，那么可以通过TemporalAdjusters接口实现复杂逻辑。

@Test
public void adjust() {
    LocalDate date1 = LocalDate.of(2017, 5, 8);// 2017-05-08
    LocalDate date2 = date1.with(TemporalAdjusters.nextOrSame(DayOfWeek.SUNDAY));// 2017-05-14
    LocalDate date3 = date2.with(TemporalAdjusters.lastDayOfMonth());// 2017-05-31
}

jdk为我们实现了一些常用的方法：

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

自定义格式化输出日期

新版本，我们拥有一个线程安全的类：DateTimeFormatter
来看代码

@Test
public void formatPrint() {
    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);

    // 自定义格式
    DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");
    String formattedDate = date.format(formatter);
    System.out.println(formattedDate);// 18/03/2014
    LocalDate date3 = LocalDate.parse(formattedDate, formatter);

    // 带时区的日期(本地化)
    DateTimeFormatter italianFormatter = DateTimeFormatter.ofPattern("d. MMMM yyyy", Locale.ITALIAN);
    String formattedDate2 = date.format(italianFormatter); // 18. marzo 2014
    LocalDate date4 = LocalDate.parse(formattedDate2, italianFormatter);
}