java 8 时间类之彻底看懂 java.time.temporal.ChronoField

java 8 时间类之彻底看懂 java.time.temporal.ChronoField

欢迎关注我的项目：https://github.com/duanluan/ZUtil，这篇博文只是完善时间工具类的测试过程。

代码：

@DisplayName("时间工具类测试")
public class DateUtilsTest {

  @DisplayName("探寻 ChronoField")
  @Test
  void testChronoField() {
    String indent = "ttttttttttttt";
    LocalDateTime now = LocalDateTime.now();
    // 时代：公元前，相当于当前时间的负数
    System.out.println(now.with(ChronoField.ERA, 0) + indent.replaceFirst("t", "") + "时代：公元前");
    // 时代：公元，即当前时间
    System.out.println(now.with(ChronoField.ERA, 1) + indent + "时代：公元");
    // 公元前所属年：以当前时间为基础，年修改为公元前 2 年，结果 -0001-10-01T02:30:32.723 加上当前时间的月份往后 10-01T02:30:32.723 为 2 年
    System.out.println(now.with(ChronoField.ERA, 0).with(ChronoField.YEAR_OF_ERA, 2) + indent.replaceFirst("t", "") + "公元前所属年");
    // 公元后所属年：以当前年月为基础，年修改为 2 年
    System.out.println(now.with(ChronoField.ERA, 1).with(ChronoField.YEAR_OF_ERA, 2) + indent + "公元后所属年");
    // 年
    System.out.println(now.with(ChronoField.YEAR, 2020) + indent + "年");
    // 预期月，从 0 年开始计算月（从 0 开始），2021 年 10 月的值为 2021 * 12 + 10 - 1
    System.out.println(now.with(ChronoField.PROLEPTIC_MONTH, 0) + indent + "预期月");
    // 年的月
    System.out.println(now.with(ChronoField.MONTH_OF_YEAR, 9) + indent + "年的月");
    // 年的对齐周：年的第一天为第一周的第一天
    System.out.println(now.with(ChronoField.ALIGNED_WEEK_OF_YEAR, 2) + indent + "年的对齐周");
    // 月的对齐周：月的第一天为此月第一周的第一天
    System.out.println(now.with(ChronoField.ALIGNED_WEEK_OF_MONTH, 2) + indent + "月的对齐周");
    // 年的对齐周的天
    System.out.println(now.with(ChronoField.ALIGNED_WEEK_OF_YEAR, 2).with(ChronoField.ALIGNED_DAY_OF_WEEK_IN_YEAR, 5) + indent + "年的对齐周的天");
    // 月的对齐周的天
    System.out.println(now.with(ChronoField.ALIGNED_WEEK_OF_MONTH, 2).with(ChronoField.ALIGNED_DAY_OF_WEEK_IN_MONTH, 5) + indent + "月的对齐周的天");
    // 年的天
    System.out.println(now.with(ChronoField.DAY_OF_YEAR, 1) + indent + "年的天");
    // 月的天
    System.out.println(now.with(ChronoField.DAY_OF_MONTH, 1) + indent + "月的天");
    // 周的天
    System.out.println(now.with(ChronoField.DAY_OF_WEEK, 1) + indent + "周的天");
    // 以 1970-01-01 为 0 开始的天（忽略偏移量和时区）
    System.out.println(now.with(ChronoField.EPOCH_DAY, 1) + indent + "以 1970-01-01 为 0 开始的天（忽略偏移量和时区）");
    // 上午（0-12）
    System.out.println(now.with(ChronoField.AMPM_OF_DAY, 0) + indent + "上午（0-12）");
    // 下午（13-23）
    System.out.println(now.with(ChronoField.AMPM_OF_DAY, 1) + indent + "下午（13-23）");
    // 上午或下午的小时，以当前 AMPM 为准，从 0 开始
    System.out.println(now.with(ChronoField.HOUR_OF_AMPM, 0) + indent + "上午或下午的小时");
    // 上午的小时
    System.out.println(now.with(ChronoField.AMPM_OF_DAY, 0).with(ChronoField.HOUR_OF_AMPM, 0) + indent + "上午的小时");
    // 下午的小时
    System.out.println(now.with(ChronoField.AMPM_OF_DAY, 1).with(ChronoField.HOUR_OF_AMPM, 0) + indent + "下午的小时");
    // 12 小时制，以当前 AMPM 为准，从 1 开始
    System.out.println(now.with(ChronoField.CLOCK_HOUR_OF_AMPM, 1) + indent + "12 小时制");
    // 上午的 12 小时制小时
    System.out.println(now.with(ChronoField.AMPM_OF_DAY, 0).with(ChronoField.CLOCK_HOUR_OF_AMPM, 1) + indent + "上午的 12 小时制小时");
    // 下午的 12 小时制小时
    System.out.println(now.with(ChronoField.AMPM_OF_DAY, 1).with(ChronoField.CLOCK_HOUR_OF_AMPM, 1) + indent + "下午的 12 小时制小时");
    // 天的小时
    System.out.println(now.with(ChronoField.HOUR_OF_DAY, 0) + indent + "天的小时");
    // 天的分钟
    System.out.println(now.with(ChronoField.MINUTE_OF_DAY, 1) + indent + "天的分钟");
    // 小时的分钟
    System.out.println(now.with(ChronoField.MINUTE_OF_HOUR, 1) + indent + "小时的分钟");
    // 天的秒
    System.out.println(now.with(ChronoField.SECOND_OF_DAY, 1) + indent + "天的秒");
    // 分钟的秒
    System.out.println(now.with(ChronoField.SECOND_OF_MINUTE, 1) + indent + "分钟的秒");
    // 以 1970-01-01T00:00Z (ISO) 为 0 开始的秒，必须和时区结合使用（+时区小时）
    System.out.println(now.atZone(ZoneId.systemDefault()).with(ChronoField.INSTANT_SECONDS, 1) + "tt以 1970-01-01T00:00Z (ISO) 为 0 开始的秒，必须和时区结合使用（+时区小时）");
    // 天的毫秒
    System.out.println(now.with(ChronoField.MILLI_OF_DAY, 1) + indent + "天的毫秒");
    // 秒的毫秒
    System.out.println(now.with(ChronoField.MILLI_OF_SECOND, 1) + indent + "秒的毫秒");
    // 天的微秒
    System.out.println(now.with(ChronoField.MICRO_OF_DAY, 1) + indent.replaceFirst("tt", "") + "天的微秒");
    // 秒的微秒
    System.out.println(now.with(ChronoField.MICRO_OF_SECOND, 1) + indent.replaceFirst("tt", "") + "秒的微秒");
    // 天的纳秒
    System.out.println(now.with(ChronoField.NANO_OF_DAY, 1) + indent.replaceFirst("ttt", "") + "天的纳秒");
    // 秒的纳秒
    System.out.println(now.with(ChronoField.NANO_OF_SECOND, 1) + indent.replaceFirst("ttt", "") + "秒的纳秒");
  }
}

