标签：包括   自定义   简单   两种   为什么   text   nmon   学习   严格   

我们再来看一下Java标准库提供的API。Java标准库有两套处理日期和时间的API：
一套定义在java.util这个包里面，主要包括Date、Calendar和TimeZone这几个类；
一套新的API是在Java 8引入的，定义在java.time这个包里面，主要包括LocalDateTime、ZonedDateTime、ZoneId等。

为什么会有新旧两套API呢？因为历史遗留原因，旧的API存在很多问题，所以引入了新的API。
那么我们能不能跳过旧的API直接用新的API呢？如果涉及到遗留代码就不行，因为很多遗留代码仍然使用旧的API，所以目前仍然需要对旧的API有一定了解，很多时候还需要在新旧两种对象之间进行转换。

二、说明

注意ISO 8601规定的日期和时间分隔符是T。标准格式如下：

日期：yyyy-MM-dd
时间：HH:mm:ss
带毫秒的时间：HH:mm:ss.SSS
日期和时间：yyyy-MM-dd‘T‘HH:mm:ss
带毫秒的日期和时间：yyyy-MM-dd‘T‘HH:mm:ss.SSS

从Java 8开始，java.time包提供了新的日期和时间API，主要涉及的类型有：

• 本地日期和时间：LocalDateTime，LocalDate，LocalTime；
• 带时区的日期和时间：ZonedDateTime；
• 时刻：Instant；
• 时区：ZoneId，ZoneOffset；
• 时间间隔：Duration。
• 以及一套新的用于取代SimpleDateFormat的格式化类型DateTimeFormatter。

和旧的API相比，新API严格区分了时刻、本地日期、本地时间和带时区的日期时间，并且，对日期和时间进行运算更加方便。

此外，新API修正了旧API不合理的常量设计：

• Month的范围用1~12表示1月到12月；
• Week的范围用1~7表示周一到周日。
  最后，新API的类型几乎全部是不变类型（和String类似），可以放心使用不必担心被修改。

    public static void main(String[] args) {

        LocalDate d = LocalDate.now(); // 当前日期
        LocalTime t = LocalTime.now(); // 当前时间
        LocalDateTime dt = LocalDateTime.now(); // 当前日期和时间
        System.out.println(d); // 严格按照ISO 8601格式打印
        System.out.println(t); // 严格按照ISO 8601格式打印
        System.out.println(dt); // 严格按照ISO 8601格式打印

        /**
         * 执行结果:
         * 2020-08-31
         * 14:19:14.517
         * 2020-08-31T14:19:14.518
         */

    }

上面的方式获取的时间会有毫秒的差异，我们可以这样获取：

    public static void main(String[] args) {

        LocalDateTime dt = LocalDateTime.now(); // 当前日期和时间
        LocalDate d = dt.toLocalDate(); // 转换到当前日期
        LocalTime t = dt.toLocalTime(); // 转换到当前时间

        System.out.println(d); // 严格按照ISO 8601格式打印
        System.out.println(t); // 严格按照ISO 8601格式打印
        System.out.println(dt); // 严格按照ISO 8601格式打印

        /**
         * 执行结果：
         * 2020-08-31
         * 14:23:55.136
         * 2020-08-31T14:23:55.136
         */
    }

三、指定的日期和时间创建LocalDateTime

        // 指定日期和时间:
        LocalDate d2 = LocalDate.of(2019, 11, 30); // 2019-11-30, 注意11=11月
        LocalTime t2 = LocalTime.of(15, 16, 17); // 15:16:17
        LocalDateTime dt2 = LocalDateTime.of(2019, 11, 30, 15, 16, 17);
        LocalDateTime dt3 = LocalDateTime.of(d2, t2);

        System.out.println(d2);
        System.out.println(t2);
        System.out.println(dt2);
        System.out.println(dt3);

        /**
         * 执行结果:
         * 2019-11-30
         * 15:16:17
         * 2019-11-30T15:16:17
         * 2019-11-30T15:16:17
         */

