一、新日期时间API介绍
JDK 8中增加了一套全新的日期时间API，这套API设计合理，是线程安全的。新的日期及时间API位于 java.time 包中，下面是一些关键类。
LocalDate ： 表示日期，包含年月日，格式为 2019-10-16
**LocalTime ：**表示时间，包含时分秒，格式为 16:38:54.158549300
**LocalDateTime ：**表示日期时间，包含年月日，时分秒，格式为 2018-09-06T15:33:56.750
DateTimeFormatter ： 日期时间格式化类。
Instant： 时间戳，表示一个特定的时间瞬间。
Duration： 用于计算2个时间(LocalTime，时分秒)的距离
Period： 用于计算2个日期(LocalDate，年月日)的距离
ZonedDateTime ： 包含时区的时间
二、获取时间
LocalDate类：
// LocalDate:获取日期时间信息。(yyyy-MM-dd) // 获取指定日期 LocalDate of = LocalDate.of(1989, 4, 12); // 获取当前日期 LocalDate now = LocalDate.now(); // 获取日期信息 int year = now.getYear(); int monthValue = now.getMonthValue(); int dayOfMonth = now.getDayOfMonth(); DayOfWeek dayOfWeek = now.getDayOfWeek();
LocalTime类
// LocalTime类: 获取时间信息。格式为 16:38:54.158549300 // 获取指定时间 LocalTime time = LocalTime.of(12, 13, 35, 129_900_000); // 获取当前时间 LocalTime nowTime = LocalTime.now(); // 获取时间信息 int hour = nowTime.getHour(); int minute = nowTime.getMinute(); int second = nowTime.getSecond(); int nano = nowTime.getNano();
LocalDateTime类
// LocalDateTime类: 获取日期时间信息。格式为 2018-09-06T15:33:56.750 // 得到指定日期时间 LocalDateTime dateTime = LocalDateTime.of(1985, 4, 15, 12, 12, 12); // 得到当前日期时间 LocalDateTime localDateTime = LocalDateTime.now(); // 获取日期时间信息 int year1 = localDateTime.getYear(); int monthValue1 = localDateTime.getMonthValue(); int dayOfMonth1 = localDateTime.getDayOfMonth(); int hour1 = localDateTime.getHour(); int minute1 = localDateTime.getMinute(); int second1 = localDateTime.getSecond(); int nano1 = localDateTime.getNano();
获取当天的零点(LocalDateTime)
LocalDateTime now = LocalDateTime.now(); LocalDateTime minDay = LocalDateTime.of(now.toLocalDate(), LocalTime.MIN);
当天的最后时间(LocalDateTime)
LocalDateTime now = LocalDateTime.now(); LocalDateTime maxOfDay = LocalDateTime.of(now.toLocalDate(), LocalTime.MAX);
三、时间格式转换（Date、LocalDateTime）
Date转为LocalDateTime
Date date = new Date(); Instant instant = date.toInstant(); ZoneId zoneId = ZoneId.systemDefault(); LocalDateTime localDateTime = instant.atZone(zoneId).toLocalDateTime();
四、时间格式化与解析
DateTime类型：
// 得到当前日期时间(yyyy-MM-dd) LocalDate now = LocalDate.now(); DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd"); // 将日期时间格式化为字符串(yyyy-MM-dd) String format = now.format(formatter); // 将字符串解析为日期时间(yyyy-MM-dd) LocalDate parse = LocalDate.parse("1999-12-12", formatter);
LocalDateTime类
// LocalDateTime类: 获取日期时间信息。格式为 2018-09-06T15:33:56.750 // 得到当前日期时间 LocalDateTime now = LocalDateTime.now(); DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); // 将日期时间格式化为字符串 String format = now.format(formatter); // 将字符串解析为日期时间 LocalDateTime parse = LocalDateTime.parse("1999-12-12 12:12:12", formatter);
五、修改时间
LocalDateTime类和LocalDateTime类和LocalDateTime类：具体方法基本一致，这个只介绍LocalDateTime类的使用。
修改时间
// LocalDateTime类: 获取日期时间信息。格式为 2018-09-06T15:33:56.750 // 得到当前日期时间 LocalDateTime localDateTime = LocalDateTime.now(); // 修改年份 LocalDateTime setYear = localDateTime.withYear(1995); // 修改月份 LocalDateTime setMonth = localDateTime.withMonth(9); // 修改日期 LocalDateTime setDay = localDateTime.withDayOfMonth(9); // 修改小时 LocalDateTime setHour = localDateTime.withHour(9); // 修改分钟 LocalDateTime setMinute = localDateTime.withMinute(9); // 修改秒 LocalDateTime setSecond = localDateTime.withSecond(9);
增加指定时间
// 加减指定时间 // 5 年后 LocalDateTime addYear = localDateTime.plusYears(5); // 5 月后 LocalDateTime addMonth = localDateTime.plusMonths(5); // 5 天后 LocalDateTime addDay = localDateTime.plusDays(5); // 5 小时后 LocalDateTime addHours = localDateTime.plusHours(5); // 5 分钟后 LocalDateTime addMinutes = localDateTime.plusMinutes(5); // 5 秒后 LocalDateTime addSeconds = localDateTime.plusSeconds(5);
减少指定时间
// 10 年前 LocalDateTime deleteYear = localDateTime.minusYears(10); // 10 月前 LocalDateTime deleteMonth = localDateTime.minusMonths(10); // 10 天前 LocalDateTime deleteDay = localDateTime.minusDays(10); // 10 小时前 LocalDateTime deleteHours = localDateTime.minusHours(10); // 10 分钟前 LocalDateTime deleteMinutes = localDateTime.plusMinutes(10); // 10 秒前 LocalDateTime deleteSeconds = localDateTime.minusSeconds(10);
六、日期时间的比较
LocalDateTime类和LocalDateTime类和LocalDateTime类：具体方法基本一致，这个只介绍LocalDateTime类的使用。
比较时间的早晚
// LocalDateTime类: 获取日期时间信息。格式为 2018-09-06T15:33:56.750 // 得到当前日期时间 LocalDateTime now = LocalDateTime.now(); // 10 天后 LocalDateTime addDay = now.plusDays(10); // true(now 是否早于 addDay) boolean before = now.isBefore(addDay); System.out.println(before); // false(now 是否晚于于 addDay) boolean after = now.isAfter(addDay); System.out.println(after);
七、计算日期时间差
Duration/Period类: 计算日期时间差。
- Duration：用于计算2个时间(LocalTime，时分秒)的距离
- Period：用于计算2个日期(LocalDate，年月日)的距离
- 后面的时间减去前年的时间
Duration使用：
LocalDateTime now = LocalDateTime.now(); // 10 天后 LocalDateTime addDay = now.plusDays(10); // 后面的时间减去前年的时间 Duration duration = Duration.between(now, addDay); // 相差天数 long differDay = duration.toDays(); // 相差小时 long differHours = duration.toHours(); // 相差分钟 long differMinutes = duration.toMinutes();
Period使用：
LocalDate nowDate = LocalDate.now(); LocalDate of = LocalDate.of(1998, 8, 8); // 后面的时间减去前年的时间 Period between = Period.between(nowDate, of); // 相差年 int years = between.getYears(); // 相差月 int months = between.getMonths(); // 相差天 int days = between.getDays();
八、时间戳(instant)类
Instant now = Instant.now(); // 获取从1970年1月1日 00:00:00的秒 int nano = now.getNano(); long epochSecond = now.getEpochSecond(); long l = now.toEpochMilli(); //格式化时间5秒 Instant instant = Instant.ofEpochSecond(5);
九、时间矫正器(指定某个时间)
有时我们可能需要获取例如：将日期调整到“下一个月的第一天”等操作。可以通过时间校正器来进行。
- TemporalAdjuster : 时间校正器。
- TemporalAdjusters : 该类通过静态方法提供了大量的常用TemporalAdjuster的实现。
// LocalDateTime类: 获取日期时间信息。格式为 2018-09-06T15:33:56.750 // 得到当前日期时间 LocalDateTime now = LocalDateTime.now(); TemporalAdjuster temporalAdjuster = new TemporalAdjuster() { @Override public Temporal adjustInto(Temporal temporal) { // 当前时间 LocalDateTime temporal1 = (LocalDateTime) temporal; return temporal1.plusMonths(1).withDayOfMonth(1); } }; // 将当前时间now，矫正为某个指定时间 LocalDateTime temDateTime = now.with(temporalAdjuster);
十、设置日期时间的时区
加入了对时区的支持。
- 不带时区：LocalDate、LocalTime、LocalDateTime。
- 带时区：ZonedDate、ZonedTime、ZonedDateTime。
- 其中每个时区都对应着 ID，ID的格式为 “区域/城市” 。例如 ：Asia/Shanghai 等。
ZoneId：该类中包含了所有的时区信息。
// 1. 获取所有时区的ID ZoneId.getAvailableZoneIds().forEach(System.out::println); // 2-1. 使用计算机默认时区(东8区）(2021-12-26T18:18:07.536+08:00[Asia/Shanghai]) ZonedDateTime bz = ZonedDateTime.now(); // 2-1. 使用世界标准时间(减8小时)(2021-12-26T10:18:07.537Z) ZonedDateTime now = ZonedDateTime.now(Clock.systemUTC()); // 3. 获取某个ID时区的，当前时间(2021-12-26T04:18:07.538-06:00[America/Guatemala]) ZonedDateTime now1 = ZonedDateTime.now(ZoneId.of("America/Guatemala"));
