为什么建议使用你 LocalDateTime ，而不是 Date？

清疚 2021-07-31 15:58 508阅读 0赞

点击上方 ，选择 设为星标

优质文章，及时送达

![640?wx\_fmt=jpeg][640_wx_fmt_jpeg]

作者 | 何甜甜在吗

来源 | juejin.im/post/5d7787625188252388753eae

> 在项目开发过程中经常遇到时间处理，但是你真的用对了吗，理解阿里巴巴开发手册中禁用static修饰SimpleDateFormat吗

通过阅读本篇文章你将了解到：

*  为什么需要 `LocalDate` 、 `LocalTime` 、 `LocalDateTime` 【java8新提供的类】
 *  `java8` 新的时间 `API` 的使用方式，包括创建、格式化、解析、计算、修改

# 为什么需要LocalDate、LocalTime、LocalDateTime #

`Date` 如果不格式化，打印出的日期可读性差

Tue Sep 10 09:34:04 CST 2019

使用 `SimpleDateFormat` 对时间进行格式化，但 `SimpleDateFormat` 是线程不安全的 `SimpleDateFormat` 的 `format` 方法最终调用代码：

private StringBuffer format(Date date, StringBuffer toAppendTo,
                                FieldDelegate delegate) {
          // Convert input date to time field list
          calendar.setTime(date);
      boolean useDateFormatSymbols = useDateFormatSymbols();
    
      for (int i = 0; i < compiledPattern.length; ) {
          int tag = compiledPattern[i] >>> 8;
          int count = compiledPattern[i++] & 0xff;
          if (count == 255) {
              count = compiledPattern[i++] << 16;
              count |= compiledPattern[i++];
          }
    
          switch (tag) {
          case TAG_QUOTE_ASCII_CHAR:
              toAppendTo.append((char)count);
              break;
    
          case TAG_QUOTE_CHARS:
              toAppendTo.append(compiledPattern, i, count);
              i += count;
              break;
    
          default:
              subFormat(tag, count, delegate, toAppendTo, useDateFormatSymbols);
              break;
          }
      }
      return toAppendTo;
      }

`calendar` 是共享变量，并且这个共享变量没有做线程安全控制。当多个线程同时使用 **相同的SimpleDateFormat对象**【如用 `static` 修饰的 `SimpleDateFormat` 】调用 `format` 方法时，多个线程会同时调用 `calendar.setTime` 方法，可能一个线程刚设置好 `time` 值另外的一个线程马上把设置的 `time` 值给修改了导致返回的格式化时间可能是错误的。在多并发情况下使用 `SimpleDateFormat` 需格外注意 `SimpleDateFormat` 除了 `format` 是线程不安全以外， `parse` 方法也是线程不安全的。 `parse` 方法实际调用 `alb.establish(calendar).getTime()` 方法来解析， `alb.establish(calendar)` 方法里主要完成了

*  1、 重置日期对象cal的属性值
 *  2 使用calb中中属性设置cal
 *  3. 返回设置好的cal对象

但是这三步不是原子操作

多线程并发如何保证线程安全 - 避免线程之间共享一个 `SimpleDateFormat` 对象，每个线程使用时都创建一次 `SimpleDateFormat` 对象 => 创建和销毁对象的开销大 - 对使用 `format` 和 `parse` 方法的地方进行加锁 => 线程阻塞性能差 - 使用 `ThreadLocal` 保证每个线程最多只创建一次 `SimpleDateFormat` 对象 => 较好的方法

tips：欢迎关注微信公众号：Java后端，获取每日技术博文推送。

*  `Date` 对时间处理比较麻烦，比如想获取某年、某月、某星期，以及 `n` 天以后的时间，如果用 `Date` 来处理的话真是太难了，你可能会说 `Date` 类不是有 `getYear` 、 `getMonth` 这些方法吗，获取年月日很 `Easy` ，但都被弃用了啊

# Come On 一起使用java8全新的日期和时间API #

#### LocalDate ####

只会获取年月日

创建 `LocalDate`

//获取当前年月日
    LocalDate localDate = LocalDate.now();
    //构造指定的年月日
    LocalDate localDate1 = LocalDate.of(2019, 9, 10);

获取年、月、日、星期几

