日期和时间API - 读《Java 8实战》

日期与时间

LocalDate

创建一个LocalDate对象并读取其值

// 根据年月日创建日期

LocalDate date1 = LocalDate.of(2014, 3, 18);

// 读取

System.out.println(date1.getYear()); // 2014

System.out.println(date1.getMonth()); // MARCH

System.out.println(date1.getMonth().getValue()); // 3

System.out.println(date1.getDayOfMonth()); // 18

System.out.println(date1.lengthOfMonth()); // 31

System.out.println(date1.isLeapYear()); // false

// 当前日期

LocalDate now = LocalDate.now();

System.out.println(now); // 2018-08-14

// 从日期对象中获取年月日

System.out.println(now.get(ChronoField.YEAR)); // 2018

System.out.println(now.get(ChronoField.MONTH_OF_YEAR)); // 8

System.out.println(now.get(ChronoField.DAY_OF_MONTH)); // 14

LocalTime

创建LocalTime并读取值

// 根据时分秒创建时间

LocalTime time1 = LocalTime.of(13, 45, 20);

System.out.println(time1.getHour()); // 13

System.out.println(time1.getMinute()); // 45

System.out.println(time1.getSecond()); // 20

// 通过日期或时间字符串创建日期或时间

LocalDate date2 = LocalDate.parse("2014-03-18");

LocalTime time2 = LocalTime.parse("13:45:20");

LocalDateTime

直接创建LocalDateTime对象或通过合并日期和时间的方式创建

// 直接创建日期时间

LocalDateTime lt1 = LocalDateTime.of(2014, Month.MARCH, 18, 13, 45, 20);

// 通过日期和时间创建

LocalDate date1 = LocalDate.of(2014, 3, 18);

LocalTime time1 = LocalTime.of(13, 45, 20);

LocalDateTime lt2 = LocalDateTime.of(date1, time1);

LocalDateTime lt3 = date1.atTime(13, 45, 20);

LocalDateTime lt4 = date1.atTime(time1);

LocalDateTime lt5 = time1.atDate(date1);

// 从日期时间中提取日期和时间

LocalDate date2 = lt1.toLocalDate();

LocalTime time2 = lt1.toLocalTime();

Instant

机器的日期和时间格式

// 获取当前时刻时间戳

System.out.println(Instant.now().toEpochMilli()); // 1534255959679

时间段

Duration & Period

Druation时间间隔单位是时分秒，Period时间间隔单位年月日

创建Duration和Period对象

LocalDate date1 = LocalDate.parse("2018-08-12");

LocalDate date2 = LocalDate.parse("2018-08-11");

LocalTime time1 = LocalTime.parse("12:45:20");

LocalTime time2 = LocalTime.parse("12:45:21");

Instant instant1 = Instant.ofEpochSecond(22);

Instant instant2 = Instant.ofEpochSecond(11);

// 时间间隔是时间秒

Duration d2 = Duration.between(time1, time2); // time2 - time1

Duration d3 = Duration.between(instant1, instant2); // instant2 - instant1

Duration d4 = Duration.ofMinutes(3); // 创建一个3分钟的时间段

System.out.println(d2.getSeconds()); // 1

System.out.println(d4.getSeconds()); // 180

// 时间间隔是年月日

Period p1 = Period.between(date1, date2); // date2 - date1

Period p2 = Period.ofDays(10);

System.out.println(p1.getDays()); // -1

System.out.println(p2.getDays()); // 10

操纵、解析和格式化日期

修改LocalDate对象属性

LocalDate date1 = LocalDate.of(2014, 3, 18);

// 以比较直观的方式修改

LocalDate date1 = date1.withYear(2011); // 修改年

LocalDate date1 = date1.withMonth(11); // 修改月

LocalDate date1 = date1.withDayOfMonth(25); // 修改日

// 以相对方式修改

date1.minusYears(1); // 减1年

date1.plusYears(2); // 加2年

date1.plus(3, ChronoUnit.MONTHS); // 加3月

date1.plus(22, ChronoUnit.DAYS); // 加22天

TemporalAdjuster

LocalDate date1 = LocalDate.of(2014, 3, 18);

// 当前日期之后包括当前日期的第一个星期日

System.out.println(date1.with(nextOrSame(DayOfWeek.SUNDAY))); // 2014-03-23

// 当月第一个星期日

System.out.println(date1.with(firstInMonth(DayOfWeek.SUNDAY))); // 2014-03-02

// 当月最后一个星期日

System.out.println(date1.with(lastInMonth(DayOfWeek.SUNDAY))); // 2014-03-30

// 当月第一天

System.out.println(date1.with(firstDayOfMonth())); // 2014-03-01

// 当月最后一天

System.out.println(date1.with(lastDayOfMonth())); // 2014-03-31

// 当年第一天

System.out.println(date1.with(firstDayOfYear())); // 2014-01-01

// 明年第一天

System.out.println(date1.with(firstDayOfNextYear())); // 2015-01-01

定制一个TemopralAdjuster

求下一个工作日

当前日期如果是周日到周四，日期向后移1天

当前日期如果是周五或周六，日期移到下周一

方案一：实现一个TemporalAdjuster类

public class NextWorkingDay implements TemporalAdjuster {

