jdk1.8 LocalTime、LocalDate、LocalDateTime 使用大全

目录

• LocalTime、LocalDate、LocalDateTime 区别
• LocalTime、LocalDate、LocalDateTime 使用
  • now 获取当前 时刻、日期、时间
  • of 获取指定 时刻、日期、时间
  • plus || minus 增加或者减少
  • 更改指定的 时间
  • isAfter || isBefore 比较大小
  • compareTo 时间比较
• LocalTime、LocalDate、LocalDateTime 相互转化
• String 与 LocalTime、LocalDate、LocalDateTime 相互转化
  • format && parse
  • Jackson 全局配置
• Date 与 LocalDate、LocalDateTime 相互转化
• Long 与 LocalDate、LocalDateTime 相互转化
• 常用时间操作方法
  • 两个时间相差时间
    • Period.between(star,end)
    • LocalDate.until
    • Duration.between(star,end)
  • TemporalAdjuster
  • TemporalAdjusters 类中预定义实现

LocalTime、LocalDate、LocalDateTime 区别

LocalTime、LocalDate、LocalDateTime是java8对日期、时间提供的新接口。
jdk1.8 之前的 SimpleDateFormat 是线程不安全的。
DateTimeFormatter是线程安全的

• LocalTime 用于时刻的计算(带有毫秒)
• LocalDate 用于日期的计算
• LocalDateTime 用于 日期+时刻 的计算
• 额外补充 时间类型 默认格式：
  • Date Tue Feb 01 00:00:00 CST 2022
  • Timestamp 2022-01-01 00:00:00.0
  • LocalDateTime 2022-01-01T00:00:00.000

LocalTime、LocalDate、LocalDateTime 使用

now 获取当前 时刻、日期、时间

LocalTime now = LocalTime.now();
>>> 获取当前时刻: 10:20:00.856

LocalDate now = LocalDate.now();
>>> 获取当前日期: 2023-04-13

LocalDateTime now = LocalDateTime.now();
>>> 获取当前时间: 2023-04-13T17:29:29.357

• LocalTime 获取当前时刻默认会带有毫秒，如果不需要毫秒的话，可以通过设置纳秒为0 保留秒 1秒 = 十亿纳秒 例如：LocalTime.now().withNano(0);
• LocalDateTime 获取当前日期，默认toString会带有 T 用于区分 日期与时刻,在项目中，可以通过全局序列化，进行统一的时间格式输出为 yyyy-MM-dd HH:mm:ss

of 获取指定 时刻、日期、时间

LocalTime ofTime = LocalTime.of(12, 0, 0);
>>> 获取指定时刻: 12:00

LocalDate ofTime = LocalDate.of(2023, 4, 13);
>>> 获取指定日期: 2023-04-13

LocalDateTime ofTime = LocalDateTime.of(2023,4,13,6,10,20,123);
>>> 获取指定时间: 2023-04-13T06:10:20.000000001
LocalDateTime ofTime = LocalDateTime.of(LocalDate.of(2023, 4, 13),LocalTime.of(12, 0, 0));
>>> 获取指定时间: 2023-04-13T12:00

• LocalDateTime.of 的参数单位分别为 年、月、日、小时、分钟、秒、纳秒
• LocaTime 常用常量

// 一天开始时的午夜时刻，“00:00”
LocalTime.MIDNIGHT
// 支持的最小时刻 “00:00” 这是一天开始时的时刻。
LocalTime.MIN
// 支持的最大时刻 “23:59:59.999999999” 这是一天结束时的时刻
LocalTime.MAX
// 中午的时刻 “12:00”
LocalTime.NOON

• 一些比较特殊的获取方式，例如：

// 根据秒数 获取 时刻 例如：第 150 秒的时刻是 00:02:30 （相似方法同理）
LocalTime.ofSecondOfDay(150)
>>> 获取指定时刻: 00:02:30

// 获取指定年限 + 天数 得到日期,例如:获取2023年第120天的日期（相似方法同理）
LocalDate.ofYearDay(2023, 120);
>>> 获取2023年第120天的日期: 2023-04-30

plus || minus 增加或者减少

// 增加 1 星期（相似方法同理）
LocalDateTime.now().plusWeeks(1);
// 增加 1 天（相似方法同理）
LocalDate.now().plusDays(1);
// 增加 1 小时（相似方法同理）
LocalTime.now().plusHours(1);

LocalDateTime.now().plus(10L, ChronoUnit.DAYS);

