JAVA8时间工具类

JAVA8时间工具类

前言

因为JDK1.7的时间工具类Date和Calendar存在安全性问题，同时大多数API 都已过时，所以JDK1.8重新规划了时间工具类，这些工具类的核心如下

• Instant：瞬时实例。

• LocalDate：本地日期，不包含具体时间 例如：2020-01-01。

• LocalTime：本地时间，不包含日期。

• LocalDateTime：组合了日期和时间，但不包含时差和时区信息。

• ZonedDateTime：最完整的日期时间，包含时区和相对UTC或格林威治的时差。

• Duration：表示一个时间段。

• Period：用来表示以年月日来衡量一个时间段。

• DateTimeFormatter：新的日期解析格式化类。

其中Instant、Duration、Period可以参考如下文章

JAVA时间戳类Instant

JAVA时间存储类Period和Duration

LocalDate

构建LocalDate对象

// 构建日期对象
System.out.println(LocalDate.of(1,2,3));

// 从1970-01-01开始计算第1000天的日期
System.out.println(LocalDate.ofEpochDay(1000));

// 指定年份内的多少天，如下指2022年的第300天日期
System.out.println(LocalDate.ofYearDay(2022, 300));

// 获取当前日期 2022-09-27
LocalDate localDate = LocalDate.now();

对象属性的获取

// 获取当前日期 2022-09-27
LocalDate localDate = LocalDate.now();

// 获取年份，两种方法
System.out.println("年："+localDate.getYear());
System.out.println("年："+localDate.get(ChronoField.YEAR));

// 获取月份，两种方法返回值一个是Month对象一个是int值
Month month = localDate.getMonth();
// 月：九月
System.out.println("月："+month.getDisplayName(TextStyle.FULL, Locale.CHINESE));
// 月：9
System.out.println("月："+localDate.getMonthValue());

// 获取星期，两种方法返回值一个是DayOfWeek对象，一个是int值
DayOfWeek dayOfWeek = localDate.getDayOfWeek();
// 星期二
System.out.println(dayOfWeek.getDisplayName(TextStyle.FULL,Locale.CHINA));
// 星期：2
System.out.println("星期："+localDate.get(ChronoField.DAY_OF_WEEK));

// 获取当前日期在一个星期中是第几天
System.out.println(localDate.getDayOfWeek().getValue());
// 获取当前日期在一个月中是第几天
System.out.println(localDate.getDayOfMonth());
// 获取当前日期在一年中是第几天
System.out.println(localDate.getDayOfYear());

其它API

// 获取当前日期 2022-09-27
LocalDate localDate = LocalDate.now();

LocalDate localDate1 = LocalDate.of(2020,1,1);
// 是否是闰年
System.out.println(localDate1.isLeapYear());

// 字段是否被支持，不支持的调用get、with、range等方法报错
System.out.println(localDate1.isSupported(ChronoField.YEAR));

// 日期比较 isBefore、isEqual、compareTo类似
System.out.println(localDate1.isAfter(localDate));

// minus减去对应单位的时间 plus加上对应单位时间 with设置对应时间  均可自定义参数
LocalDate localDate2 = localDate1.minus(1, ChronoUnit.DAYS);
System.out.println(localDate2);

// 当前月份有多少天
System.out.println(localDate.lengthOfMonth());
// 当前年份有多少天
System.out.println(localDate.lengthOfYear());

// 给当前时间加上时、分、秒、纳秒、等参数（个数可选）,返回值为LocalDateTime
LocalDateTime localDateTime = localDate.atTime(1, 1, 1, 1);

// 调整指定的时间对象日期相同
Temporal temporal = localDate.adjustInto(localDate2);

// 赋予当前时间的午夜时间，返回结果 2022-09-27T00:00
LocalDateTime localDateTime1 = localDate.atStartOfDay();

// 字符串转LocalDate，LocalDate转字符串
DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy/MM/dd");
String format = localDate.format(dateTimeFormatter);
System.out.println(format);
LocalDate localDate3 = LocalDate.parse("2022/01/21", dateTimeFormatter);
System.out.println(localDate3);

// 获取指定字段的有效范围，如下获取月份的有效范围1 - 12
ValueRange valueRange = localDate.range(ChronoField.MONTH_OF_YEAR);

LocalTime

构建LocalTime对象

// 获取当前时间 10:51:29.406
LocalTime localTime1 = LocalTime.now();
System.out.println(localTime1);

// 指定时分秒构建对象 02:03:04
LocalTime localTime2 = LocalTime.of(2, 3, 4);
System.out.println(localTime2);

// 指定时间为当前天的第1000秒 00:16:40
System.out.println(LocalTime.ofSecondOfDay(1000));

// 指定时间为当前天的第10023000纳秒 00:00:00.010023
System.out.println(LocalTime.ofNanoOfDay(10023000));

// 将字符串转换为默认格式 hh:mm:ss
LocalTime localTime3 = LocalTime.parse("01:12:56");

// 将字符串转换为指定格式
LocalTime.parse("01:12:56", DateTimeFormatter.ISO_TIME);
// 方法二 11-44-55
localTime1.format(DateTimeFormatter.ofPattern("HH-mm-ss"));

对象属性的获取

LocalTime localTime = LocalTime.now();
// 获取小时
System.out.println(localTime.getHour());
// 获取分钟
System.out.println(localTime.getMinute());
// 获取秒
System.out.println(localTime.getSecond());
// 获取纳秒 1毫秒 = 1000_000纳秒
System.out.println(localTime.getNano());
// 获取指定单位的时间(可以获取任意时间单位)
System.out.println(localTime.get(ChronoField.MILLI_OF_SECOND));

其它API

// 时间截断，如截断时间返回值由原来的11:55:13  变为11:55(相当于分钟后的时间单位置为0)
LocalTime localTime4 = localTime.truncatedTo(ChronoUnit.MINUTES);

LocalTime同样有minus、plus、with相关方法，用法参考LocalDate。

LocalDateTime

构建LocalDateTime对象

// 获取当前日期
LocalDateTime localDateTime = LocalDateTime.now();

// 从1970-01-01T00:00:00Z后增加1000秒值为：1970-01-01T00:16:40Z
Instant instant = Instant.ofEpochSecond(1000);
// 指定时区 1970-01-01T08:16:40
LocalDateTime.ofInstant(instant, ZoneId.systemDefault());

// of包含多种构造函数
LocalDate localDate = LocalDate.of(2020,10,10);
LocalTime localTime = LocalTime.of(10,10,20);
// 组合日期和时间得到LocalDateTime日期对象 2020-10-10T10:10:20
LocalDateTime localDateTime1 = LocalDateTime.of(localDate,localTime);

LocalDateTime.parse("2011-12-03T10:15:30");

// 可自定义格式，也可以引用DateTimeFormatter内置格式如 DateTimeFormatter.ISO_LOCAL_DATE_TIME
DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
System.out.println(LocalDateTime.parse("2011-12-03 10:15:30",dateTimeFormatter));

LocalDateTime相关API于LocalDate,LocalTime及其类似，可以直接参考。