标准库API

因为历史遗留原因，旧的API存在一些不足，所以引入了新的API。

  1. 一套定义在java.util这个包里面，主要包括Date、Calendar和TimeZone这几个类；
  2. 一套新的API是在Java 8引入的，定义在java.time这个包里面，主要包括LocalDateTime、ZonedDateTime、ZoneId等

    java.util

    基本用法：
    1. Date date = new Date();
    2.      System.out.println(date.getYear() + 1900); // 必须加上1900
    3.      System.out.println(date.getMonth() + 1); // 0~11，必须加上1
    4.      System.out.println(date.getDate()); // 1~31，不能加1
    5.      // 转换为String:
    6.      System.out.println(date.toString());
    7.      // 转换为GMT时区:
    8.      System.out.println(date.toGMTString());
    9.      // 转换为本地时区:
    10.      System.out.println(date.toLocaleString());

    使用SimpleDateFormat转换

  • yyyy：年
  • MM：月
  • dd: 日
  • HH: 小时
  • mm: 分钟

  • ss: 秒

    1. Date date = new Date();
    2.       var sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    3.       System.out.println(sdf.format(date));

  • M：输出9

  • MM：输出09
  • MMM：输出Sep

  • MMMM：输出September

    Calendar

    和Date相比，多了可以做简单日期和时间运算的功能
    Calendar的基本用法：

    1. Calendar c = Calendar.getInstance();
    2.       int y = c.get(Calendar.YEAR);
    3.       int m = 1 + c.get(Calendar.MONTH);
    4.       int d = c.get(Calendar.DAY_OF_MONTH);
    5.       int w = c.get(Calendar.DAY_OF_WEEK);
    6.       int hh = c.get(Calendar.HOUR_OF_DAY);
    7.       int mm = c.get(Calendar.MINUTE);
    8.       int ss = c.get(Calendar.SECOND);
    9.       int ms = c.get(Calendar.MILLISECOND);

    Calendar简单的日期和时间运算

    1. // 当前时间:
    2.       Calendar c = Calendar.getInstance();
    3.       // 清除所有:
    4.       c.clear();
    5.       // 设置年月日时分秒:
    6.       c.set(2019, 10 /* 11月 */, 20, 8, 15, 0);
    7.       // 加5天并减去2小时:
    8.       c.add(Calendar.DAY_OF_MONTH, 5);
    9.       c.add(Calendar.HOUR_OF_DAY, -2);
    10.       // 显示时间:
    11.       var sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    12.       Date d = c.getTime();
    13.       System.out.println(sdf.format(d));
    14.       // 2019-11-25 6:15:00

    TimeZone

    与Date相比，它提供了时区转换的功能

    1. TimeZone tzDefault = TimeZone.getDefault(); // 当前时区
    2.       TimeZone tzGMT9 = TimeZone.getTimeZone("GMT+09:00"); // GMT+9:00时区
    3.       TimeZone tzNY = TimeZone.getTimeZone("America/New_York"); // 纽约时区
    4.       System.out.println(tzDefault.getID()); // Asia/Shanghai
    5.       System.out.println(tzGMT9.getID()); // GMT+09:00
    6.       System.out.println(tzNY.getID()); // America/New_York

    java.time

    从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类似），可以放心使用不必担心被修改。

  1. LocalDate d = LocalDate.now(); // 当前日期(年月日)
  2.         LocalTime t = LocalTime.now(); // 当前时间（时分秒）
  3.         LocalDateTime dt = LocalDateTime.now(); // 当前日期和时间

上述代码其实有一个小问题，在获取3个类型的时候，由于执行一行代码总会消耗一点时间，因此，3个类型的日期和时间很可能对不上（时间的毫秒数基本上不同）。为了保证获取到同一时刻的日期和时间，可以改写如下：

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

创建LocalDateTime

创建LocalDateTime可以通过of()方法：

  1. LocalDate d2 = LocalDate.of(2019, 11, 30); // 2019-11-30, 注意11=11月
  2. LocalTime t2 = LocalTime.of(15, 16, 17); // 15:16:17
  3. LocalDateTime dt2 = LocalDateTime.of(2019, 11, 30, 15, 16, 17);
  4. LocalDateTime dt3 = LocalDateTime.of(d2, t2);

严格按照ISO 8601标准的字符串，可以解析为LocalDateTime对象

  1. LocalDateTime dt = LocalDateTime.parse("2019-11-19T15:16:17");