// 与之相反的 minus 就是减少的意思 不再举例子说明

更改指定的 时间

// 直接改变 指定时刻
LocalTime.now().withHour(12);
>>> 09:57:23.505 -> 12:57:23.505

// 直接改变 指定日期
LocalDate.now().withDayOfMonth(2);
>>> 2023-04-14 -> 2023-04-02

// 直接改变 指定时间
LocalDateTime.now().withYear(2024);
>>> 2023-04-14T09:59:20.034 -> 2024-04-14T09:59:20.034

• 其他with开头的方法大同小异，但要注意的是，如果改变的值是错误的时间，会报错的，例如：在2月份设置31天

isAfter || isBefore 比较大小

// 8:00
LocalTime time_8 = LocalTime.of(8, 0, 0);
// 9:00
LocalTime time_9 = time_8.plusHours(1);

boolean after = time_9.isAfter(time_8);
>>> 判断 9:00 是不是在 8:00 之后 >> true

boolean before = time_9.isBefore(time_8);
>>> 判断 9:00 是不是在 8:00 之前 >> false

• isAfter || isBefore 是无法比较是否相等的，LocalDate 和 LocalDateTime 均有此方法，用法都一样

compareTo 时间比较

// 8:00
LocalTime time_8 = LocalTime.of(8, 0, 0);
// 9:00
LocalTime time_9 = time_8.plusHours(1);

int i = time_9.compareTo(time_8);
>>> i = 1

int i = time_8.compareTo(time_9);
>>> i = -1

int i = time_8.compareTo(LocalTime.of(8, 0, 0));
>>> i = 0

• 此方法可对比出时间是否相等，假设 A.compareTo(B);
  • A > B = 1
  • A < B = -1
  • A = B = 0

LocalTime、LocalDate、LocalDateTime 相互转化

// LocalTime + LocalDate = LocalDateTime
LocalDateTime localDateTime = LocalTime.now().atDate(LocalDate.now());
LocalDateTime localDateTime = LocalDate.now().atTime(LocalTime.now());
LocalDateTime localDateTime = LocalDateTime.of(LocalTime.now(),LocalDate.now());

// LocalDateTime 转 LocalDate
LocalDate localDate = LocalDateTime.now().toLocalDate();

// LocalDateTime 转 LocalTime
LocalTime localTime = LocalDateTime.now().toLocalTime();

// 获取今日开始时间 2023-04-21T00:00
LocalDateTime localDateTime = LocalDate.now().atStartOfDay();
// 获取今日开始时间 2023-04-21T00:00
LocalDateTime startDateTime = LocalDateTime.of(LocalDate.now(), LocalTime.MIN);
// 获取今日结束时间 2023-04-21T23:59:59.999999999
LocalDateTime endDateTime = LocalDateTime.of(LocalDate.now(), LocalTime.MAX);

String 与 LocalTime、LocalDate、LocalDateTime 相互转化

主要使用 format 和 parse 进行转换，使用方法基本相同
使用 DateTimeFormatter.ofPattern() 定义时间格式，再进行转换
DateTimeFormatter线程安全

format && parse

LocalTime.now().toString;
>>> 默认输出格式 10:50:25.323

LocalDate.now().toString()
>>> 默认输出格式 2023-04-14

LocalDateTime.now().toString();
>>> 默认输出格式 2023-04-14T15:59:40

// LocalTime 转 String 自定义输出格式，例如：**时**分**秒 该转化的 00 不会被省略
DateTimeFormatter localTimeFormat = DateTimeFormatter.ofPattern("HH时mm分ss秒");
String time = LocalTime.now().format(localTimeFormat);
>>> 09时11分00秒

// LocalDateTime 转 String
DateTimeFormatter localTimeFormat = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
String time = LocalDateTime.now().format(localTimeFormat);
>>> 2023-04-14 15:59:40

// String 转 LocalDateTime
LocalDateTime time = LocalDateTime.parse("2023-04-14 15:59:40", localTimeFormat);

Jackson 全局配置

