JDK 1.8 完整日期时间Api （文末附示例）

一、背景

jdk 1.8 之前， Java 时间使用java.util.Date 和 java.util.Calendar 类。

Date today = new Date();
System.out.println(today);
	
 // 转为字符串
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String todayStr = sdf.format(today);
System.out.println(todayStr);

Date 的几个问题：

如果不格式化，Date打印出的日期可读性差；
可以使用 SimpleDateFormat 对时间进行格式化，但 SimpleDateFormat 是线程不安全的（阿里巴巴开发手册中禁用static修饰SimpleDateFormat）；
Date对时间处理比较麻烦，比如想获取某年、某月、某星期，以及 n 天以后的时间，如果用Date来处理的话真是太难了，并且 Date 类的 getYear()、getMonth() 这些方法都被弃用了；

二、`JDK 1.8` 新的日期时间类型

Java8引入的新的一系列API，对时间日期的处理提供了更好的支持，清楚的定义了时间日期的一些概念，比如说，瞬时时间（Instant）,持续时间（duration），日期（date），时间（time），时区（time-zone）以及时间段（Period）。

LocalDate：不包含时间的日期，比如2019-10-14。可以用来存储生日，周年纪念日，入职日期等。
LocalTime：与LocalDate想对照，它是不包含日期的时间。
LocalDateTime：包含了日期及时间，没有偏移信息（时区）。
ZonedDateTime：包含时区的完整的日期时间，偏移量是以UTC/格林威治时间为基准的。
Instant：时间戳，与System.currentTimeMillis()类似。
Duration：表示一个时间段。
Period：用来表示以年月日来衡量一个时间段。
DateTimeFormatter：新的日期解析格式化类。

2.1 `LocalDate`

LocalDate类内只包含日期，不包含具体时间。只需要表示日期而不包含时间，就可以使用它。

public static void localDate() {
    //获取当前年月日
    LocalDate today = LocalDate.now();
    System.out.println("当前年月日：" + today);

    // 获取年的两种方式
    int thisYear = today.getYear();
    int thisYearAnother = today.get(ChronoField.YEAR);
    System.out.println("今年是" + thisYear + "年");
    System.out.println("今年是" + thisYearAnother + "年");

    // 获取月
    Month thisMonth = today.getMonth();
    System.out.println(thisMonth.toString());
    // 这是今年的第几个月(两种写法)
    int monthOfYear = today.getMonthValue();
    // int monthOfYear = today.get(ChronoField.MONTH_OF_YEAR);
    System.out.println("这个月是今年的第" + monthOfYear + "个月");
    // 月份的天数
    int length = today.lengthOfMonth();
    System.out.println("这个月有" + length + "天");

    // 获取日的两种方式
    int thisDay = today.getDayOfMonth();
    int thisDayAnother = today.get(ChronoField.DAY_OF_MONTH);
    System.out.println("今天是这个月的第" + thisDay + "天");
    System.out.println("今天是这个月的第" + thisDayAnother + "天");

    // 获取星期
    DayOfWeek thisDayOfWeek = today.getDayOfWeek();
    System.out.println(thisDayOfWeek.toString());
    // 今天是这周的第几天
    int dayOfWeek = today.get(ChronoField.DAY_OF_WEEK);
    System.out.println("今天是这周的第" + dayOfWeek + "天");

    // 是否为闰年
    boolean leapYear = today.isLeapYear();
    System.out.println("今年是闰年：" + leapYear);

    //构造指定的年月日
    LocalDate anotherDay = LocalDate.of(2008, 8, 8);
    System.out.println("指定年月日：" + anotherDay);
}

2.2 `LocalTime`

LocalTime只会获取时间，不获取日期。LocalTime和LocalDate类似，区别在于LocalDate不包含具体时间，而LocalTime不包含具体日期。

public static void localTime() {
    // 获取当前时间
    LocalTime nowTime = LocalTime.now();
    System.out.println("当前时间：" + nowTime);

    //获取小时的两种方式
    int hour = nowTime.getHour();
    int thisHour = nowTime.get(ChronoField.HOUR_OF_DAY);
    System.out.println("当前时：" + hour);
    System.out.println("当前时：" + thisHour);


    //获取分的两种方式
    int minute = nowTime.getMinute();
    int thisMinute = nowTime.get(ChronoField.MINUTE_OF_HOUR);
    System.out.println("当前分：" + minute);
    System.out.println("当前分：" + thisMinute);

    //获取秒的两种方式
    int second = nowTime.getSecond();
    int thisSecond = nowTime.get(ChronoField.SECOND_OF_MINUTE);
    System.out.println("当前秒：" + second);
    System.out.println("当前秒：" + thisSecond);

    // 构造指定时间(最多可到纳秒)
    LocalTime anotherTime = LocalTime.of(20, 8, 8);
    System.out.println("构造指定时间：" + anotherTime);
}

2.3 `LocalDateTime`

LocalDateTime表示日期和时间组合。可以通过of()方法直接创建，也可以调用LocalDate的atTime()方法或LocalTime的atDate()方法将LocalDate或LocalTime合并成一个LocalDateTime。