注意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

    DateTimeFormatter

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

    1. DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");
    2.       System.out.println(dtf.format(LocalDateTime.now()));
    3.       // 用自定义格式解析:
    4.       LocalDateTime dt2 = LocalDateTime.parse("2019/11/30 15:16:17", dtf);
    5.       System.out.println(dt2);

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

    1. LocalDateTime dt = LocalDateTime.of(2019, 10, 26, 20, 30, 59);
    2.       System.out.println(dt);
    3.       // 加5天减3小时:
    4.       LocalDateTime dt2 = dt.plusDays(5).minusHours(3);
    5.       System.out.println(dt2); // 2019-10-31T17:30:59
    6.       // 减1月:
    7.       LocalDateTime dt3 = dt2.minusMonths(1);
    8.       System.out.println(dt3); // 2019-09-30T17:30:59

    要注意月份去调整日期，例如2019-10-31减去一个月是2019-9-30而不是2019-9-31，因为9月没有31日
    对日期和时间进行调整则使用withXxx()方法，例如：withHour(15)会把10:11:12变为15:11:12：

  • 调整年：withYear()

  • 调整月：withMonth()
  • 调整日：withDayOfMonth()
    1. LocalDateTime dt = LocalDateTime.of(2019, 10, 26, 20, 30, 59);
    2.       System.out.println(dt);
    3.       // 日期变为31日:
    4.       LocalDateTime dt2 = dt.withDayOfMonth(31);
    5.       System.out.println(dt2); // 2019-10-31T20:30:59
    6.       // 月份变为9:
    7.       LocalDateTime dt3 = dt2.withMonth(9);
    8.       System.out.println(dt3); // 2019-09-30T20:30:59
    with()方法还允许我们做更复杂的运算
    1. LocalDateTime firstDay = LocalDate.now().withDayOfMonth(1).atStartOfDay();
    2.       System.out.println(firstDay);
    3.       // 本月最后1天:
    4.       LocalDate lastDay = LocalDate.now().with(TemporalAdjusters.lastDayOfMonth());
    5.       System.out.println(lastDay);
    6.       // 下月第1天:
    7.       LocalDate nextMonthFirstDay = LocalDate.now().with(TemporalAdjusters.firstDayOfNextMonth());
    8.       System.out.println(nextMonthFirstDay);
    9.       // 本月第1个周一:
    10.       LocalDate firstWeekday = LocalDate.now().with(TemporalAdjusters.firstInMonth(DayOfWeek.MONDAY));
    11.       System.out.println(firstWeekday);
    判断两个LocalDateTime的先后，可以使用isBefore()、isAfter()方法
    1. LocalDateTime now = LocalDateTime.now();
    2.       LocalDateTime target = LocalDateTime.of(2019, 11, 19, 8, 15, 0);
    3.       System.out.println(now.isBefore(target));
    4.       System.out.println(LocalDate.now().isBefore(LocalDate.of(2019, 11, 19)));
    5.       System.out.println(LocalTime.now().isAfter(LocalTime.parse("18:15:00")));
    注意LocalTime.now（）没有时区概念（它是英国格林威治标准时间），无法确定某个时刻，后面与ZonedDateTime组合后，具有时区。

    Duration和Period

    Duration表示两个时刻之间的时间间隔。另一个类似的Period表示两个日期之间的天数：
    LocalDateTime start = LocalDateTime.of(2019, 11, 19, 8, 15, 0);
      LocalDateTime end = LocalDateTime.of(2020, 1, 9, 19, 25, 30);
      Duration d = Duration.between(start, end);
      System.out.println(d); // PT1235H10M30S
      Period p = LocalDate.of(2019, 11, 19).until(LocalDate.of(2020, 1, 9));
      System.out.println(p); // P1M21D
    Duration和Period的表示方法也符合ISO 8601的格式，它以P...T...的形式表示，P...T之间表示日期间隔，T后面表示时间间隔。如果是PT...的格式表示仅有时间间隔。利用ofXxx()或者parse()方法也可以直接创建Duration：
    Duration d1 = Duration.ofHours(10); // 10 hours
Duration d2 = Duration.parse("P1DT2H3M"); // 1 day, 2 hours, 3 minutes

    ZonedDateTime

    可以简单地把ZonedDateTime理解成LocalDateTime加ZoneId。ZoneId是java.time引入的新的时区类，注意和旧的java.util.TimeZone区别。使用方法如下：
    ZonedDateTime zbj = ZonedDateTime.now();
ZonedDateTime zbj = ZonedDateTime.now(ZoneId.of("America/New_York"));
    它们表示的是同一个时刻，只是因为时区不同
    另一种方式是通过给一个LocalDateTime附加一个ZoneId，就可以变成ZonedDateTime：
    LocalDateTime ldt = LocalDateTime.of(2019, 9, 15, 15, 16, 17);
      ZonedDateTime zbj = ldt.atZone(ZoneId.systemDefault());
      ZonedDateTime zny = ldt.atZone(ZoneId.of("America/New_York"));
      System.out.println(zbj);
      System.out.println(zny);

    时区转换

    要转换时区，首先我们需要有一个ZonedDateTime对象，然后，通过withZoneSameInstant()将关联时区转换到另一个时区，转换后日期和时间都会相应调整。
    // 以中国时区获取当前时间:
      ZonedDateTime zbj = ZonedDateTime.now(ZoneId.of("Asia/Shanghai"));
      // 转换为纽约时间:
      ZonedDateTime zny = zbj.withZoneSameInstant(ZoneId.of("America/New_York"));
      System.out.println(zbj);//2020-04-30T15:10:02.914431+08:00[Asia/Shanghai]
      System.out.println(zny);//2020-04-30T03:10:02.914431-04:00[America/New_York]

    DateTimeFormatter

    DateTimeFormatter与SimpleDateFormat不同的是，DateTimeFormatter是不变变量，而且还是线程安全，可以只创建一个实例，到处引用：
    DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");