在Stringboot 中，可自定义配置 Jackson 的序列化输出，使接口在 输入输出 统一规范
简单举个例子

    @Bean // 装载配置
    @Primary
    @ConditionalOnMissingBean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = create();
        log.info(">>>>> JackSon 全局设置成功，版本号：{}", mapper.version());
        return mapper;
    }

    private static ObjectMapper create() {
        ObjectMapper objectMapper = new ObjectMapper();
        // 创建自定义 时间转换 模板
        JavaTimeModule timeModule = new JavaTimeModule();
        
        // 定义统一的时间格式
        DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss", Locale.CHINA);
        // 序列化 添加 LocalDateTime 类 对应的时间格式 
        timeModule.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(dateTimeFormatter));
        // 反序列化  支持时间戳
        timeModule.addDeserializer(LocalDateTime.class, new MillisOrLocalDateTimeDeserializer(dateTimeFormatter));
        
        // 定义统一的日期格式
        DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd", Locale.CHINA);
        // 序列化 添加 LocalDate 类 对应的日期格式
        timeModule.addSerializer(LocalDate.class, new LocalDateSerializer(dateFormatter));
        // 反序列化
        timeModule.addDeserializer(LocalDate.class, new LocalDateDeserializer(dateFormatter));
        
        // 注册自定义模板
        objectMapper.registerModules(createJavaTimeModules());
        return objectMapper;
    }

Date 与 LocalDate、LocalDateTime 相互转化

// Date 转 LocalDateTime
LocalDateTime localDateTime = new Date().toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
// LocalDateTime 转 Date
Date date = Date.from(LocalDateTime.now().atZone(ZoneId.systemDefault()).toInstant());

// Date转LocalDate
LocalDate localDate = new Date().toInstant().atZone(ZoneId.systemDefault()).toLocalDate();
// LocalDate 转 Date  需要先将 LocalDate 转 LocalDateTime
Date date= Date.from(LocalDate.now().atStartOfDay(ZoneId.systemDefault()).toInstant());

Long 与 LocalDate、LocalDateTime 相互转化

ZoneOffset.of("+8") 和 ZoneOffset.ofHours(8) 意义相同

long timeMillis = System.currentTimeMillis();

// 时间戳(Long) 转 LocalDateTime
LocalDateTime localDateTime = Instant.ofEpochMilli(timeMillis).atZone(ZoneOffset.ofHours(8)).toLocalDateTime();
// LocalDateTime 转 时间戳(Long) 秒级
Long second = LocalDateTime.now().toEpochSecond(ZoneOffset.ofHours(8));
// LocalDateTime 转 时间戳(Long) 毫秒级
Long milliSecond = LocalDateTime.now().toInstant(ZoneOffset.ofHours(8)).toEpochMilli();


// 时间戳(Long) 转 LocalDate
LocalDate localDate = Instant.ofEpochMilli(timeMillis).atZone(ZoneOffset.ofHours(8)).toLocalDate();
// LocalDate 转 时间戳(Long) 秒级
Long second =  LocalDate.now().atStartOfDay().toEpochSecond(ZoneOffset.ofHours(8));
// LocalDate 转 时间戳(Long) 毫秒级
Long milliSecond = LocalDate.now().atStartOfDay().toInstant(ZoneOffset.ofHours(8)).toEpochMilli();

常用时间操作方法

两个时间相差时间

Period.between(star,end)

统计 相差几年几个月几天
获得一个由两个日期之间的年数、月数和天数组成的周期，如果结束在开始之前，则此方法的结果可能是一个负周期。负号在每一年、每一个月和每一天都是一样的。

LocalDateTime star = LocalDateTime.of(2022, 3, 15, 16, 37, 10);
LocalDateTime end = LocalDateTime.of(2024, 4, 20, 16, 37, 10);
Period period = Period.between(star.toLocalDate(), end.toLocalDate());
System.out.println(">>> 两个时间相差:" + period.getYears() + "年" + period.getMonths() + "月" + period.getDays() + "日");

>>> 两个时间相差:2年1月5日

LocalDate.until

• 方法1：
  Period until(ChronoLocalDate endDateExclusive)；
  与 Period.between() 的使用相同类似，统计 相差几年几个月几天，可参考上一个案例
• 方法2：
  long until(Temporal endExclusive, TemporalUnit unit);
  支持指定单位(按年或按月或按天)分别统计

// ChronoUnit 可选择要计算的日期单位 年、月、日、小时、分钟 等等
LocalDateTime star = LocalDateTime.of(2024, 3, 20, 16, 37, 10);
LocalDateTime end = LocalDateTime.of(2024, 3, 21, 16, 37, 10);
long until = star.until(end, ChronoUnit.DAYS);
System.out.println(">>> 两个时间相差:" + until + "天");
>>> 两个时间相差:1天