因为严格按照ISO 8601的格式，因此，将字符串转换为LocalDateTime就可以传入标准格式：

        LocalDateTime dt = LocalDateTime.parse("2019-11-19T15:16:17");
        LocalDate d = LocalDate.parse("2019-11-19");
        LocalTime t = LocalTime.parse("15:16:17");
        System.out.println(d); // 严格按照ISO 8601格式打印
        System.out.println(t); // 严格按照ISO 8601格式打印
        System.out.println(dt); // 严格按照ISO 8601格式打印

        /**
         * 2019-11-19
         * 15:16:17
         * 2019-11-19T15:16:17
         */

四、DateTimeFormatter

如果要自定义输出的格式，或者要把一个非ISO 8601格式的字符串解析成LocalDateTime，可以使用新的DateTimeFormatter：

    public static void main(String[] args) {
        // 自定义格式化:
        DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");
        System.out.println(dtf.format(LocalDateTime.now()));

        // 用自定义格式解析:如果2019-11-30 15:16:17，就会报错！！
        LocalDateTime dt2 = LocalDateTime.parse("2019/11/30 15:16:17", dtf);
        System.out.println(dt2);
        /**
         * 执行结果:
         * 2020/08/31 14:55:24
         * 2019-11-30T15:16:17
         */
    }

LocalDateTime提供了对日期和时间进行加减的非常简单的链式调用

    public static void main(String[] args) {
        LocalDateTime dt = LocalDateTime.of(2020, 10, 26, 20, 30, 59);
        System.out.println(dt);
        // 加5天减3小时:
        LocalDateTime dt2 = dt.plusDays(5).minusHours(3);
        System.out.println(dt2); // 2020-10-31T17:30:59
        // 减1月:
        LocalDateTime dt3 = dt2.minusMonths(1);
        System.out.println(dt3); // 2020-09-30T17:30:59
        /**
         * 执行结果：
         * 2020-10-26T20:30:59
         * 2020-10-31T17:30:59
         * 2020-09-30T17:30:59
         *
         * 注意事项：
         * 注意到月份加减会自动调整日期，例如从2019-10-31减去1个月得到的结果是2019-09-30，因为9月没有31日
         */
    }

对日期和时间进行调整则使用withXxx()方法，
例如：withHour(15)会把10:11:12变为15:11:12：

• 调整年：withYear()
• 调整月：withMonth()
• 调整日：withDayOfMonth()
• 调整时：withHour()
• 调整分：withMinute()