    @Override

    public Temporal adjustInto(Temporal temporal) {

        // 当前日期是周几

        DayOfWeek dow =

                DayOfWeek.of(temporal.get(ChronoField.DAY_OF_WEEK));

        // 判断要向后移几天

        int dayToAdd = 1;

        if (dow == DayOfWeek.FRIDAY) dayToAdd = 3;

        else if (dow == DayOfWeek.SATURDAY) dayToAdd = 2;

        return temporal.plus(dayToAdd, ChronoUnit.DAYS);

    }

}

方案二：直接使用Lambda使用

LocalDate nextWorkingDate = LocalDate.now()

    .with(temporal -> {

        // 当前日期是周几

        DayOfWeek dow =

            DayOfWeek.of(temporal.get(ChronoField.DAY_OF_WEEK));

        // 判断要向后移几天

        int dayToAdd = 1;

        if (dow == DayOfWeek.FRIDAY) dayToAdd = 3;

        else if (dow == DayOfWeek.SATURDAY) dayToAdd = 2;

        return temporal.plus(dayToAdd, ChronoUnit.DAYS);

    });

方案三：使用Lambda实现一个TemporalAdjuster

TemporalAdjuster nextWorkingDay = TemporalAdjusters.ofDateAdjuster(

    temporal -> {

        // 当前日期是周几

        DayOfWeek dow =

            DayOfWeek.of(temporal.get(ChronoField.DAY_OF_WEEK));

        // 判断要向后移几天

        int dayToAdd = 1;

        if (dow == DayOfWeek.FRIDAY) dayToAdd = 3;

        else if (dow == DayOfWeek.SATURDAY) dayToAdd = 2;

        return temporal.plus(dayToAdd, ChronoUnit.DAYS);

    }

);

输出及解析日期时间对象

LocalDate date1 = LocalDate.of(2014, 3, 18);

System.out.println(date1.format(DateTimeFormatter.BASIC_ISO_DATE)); // 20140318

System.out.println(date1.format(DateTimeFormatter.ISO_LOCAL_DATE)); // 2014-03-18

LocalDate date2 = LocalDate.parse("20140318", DateTimeFormatter.BASIC_ISO_DATE);

LocalDate date3 = LocalDate.parse("2014-03-18", DateTimeFormatter.ISO_LOCAL_DATE);

// 按照某个模式创建DateTimeFormatter

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy/MM/dd");

System.out.println(date1.format(formatter)); // 2014/03/18

LocalDate date4 = LocalDate.parse("2018/08/14", formatter);

// 创建一个本地化的DateTimeFormatter

DateTimeFormatter italianFormatter =

    DateTimeFormatter.ofPattern("d. MMMM yyyy", Locale.ITALIAN);

System.out.println(date1.format(italianFormatter)); // 18. marzo 2014

LocalDate date5 = LocalDate.parse("18. marzo 2014", italianFormatter);

时区与历法

ZoneId

// 打印所有时区

ZoneId.getAvailableZoneIds().stream()

	.forEach(System.out::println);

// 创建一个时区，格式为{区域}/{城市}

ZoneId romeZone = ZoneId.of("Europe/Rome");

// 将老的时区对象转换为ZoneId

ZoneId newZoneId = TimeZone.getDefault().toZoneId();

//  获取当前时区

ZoneId defaultZoneId = ZoneId.systemDefault();

System.out.println(defaultZoneId); // Asia/Shanghai

ZonedDateTime

为时间点添加时区信息

ZoneId romeZone = ZoneId.of("Europe/Rome");

// 为时间点添加时区信息

LocalDate date1 = LocalDate.now();

ZonedDateTime zdt1 = date1.atStartOfDay(romeZone);

LocalDateTime dateTime1 = LocalDateTime.now();

ZonedDateTime zdt2 = dateTime1.atZone(romeZone);

Instant instant1 = Instant.now();

ZonedDateTime zdt3 = instant1.atZone(romeZone);

// 将LocalDateTime转换为Instant

Instant instantFromDateTime = dateTime1.toInstant(ZoneOffset.ofHours(0));

// 将Instant转换为LocalDateTime

LocalDateTime dateTimeFromInstant = LocalDateTime.ofInstant(instant1, romeZone);

ZoneOffset

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

// 不推荐使用

// 纽约落后于伦敦5小时

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

System.out.println(newYorkOffset);

OffsetDateTime dateTimeInNewYork = OffsetDateTime.of(LocalDateTime.now(), newYorkOffset);

别的日历系统

ISO-8601日历系统是世界文明日历系统的事实标准。Java 8 还提供了4种其他日历系统，分别是

ThaiBuddhistDate

MinguoDate

JapaneseDate

HijrahDate  // 伊斯兰教日历

所有这些类以及LocalDate都实现了ChronoLocalDate接口。

LocalDate date1 = LocalDate.now();

JapaneseDate japaneseDate = JapaneseDate.from(date1);

System.out.println(japaneseDate); // Japanese Heisei 30-08-14

Chronology japaneseChronology = Chronology.ofLocale(Locale.JAPAN);

ChronoLocalDate now = japaneseChronology.dateNow();

System.out.println(now); // 2018-08-14

巴特西