public static void localDateTime() {
    // 当前日期和时间
    LocalDateTime today = LocalDateTime.now();
    System.out.println("现在是：" + today);

    // 创建指定日期和时间
    LocalDateTime anotherDay = LocalDateTime.of(2008, Month.AUGUST, 8, 8, 8, 8);
    System.out.println("创建的指定时间是：" + anotherDay);

    // 拼接日期和时间
    // 使用当前日期，指定时间生成的 LocalDateTime
    LocalDateTime thisTime = LocalTime.now().atDate(LocalDate.of(2008, 8, 8));
    System.out.println("拼接的日期是：" + thisTime);
    // 使用当前日期，指定时间生成的 LocalDateTime
    LocalDateTime thisDay = LocalDate.now().atTime(LocalTime.of(12, 24, 12));
    System.out.println("拼接的日期是：" + thisDay);
    // 指定日期和时间生成 LocalDateTime
    LocalDateTime thisDayAndTime = LocalDateTime.of(LocalDate.of(2008, 8, 8), LocalTime.of(12, 24, 12));
    System.out.println("拼接的日期是：" + thisDayAndTime);

    // 获取LocalDate
    LocalDate todayDate = today.toLocalDate();
    System.out.println("今天日期是：" + todayDate);

    // 获取LocalTime
    LocalTime todayTime = today.toLocalTime();
    System.out.println("现在时间是：" + todayTime);
}

2.4 `Instant`

Instant用于一个获取时间戳，与System.currentTimeMillis()类似，但Instant可以精确到纳秒。

public class InstantDemo {

    public static void main(String[] args) {

        // 创建Instant对象
        Instant instant = Instant.now();
        // 通过ofEpochSecond方法创建(第一个参数表示秒，第二个参数表示纳秒)
        Instant another = Instant.ofEpochSecond(365 * 24 * 60, 100);

        // 获取到秒数
        long currentSecond = instant.getEpochSecond();
        System.out.println("获取到秒数：" + currentSecond);

        // 获取到毫秒数
        long currentMilli = instant.toEpochMilli();
        System.out.println("获取到毫秒数：" + currentMilli);
    }
}

2.5 `Duration`

Duration的内部实现与Instant类似，但Duration表示时间段，通过between方法创建，还可以通过of()方法创建。

public static void duration() {
    LocalDateTime from = LocalDateTime.now();
    LocalDateTime to = LocalDateTime.now().plusDays(1);
    // 通过between()方法创建
    Duration duration = Duration.between(from, to);
    // 通过of()方法创建,该方法参数为时间段长度和时间单位。
    // 7天
    Duration duration1 = Duration.of(7, ChronoUnit.DAYS);
    // 60秒
    Duration duration2 = Duration.of(60, ChronoUnit.SECONDS);
}

2.5 `Period`

Period与Duration类似，获取一个时间段，只不过单位为年月日，也可以通过of方法和between方法创建，between方法接收的参数为LocalDate。

private static void period() {
    // 通过of方法
    Period period = Period.of(2012, 12, 24);
    // 通过between方法
    Period period1 = Period.between(LocalDate.now(), LocalDate.of(2020,12,31));
}

三、时间操作

3.1 时间比较

isBefore()和isAfter()判断给定的时间或日期是在另一个时间/日期之前还是之后。
以LocalDate为例，LocalDateTime/LocalTime 同理。

public static void compare() {
    LocalDate thisDay = LocalDate.of(2008, 8, 8);
    LocalDate otherDay = LocalDate.of(2018, 8, 8);

    // 晚于
    boolean isAfter = thisDay.isAfter(otherDay);
    System.out.println(isAfter);

    // 早于
    boolean isBefore = thisDay.isBefore(otherDay);
    System.out.println(isBefore);
}

3.2 增加/减少年数、月数、天数

以LocalDateTime为例，LocalDate/LocalTime同理。

public static void plusAndMinus() {
    // 增加
    LocalDateTime today = LocalDateTime.now();
    LocalDateTime nextYearDay = today.plusYears(1);
    System.out.println("下一年的今天是：" + nextYearDay);
    LocalDateTime nextMonthDay = today.plus(1, ChronoUnit.MONTHS);
    System.out.println("下一个月的今天是：" + nextMonthDay);

    //减少
    LocalDateTime lastMonthDay = today.minusMonths(1);
    LocalDateTime lastYearDay = today.minus(1, ChronoUnit.YEARS);
    System.out.println("一个月前是：" + lastMonthDay);
    System.out.println("一年前是：" + lastYearDay);
}

3.3 时间修改

通过with修改时间

public static void edit() {
    LocalDateTime today = LocalDateTime.now();
    // 修改年为2012年
    LocalDateTime thisYearDay = today.withYear(2012);
    System.out.println("修改年后的时间为：" + thisYearDay);
    // 修改为12月
    LocalDateTime thisMonthDay = today.with(ChronoField.MONTH_OF_YEAR, 12);
    System.out.println("修改月后的时间为：" + thisMonthDay);
}

3.4 时间计算

通过 TemporalAdjusters 的静态方法和 Duration 计算时间

