使用 LocalDateTime 替代 Date
JDK 中的 Date 的缺点:
Date 如果不格式化,打印出的日期可读性差;
使用 SimpleDateFormat 可以对日期时间进行格式化,但是 SimpleDateFormat 并非线性安全;
Date 对时间处理比较麻烦;
Date 这个类名的命名并不严谨。
另外,《阿里巴巴开发手册》中明确禁用 static 关键字修饰 SimpleDateFormat 。
Java 官方请著名的第三方日期时间包 joda-time 的作者重新设计了与日期时间有关的 API 部分,并把它们放在了 jdk 8 的 java.time 包下。
新增了:LocalDate、LocalTime、LocalDateTime 三个类及相关新的 API 用以替代 Date 及其旧的使用方式。
1. LocalDate
只会获取 年月日 信息。
LocalDate 中并不包含『时区』信息。即,一个单独的 LocalDate 对象所表达的含义是不严谨的。 LocalTime 和 LocalDateTime 也一样。
创建 LocalDate 对象
LocalDate localDate = LocalDate.now();
LocalDate localDate = LocalDate.of(2000, 1, 1);
获取年、月、日、星期几
LocalDate localDate = LocalDate.now();
int year = localDate.getYear();
int year = localDate.get(ChronoField.YEAR);
Month month = localDate.getMonth();
int month = localDate.get(ChronoField.MONTH_OF_YEAR);
int day = localDate.getDayOfMonth();
int day = localDate.get(ChronoField.DAY_OF_MONTH);
DayOfWeek dayOfWeak = localDate.getDayOfWeek();
int dayOfWeak = localDate.get(ChronoField.DAY_OF_WEEK);
2. LocalTime
只会获取 时分秒 信息。
创建 LocalTime 对象
LocalTime localTime = LocalTime.now();
LocalTime localTime = LocalTime.of(17, 30, 0);
获取时分秒
int hour = localTime.getHour();
int hour = localTime.get(ChronoField.HOUR_OF_DAY);
int minute = localTime.getMinute();
int minute = localTime.get(ChronoField.MINUTE_OF_HOUR);
int second = localTime.getSecond();
int second = localTime.get(ChronoField.SECOND_OF_MINUTE);
3. LocaDateTime
获取 年月日时分秒,等于 LocalDate + LocalTime 。
创建 LocalDateTime
LocalDateTime localDateTime = LocalDateTime.now();
LocalDateTime localDateTime = LocalDateTime.of(2019, Month.SEPTEMBER, 10, 14, 46, 56);
LocalDateTime localDateTime = LocalDateTime.of(localDate, localTime);
LocalDateTime localDateTime = localDate.atTime(localTime);
LocalDateTime localDateTime = localTime.atDate(localDate);
获取 LocalDate
LocalDate localDate = localDateTime.toLocalDate();
获取 LocalTime
LocalTime localTime = localDateTime.toLocalTime();
4. Instant
在 Java 中,一个 Instant 对象标识时间轴上的一个点,代表着一个概念上的瞬间。
『原点』是众所周知的 1970 年 1 月 1 日的午夜,此时本初子午线正在穿过伦敦格林威治皇家天文台。从『原点』开始,时间按照每天 86400 秒进行正向、反向计算,向前、向后分别以纳秒为单位。
warning 注意
Instant 是有时区概念的,在你未指定时,它的默认时区时 0 时区,即,格林威治时间。
虽然 Instant 内部是以纳秒为单位进行存储、运算的,但是很显然你可以将它转换成相较于『原点 (epoch) 』的时、分、秒。
在编程世界中,我们日常生活中所说的『秒』使用的是 second ;而『相较于原点的秒』使用的是 epoch second 。 epoch 是时代、纪元等含义。
另外,在 Java 8 中,使用 Duration 对象来代表两个 Instant 之间的时间跨度。
创建 Instant 对象
Instant instant = Instant.now();
获取秒数
long currentSecond = instant.getEpochSecond();
获取毫秒数
long currentMilli = instant.toEpochMilli();
个人觉得如果只是为了获取秒数或者毫秒数,使用 System.currentTimeMillis() 来得更为方便。
5. 修改 LocalDate、LocalTime、LocalDateTime、Instant
LocalDate、LocalTime、LocalDateTime、Instant 为『不可变对象』,修改这些对象对象会返回一个副本,即生成并返回一个新对象。
增加、减少年数、月数、天数等 以 LocalDateTime 为例
LocalDateTime localDateTime = LocalDateTime.of(2019, Month.SEPTEMBER, 10, 14, 46, 56);
// 增加一年
localDateTime = localDateTime.plusYears(1);
localDateTime = localDateTime.plus(1, ChronoUnit.YEARS);
// 减少一个月
localDateTime = localDateTime.minusMonths(1);
localDateTime = localDateTime.minus(1, ChronoUnit.MONTHS);
通过 with 修改某些值
// 修改年为 2019
localDateTime = localDateTime.withYear(2020);
// 修改为 2022
localDateTime = localDateTime.with(ChronoField.YEAR, 2022);
// 还可以修改月、日
6. 使用 TemporalAdjuster 和 TemporalAdjusters
有的时候,你需要进行一些更加复杂的日期操作,比如,将日期调整到下个周日、下个工作日,或者是本月的最后一天。这时,你可以使用重载版本的 withXXX 方法,向其传递一个提供了更多定制化选择的 TemporalAdjuster 对象, 更加灵活地处理日期。
比如有些时候想知道这个月的最后一天是几号、下个周末是几号,通过提供的时间和日期API可以很快得到答案。
对于最常见的用例,日期和时间 API 已经提供了大量预定义的 TemporalAdjuster 对象。你可以通过 TemporalAdjusters (注意,此处有 s) 类的静态工厂方法访问它们。
TemporalAdjusters 类中的常用工厂方法:
dayOfWeekInMonth 创建一个新的日期,它的值为同一个月中每一周的第几天
firstDayOfMonth 创建一个新的日期,它的值为当月的第一天
firstDayOfNextMonth 创建一个新的日期,它的值为下月的第一天
firstDayOfNextYear 创建一个新的日期,它的值为明年的第一天
firstDayOfYear 创建一个新的日期,它的值为当年的第一天
firstInMonth 创建一个新的日期,它的值为同一个月中,第一个符合星期几要求的值
lastDayOfMonth 创建一个新的日期,它的值为当月的最后一天
lastDayOfNextMonth 创建一个新的日期,它的值为下月的最后一天
lastDayOfNextYear 创建一个新的日期,它的值为明年的最后一天
lastDayOfYear 创建一个新的日期,它的值为今年的最后一天
lastInMonth 创建一个新的日期,它的值为同一个月中,最后一个符合星期几要求的值
next / previous 创建一个新的日期,并将其值设定为日期调整后或者调整前,第一个符合指定星 期几要求的日期
nextOrSame / previousOrSame 创建一个新的日期,并将其值设定为日期调整后或者调整前,第一个符合指定星 期几要求的日期,如果该日期已经符合要求,直接返回该对象
7. 格式化时间
DateTimeFormatter 默认提供了多种格式化方式,如果默认提供的不能满足要求,可以通过 DateTimeFormatter 的 ofPattern 方法创建自定义格式化方式。
LocalDate localDate = LocalDate.of(2019, 9, 10);
String s1 = localDate.format(DateTimeFormatter.BASIC_ISO_DATE);
String s2 = localDate.format(DateTimeFormatter.ISO_LOCAL_DATE);
// 自定义格式化
DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");
String s3 = localDate.format(dateTimeFormatter);
8. 解析时间
相较于传统的 SimpleDateFormat,DateTimeFormatter 是线程安全的
LocalDate localDate1 = LocalDate.parse("20190910", DateTimeFormatter.BASIC_ISO_DATE);
LocalDate localDate2 = LocalDate.parse("2019-09-10", DateTimeFormatter.ISO_LOCAL_DATE);
Date 与 LocalDate 互转:
Date 转 LocalDate
// Date 转 LocalDate
public static LocalDate date2LocalDate(Date date) {
return (date == null) ? (null) : (date.toInstant().atZone(ZoneId.systemDefault()).toLocalDate());
}
LocalDate 转 Date
// LocalDate转Date
public static Date localDate2Date(LocalDate localDate) {
return (localDate == null) ? (null) : (Date.from(localDate.atStartOfDay(ZoneId.systemDefault()).toInstant()));
}
9. 带时区的时间
LocalDate、LocalTime 和 LocalDateTime 是不带时区信息的。在 JDK 8 中,带有时区信息的日期时间类是 ZonedDateTime 。
因特网编号管理局 (IANA) 维护着一份全球所有已知时区的数据库(http://www.iana.org/time-zones),每年会更新几次(这些更新主要处理夏令时规则的改变)。Java 就是使用了 IANA 的数据库。
在 Java 中,每个时区都有一个 ID,例如 Asia/Shanghai 。想要获得所有可用的时区,你可以调用 ZoneId.getAvailableZoneIds() 。 大概有 600 个。
如果你想获得 ZonedDateTime 对象,你有 2 种途径:
直接使用 ZonedDateTime.of() 方法创建;
先创建一个 LocalDateTime 对象 (它不含时区概念) ,再调用它的 atZone 方法,赋予它时区的概念,生成 ZonedDateTime 对象。
10. SpringBoot 中应用 LocalDateTime
将 LocalDateTime 字段以时间戳的方式返回给前端。
添加日期转化类:
public class LocalDateTimeConverter extends JsonSerializer<LocalDateTime> {
@Override
public void serialize(LocalDateTime value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
gen.writeNumber(value.toInstant(ZoneOffset.of("+8")).toEpochMilli());
}
}
并在 LocalDateTime 字段上添加 @JsonSerialize(using = LocalDateTimeConverter.class) 注解,如下:
@JsonSerialize(using = LocalDateTimeConverter.class)
protected LocalDateTime gmtModified;
将 LocalDateTime 字段以指定格式化日期的方式返回给前端
在 LocalDateTime 字段上添加 @JsonFormat(shape=JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss") 注解即可,如下:
@JsonFormat(shape=JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss")
protected LocalDateTime gmtModified;
对前端传入的日期进行格式化
在 LocalDateTime 字段上添加 @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") 注解即可,如下:
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
protected LocalDateTime gmtModified;
Java Date and Time API 用在持久层
LocalDateTime in Mybatis
MyBatis 从 3.4.5 版本开始就完全支持这种类型了,不在需要自己去写类型转换 。
LocalDateTime in spring-data-jpa
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-java8</artifactId>
</dependency>
LocalDateTime in spring-data-redis
<dependency>
<groupId>com.fasterxml.jackson.datatype</groupId>
<artifactId>jackson-datatype-jsr310</artifactId>
</dependency>
原文链接:https://blog.csdn.net/m0_73393501/article/details/129402511