int year = localDate.getYear();
    int year1 = localDate.get(ChronoField.YEAR);
    Month month = localDate.getMonth();
    int month1 = localDate.get(ChronoField.MONTH_OF_YEAR);
    int day = localDate.getDayOfMonth();
    int day1 = localDate.get(ChronoField.DAY_OF_MONTH);
    DayOfWeek dayOfWeek = localDate.getDayOfWeek();
    int dayOfWeek1 = localDate.get(ChronoField.DAY_OF_WEEK);

#### LocalTime ####

只会获取几点几分几秒

创建 `LocalTime`

LocalTime localTime = LocalTime.of(13, 51, 10);
    LocalTime localTime1 = LocalTime.now();

获取时分秒

//获取小时
    int hour = localTime.getHour();
    int hour1 = localTime.get(ChronoField.HOUR_OF_DAY);
    //获取分
    int minute = localTime.getMinute();
    int minute1 = localTime.get(ChronoField.MINUTE_OF_HOUR);
    //获取秒
    int second = localTime.getSecond();
    int second1 = localTime.get(ChronoField.SECOND_OF_MINUTE);

#### LocalDateTime ####

获取年月日时分秒，等于LocalDate+LocalTime

创建 `LocalDateTime`

LocalDateTime localDateTime = LocalDateTime.now();
    LocalDateTime localDateTime1 = LocalDateTime.of(2019, Month.SEPTEMBER, 10, 14, 46, 56);
    LocalDateTime localDateTime2 = LocalDateTime.of(localDate, localTime);
    LocalDateTime localDateTime3 = localDate.atTime(localTime);
    LocalDateTime localDateTime4 = localTime.atDate(localDate);

获取 `LocalDate`

LocalDate localDate2 = localDateTime.toLocalDate();

获取 `LocalTime`

LocalTime localTime2 = localDateTime.toLocalTime();

#### Instant ####

获取秒数

创建 `Instant` 对象

Instant instant = Instant.now();

获取秒数

long currentSecond = instant.getEpochSecond();

获取毫秒数

long currentMilli = instant.toEpochMilli();

个人觉得如果只是为了获取秒数或者毫秒数，使用 `System.currentTimeMillis()` 来得更为方便

#### 修改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);

还可以修改月、日

#### 时间计算 ####

比如有些时候想知道这个月的最后一天是几号、下个周末是几号，通过提供的时间和日期API可以很快得到答案

LocalDate localDate = LocalDate.now();
    LocalDate localDate1 = localDate.with(firstDayOfYear());

比如通过 `firstDayOfYear()` 返回了当前日期的第一天日期，还有很多方法这里不在举例说明

#### 格式化时间 ####

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

`DateTimeFormatter` 默认提供了多种格式化方式，如果默认提供的不能满足要求，可以通过 `DateTimeFormatter` 的 `ofPattern` 方法创建自定义格式化方式

#### 解析时间 ####

LocalDate localDate1 = LocalDate.parse("20190910", DateTimeFormatter.BASIC_ISO_DATE);
    LocalDate localDate2 = LocalDate.parse("2019-09-10", DateTimeFormatter.ISO_LOCAL_DATE);

和 `SimpleDateFormat` 相比， `DateTimeFormatter` 是线程安全的

小结

LocalDateTime`：`Date`有的我都有，`Date`没有的我也有，日期选择请`Pick Me

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;

--------------------

\-END-

如果看到这里，说明你喜欢这篇文章，请 **转发** **、点赞**。微信搜索「web\_resource」，关注后回复「进群」或者扫描下方二维码即可进入无广告交流群。

**↓扫描二维码进群↓**

![640?wx\_fmt=png][640_wx_fmt_png]

--------------------

**推** **荐** **阅** **读 **

***1.***

***2. ***

***3.  ***

***4. *** *** ***

***5.***

![640?wx\_fmt=jpeg][640_wx_fmt_jpeg 1]

学Java，请关注公众号：Java后端

**喜** **欢** **文** **章** **，** **点** **个** **在看 ** ![640?wx\_fmt=jpeg][640_wx_fmt_jpeg 2]

[640_wx_fmt_jpeg]: /images/20210731/0a922a8f399643f09d63ca1d2b0021ad.png?wx_fmt=jpeg
[640_wx_fmt_png]: /images/20210731/972e6bdcbc78411d99cd719e7f7eb25c.png?wx_fmt=png
[640_wx_fmt_jpeg 1]: /images/20210731/9cde750bab3d47e2801334e1a30c4e2e.png?wx_fmt=jpeg
[640_wx_fmt_jpeg 2]: /images/20210731/3d2fd94cade545dcb18ed0d9d8605835.png?wx_fmt=jpeg