public static void compute() {
    // TemporalAdjusters 的静态方法
    LocalDate today = LocalDate.now();
    // 获取今年的第一天
    LocalDate date = today.with(firstDayOfYear());
    System.out.println("今年的第一天是：" + date);

    // Duration 计算
    LocalDateTime from = LocalDateTime.now();
    LocalDateTime to = LocalDateTime.now().plusMonths(1);
    Duration duration = Duration.between(from, to);

    // 区间统计换算
    // 总天数
    long days = duration.toDays();
    System.out.println("相隔" + days + "天");
    // 小时数
    long hours = duration.toHours();
    System.out.println("相隔" + hours + "小时");
    // 分钟数
    long minutes = duration.toMinutes();
    System.out.println("相隔" + minutes + "分钟");
}

TemporalAdjusters的更多方法

方法名称	描述
`dayOfWeekInMonth()`	返回同一个月中每周的第几天
`firstDayOfMonth()`	返回当月的第一天
`firstDayOfNextMonth()`	返回下月的第一天
`firstDayOfNextYear()`	返回下一年的第一天
`firstDayOfYear()`	返回本年的第一天
`firstInMonth()`	返回同一个月中第一个星期几
`lastDayOfMonth()`	返回当月的最后一天
`lastDayOfNextMonth()`	返回下月的最后一天
`lastDayOfNextYear()`	返回下一年的最后一天
`lastDayOfYear()`	返回本年的最后一天
`lastInMonth()`	返回同一个月中最后一个星期几
`next()` / `previous()`	返回后一个/前一个给定的星期几
`nextOrSame()` / `previousOrSame()`	返回后一个/前一个给定的星期几，如果这个值满足条件，直接返回

四、时间日期格式化

4.1 格式化时间

DateTimeFormatter默认提供了多种格式化方式，如果默认提供的不能满足要求，可以通过DateTimeFormatter的ofPattern方法创建自定义格式化方式。

public static void format() {
    LocalDate today = LocalDate.now();
    // 两种默认格式化时间方式
    String todayStr1 = today.format(DateTimeFormatter.BASIC_ISO_DATE);
    String todayStr2 = today.format(DateTimeFormatter.ISO_LOCAL_DATE);
    System.out.println("格式化时间：" + todayStr1);
    System.out.println("格式化时间：" + todayStr2);
    //自定义格式化
    DateTimeFormatter dateTimeFormatter =   DateTimeFormatter.ofPattern("dd/MM/yyyy");
    String todayStr3 = today.format(dateTimeFormatter);
    System.out.println("自定义格式化时间：" + todayStr3);

}

4.2 解析时间

4.1 中以何种方式格式化，这里需以同样方式解析。

public static void parse() {
    LocalDate date1 = LocalDate.parse("20080808", DateTimeFormatter.BASIC_ISO_DATE);
    LocalDate date2 = LocalDate.parse("2008-08-08", DateTimeFormatter.ISO_LOCAL_DATE);
    System.out.println(date1);
    System.out.println(date2);
}

五、总结

相较于Date 的优势

Instant 的精确度更高，可以精确到纳秒级;
Duration 可以便捷得到时间段内的天数、小时数等;
LocalDateTime 能够快速地获取年、月、日、下一月等;
TemporalAdjusters 类中包含许多常用的静态方法，避免自己编写工具类;
与Date的格式化方式SimpleDateFormat相比，DateTimeFormatter是线程安全的。

5.1 示例代码

Github 示例代码

5.2 技术交流

posted @ 2020-02-06 16:10 风尘博客阅读(1846) 评论(0) 编辑收藏举报

刷新页面返回顶部

风尘博客

我有一杯酒，可以慰风尘。

JDK 1.8 完整日期时间Api （文末附示例）

一、背景

二、`JDK 1.8` 新的日期时间类型

2.1 `LocalDate`

2.2 `LocalTime`

2.3 `LocalDateTime`

2.4 `Instant`

2.5 `Duration`

2.5 `Period`

三、时间操作

3.1 时间比较

3.2 增加/减少年数、月数、天数

3.3 时间修改

3.4 时间计算

四、时间日期格式化

4.1 格式化时间

4.2 解析时间

五、总结

5.1 示例代码

5.2 技术交流

技术交流，欢迎扫一扫！

风尘博客

公告

风尘博客

我有一杯酒，可以慰风尘。

JDK 1.8 完整日期时间Api （文末附示例）

一、背景

二、JDK 1.8 新的日期时间类型

2.1 LocalDate

2.2 LocalTime

2.3 LocalDateTime

2.4 Instant

2.5 Duration

2.5 Period

三、时间操作

3.1 时间比较

3.2 增加/减少年数、月数、天数

3.3 时间修改

3.4 时间计算

四、时间日期格式化

4.1 格式化时间

4.2 解析时间

五、总结

5.1 示例代码

5.2 技术交流

公告

二、`JDK 1.8` 新的日期时间类型

2.1 `LocalDate`

2.2 `LocalTime`

2.3 `LocalDateTime`

2.4 `Instant`

2.5 `Duration`

2.5 `Period`