• 调整秒：withSecond()

  public static void main(String[] args) {
      LocalDateTime dt = LocalDateTime.of(2020, 10, 26, 20, 30, 59);
      System.out.println(dt);
      // 日期变为31日:
      LocalDateTime dt2 = dt.withDayOfMonth(31);
      System.out.println(dt2); // 2020-10-31T20:30:59
      // 月份变为9:
      LocalDateTime dt3 = dt2.withMonth(9);
      System.out.println(dt3); // 2020-09-30T20:30:59
  
      /**
       * 执行结果：
       * 2020-10-26T20:30:59
       * 2020-10-31T20:30:59
       * 2020-09-30T20:30:59
       * 
       * 注意事项：同样注意到调整月份时，会相应地调整日期，即把2019-10-31的月份调整为9时，日期也自动变为30
       */
  }

  实际上，LocalDateTime还有一个通用的with()方法允许我们做更复杂的运算

  public static void main(String[] args) {
      // 本月第一天0:00时刻:
      LocalDateTime firstDay = LocalDate.now().withDayOfMonth(1).atStartOfDay();
      System.out.println(firstDay);
  
      // 本月最后1天:
      LocalDate lastDay = LocalDate.now().with(TemporalAdjusters.lastDayOfMonth());
      System.out.println(lastDay);
  
      // 下月第1天:
      LocalDate nextMonthFirstDay = LocalDate.now().with(TemporalAdjusters.firstDayOfNextMonth());
      System.out.println(nextMonthFirstDay);
  
      // 本月第1个周一:
      LocalDate firstWeekday = LocalDate.now().with(TemporalAdjusters.firstInMonth(DayOfWeek.MONDAY));
      System.out.println(firstWeekday);
  
      /**
       * 执行结果：
       * 2020-08-01T00:00
       * 2020-08-31
       * 2020-09-01
       * 2020-08-03
       */
  }

  要判断两个LocalDateTime的先后，可以使用isBefore()、isAfter()方法，对于LocalDate和LocalTime类似

  public static void main(String[] args) {
      LocalDateTime now = LocalDateTime.now();
      System.out.println(now);
  
      LocalDateTime target = LocalDateTime.of(2020, 11, 19, 8, 15, 0);
      System.out.println(now.isBefore(target));
  
      System.out.println(LocalDate.now().isBefore(LocalDate.of(2020, 9, 19)));
  
      System.out.println(LocalTime.now().isAfter(LocalTime.parse("08:15:00")));
  
      /**
       * 执行结果：
       * 2020-08-31T15:15:02.989
       * true
       * true
       * true
       */
  }

  Duration表示两个时刻之间的时间间隔。另一个类似的Period表示两个日期之间的天数

  
  public static void main(String[] args) {
      LocalDateTime start = LocalDateTime.of(2020, 11, 19, 8, 15, 0);
      LocalDateTime end = LocalDateTime.of(2021, 1, 9, 19, 25, 30);
      Duration d = Duration.between(start, end);
      System.out.println(d); // PT1235H10M30S
  
      Period p = LocalDate.of(2020, 11, 19).until(LocalDate.of(2021, 1, 9));
      System.out.println(p); // P1M21D
      /**
       * 执行结果：
       * PT1235H10M30S
       * P1M21D
       */
  }

注意到两个LocalDateTime之间的差值使用Duration表示，类似PT1235H10M30S，表示1235小时10分钟30秒。而两个LocalDate之间的差值用Period表示，类似P1M21D，表示1个月21天。
**Duration和Period的表示方法也符合ISO 8601的格式，它以P...T...的形式表示，P...T之间表示日期间隔，T后面表示时间间隔。如果是PT...的格式表示仅有时间间隔。利用ofXxx()或者parse()方法也可以直接创建Duration：**

public static void main(String[] args) {
    Duration d1 = Duration.ofHours(10); // 10 hours
    Duration d2 = Duration.parse("P1DT2H3M"); // 1 day, 2 hours, 3 minutes

    System.out.println(d1);
    System.out.println(d2);
    /**
     * 执行结果：
     * PT10H
     * PT26H3M
     */
}

# 五、DateTimeFormatter使用
使用旧的Date对象时，我们用SimpleDateFormat进行格式化显示。使用新的LocalDateTime或ZonedLocalDateTime时，我们要进行格式化显示，就要使用DateTimeFormatter。

和SimpleDateFormat不同的是，DateTimeFormatter不但是不变对象，它还是线程安全的。线程的概念我们会在后面涉及到。现在我们只需要记住：因为SimpleDateFormat不是线程安全的，使用的时候，只能在方法内部创建新的局部变量。而DateTimeFormatter可以只创建一个实例，到处引用。

创建DateTimeFormatter时，我们仍然通过传入格式化字符串实现：

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");

格式化字符串的使用方式与SimpleDateFormat完全一致。
另一种创建DateTimeFormatter的方法是，传入格式化字符串时，同时指定Locale：

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("E, yyyy-MMMM-dd HH:mm", Locale.US);

![](https://s4.51cto.com/images/blog/202008/31/2cb31e86a6506c43f45daff978808948.jpg?x-oss-process=image/watermark,size_16,text_QDUxQ1RP5Y2a5a6i,color_FFFFFF,t_100,g_se,x_10,y_10,shadow_90,type_ZmFuZ3poZW5naGVpdGk=)

LocalDateTime的简单学习

标签：包括   自定义   简单   两种   为什么   text   nmon   学习   严格   

原文地址：https://blog.51cto.com/hanchaohan/2526190