// 使用 LocalDateTime 计算相隔日期，即使差了 1分钟 1毫秒 也不会计算1天
LocalDateTime star = LocalDateTime.of(2024, 3, 20, 16, 37, 10);
LocalDateTime end = LocalDateTime.of(2024, 3, 21, 16, 37, 9);
long until = star.until(end, ChronoUnit.DAYS);
System.out.println(">>> 两个时间相差:" + until + "天");
>>> 两个时间相差:0天

// 使用 LocalDate 计算相隔时差
LocalDate star = LocalDate.of(2024, 3, 20);
LocalDate end = LocalDate.of(2024, 3, 21);
long until = star.until(end, ChronoUnit.DAYS);
System.out.println(">>> 两个时间相差:" + until + "天");
>>> 两个时间相差:1天

Duration.between(star,end)

专业计算相隔时差，支持指定单位转化，天 到 纳秒 单位都支持
只能用 LocalDateTime

LocalDateTime star = LocalDateTime.of(2024, 3, 20, 16, 37, 10);
LocalDateTime end = LocalDateTime.of(2024, 3, 21, 16, 37, 10);
Duration duration = Duration.between(star, end);
System.out.println(">>> 两个时间相差:" + duration.toDays() + "天");
System.out.println(">>> 两个时间相差:" + duration.toHours() + "小时");
System.out.println(">>> 两个时间相差:" + duration.toMinutes() + "分钟");
System.out.println(">>> 两个时间相差:" + duration.toMillis() + "毫秒");
System.out.println(">>> 两个时间相差:" + duration.toNanos() + "纳秒");

>>> 两个时间相差:1天
>>> 两个时间相差:24小时
>>> 两个时间相差:1440分钟
>>> 两个时间相差:86400000毫秒
>>> 两个时间相差:86400000000000纳秒

TemporalAdjuster

TemporalAdjuster 是函数接口，在TemporalAdjusters 类中有很多预定义的实现。TemporalAdjuster仅有一个带Temporal对象参数的抽象方法adjustInto()。

TemporalAdjuster可以执行复杂的日期操作，例如，可以获得下一个星期日对于日期、当月的最后一天、下一年的第一天。当然也可以通过旧的java.util.Calendar api实现。不同的是，新api使用预定义的实现抽象出底层逻辑。

TemporalAdjusters 类中预定义实现

TemporalAdjusters类有很多预定义的static方法返回TemporalAdjuster对象，使用不同方式调节Temporal对象而与Temporal实现无关。

// 也可以使用 LocalDateTime 带时刻
LocalDate localDate = LocalDate.now(); 
// 当月第一天
localDate.with(TemporalAdjusters.firstDayOfMonth());
// 当月最后一天
localDate.with(TemporalAdjusters.lastDayOfMonth());
// 今年的第一天
localDate.with(TemporalAdjusters.firstDayOfYear());
// 今年的最后一天
localDate.with(TemporalAdjusters.lastDayOfYear());
// 下个月的第一天
localDate.with(TemporalAdjusters.firstDayOfNextMonth());
// 下一年的第一天
localDate.with(TemporalAdjusters.firstDayOfNextYear());

// 这个月的最后一个星期日
localDate.with(TemporalAdjusters.dayOfWeekInMonth(-1,DayOfWeek.SUNDAY));
// 这个月的倒数第二个星期日
localDate.with(TemporalAdjusters.dayOfWeekInMonth(-2,DayOfWeek.SUNDAY));
// 这个月的第一个星期日
localDate.with(TemporalAdjusters.dayOfWeekInMonth(-1,DayOfWeek.SUNDAY));
// 这个月的第二个星期日
localDate.with(TemporalAdjusters.dayOfWeekInMonth(-1,DayOfWeek.SUNDAY));

// 下个月的最后一个星期日
localDate.with(TemporalAdjusters.lastInMonth(DayOfWeek.SUNDAY));
// 上个星期五
localDate.with(TemporalAdjusters.previous(DayOfWeek.FRIDAY));
// 上个最近的星期五,包含今天的判断 如果今天星期五 则会返回今天日期
localDate.with(TemporalAdjusters.previousOrSame(DayOfWeek.FRIDAY));
// 下个星期一
localDate.with(TemporalAdjusters.next(DayOfWeek.MONDAY));
// 下个最近的星期一,包含今天的判断 如果今天是星期一 则会返回今天日期
localDate.with(TemporalAdjusters.nextOrSame(DayOfWeek.MONDAY));