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

LocalTime、LocalDate、LocalDateTime 区别
LocalTime、LocalDate、LocalDateTime 使用
LocalTime、LocalDate、LocalDateTime 相互转化
String 与 LocalTime、LocalDate、LocalDateTime 相互转化
- format && parse
- Jackson 全局配置
Date 与 LocalDate、LocalDateTime 相互转化
Long 与 LocalDate、LocalDateTime 相互转化
常用时间操作方法

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));