运行结果，和 “2020-11-21 16:10:43.532” 这个时间对比着看区别：

-2020-11-21T16:10:43.532							时代：公元前
2021-11-21T16:10:43.532								时代：公元
-0001-11-21T16:10:43.532							公元前所属年
0002-11-21T16:10:43.532								公元后所属年
2020-11-21T16:10:43.532								年
0000-01-21T16:10:43.532								预期月
2021-09-21T16:10:43.532								年的月
2021-01-10T16:10:43.532								年的对齐周
2021-11-14T16:10:43.532								月的对齐周
2021-01-12T16:10:43.532								年的对齐周的天
2021-11-12T16:10:43.532								月的对齐周的天
2021-01-01T16:10:43.532								年的天
2021-11-01T16:10:43.532								月的天
2021-11-15T16:10:43.532								周的天
1970-01-02T16:10:43.532								以 1970-01-01 为 0 开始的天（忽略偏移量和时区）
2021-11-21T04:10:43.532								上午（0-12）
2021-11-21T16:10:43.532								下午（13-23）
2021-11-21T12:10:43.532								上午或下午的小时
2021-11-21T00:10:43.532								上午的小时
2021-11-21T12:10:43.532								下午的小时
2021-11-21T13:10:43.532								12 小时制
2021-11-21T01:10:43.532								上午的 12 小时制小时
2021-11-21T13:10:43.532								下午的 12 小时制小时
2021-11-21T00:10:43.532								天的小时
2021-11-21T00:01:43.532								天的分钟
2021-11-21T16:01:43.532								小时的分钟
2021-11-21T00:00:01.532								天的秒
2021-11-21T16:10:01.532								分钟的秒
1970-01-01T08:00:01.532+08:00[Asia/Shanghai]		以 1970-01-01T00:00Z (ISO) 为 0 开始的秒，必须和时区结合使用（+时区小时）
2021-11-21T00:00:00.001								天的毫秒
2021-11-21T16:10:43.001								秒的毫秒
2021-11-21T00:00:00.000001							天的微秒
2021-11-21T16:10:43.000001							秒的微秒
2021-11-21T00:00:00.000000001						天的纳秒
2021-11-21T16:10:43.000000001						秒的纳秒