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

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

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

为什么需要 LocalDateLocalTimeLocalDateTime
Date 如果不格式化,打印出的日期可读性差

  1. Tue Sep 10 09:34:04 CST 2019

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

  1. private StringBuffer format(Date date, StringBuffer toAppendTo, FieldDelegate delegate) {
  2. // Convert input date to time field list
  3. calendar.setTime(date);
  4. boolean useDateFormatSymbols = useDateFormatSymbols();
  5. for (int i = 0; i < compiledPattern.length; ) {
  6. int tag = compiledPattern[i] >>> 8;
  7. int count = compiledPattern[i++] & 0xff;
  8. if (count == 255) {
  9. count = compiledPattern[i++] << 16;
  10. count |= compiledPattern[i++];
  11. }
  12. switch (tag) {
  13. case TAG_QUOTE_ASCII_CHAR:
  14. toAppendTo.append((char)count);
  15. break;
  16. case TAG_QUOTE_CHARS:
  17. toAppendTo.append(compiledPattern, i, count);
  18. i += count;
  19. break;
  20. default:
  21. subFormat(tag, count, delegate, toAppendTo, useDateFormatSymbols);
  22. break;
  23. }
  24. }
  25. return toAppendTo;
  26. }

calendar 是共享变量,并且这个共享变量没有做线程安全控制。
当多个线程同时使用相同的 SimpleDateFormat 对象【如用 static 修饰的 SimpleDateFormat】调用 format 方法时。
多个线程会同时调用 calendar.setTime 方法,可能一个线程刚设置好 time 值,另外的一个线程马上把设置的 time 值给修改了,导致返回的格式化时间可能是错误的。
多线程情况下使用 SimpleDateFormat 需格外注意 SimpleDateFormat 除了 format 是线程不安全以外,parse 方法也是线程不安全的。

parse方法实际调用 alb.establish(calendar).getTime() 方法来解析,alb.establish(calendar) 方法里主要完成了

  • 重置日期对象 cal 的属性值
  • 使用 calb 中中属性设置 cal
  • 返回设置好的 cal 对象

但是这三步不是原子操作
多线程并发如何保证线程安全,避免线程之间共享一个 SimpleDateFormat 对象:

  • 每个线程使用时都创建一次 SimpleDateFormat 对象 => 创建和销毁对象的开销大
  • 对使用 format 和 parse 方法的地方进行加锁 => 线程阻塞性能差
  • 使用 ThreadLocal 保证每个线程最多只创建一次 SimpleDateFormat 对象 => 较好的方法

Date 对时间处理比较麻烦,比如想获取某年、某月、某星期,以及 n 天以后的时间。
如果用 Date 来处理的话真是太难了,你可能会说 Date 类不是有 getYear、getMonth 这些方法吗,获取年月日很 Easy,但都被弃用了啊
Come On 一起使用java8全新的日期和时间API

LocalDate

只会获取年月日

创建LocalDate

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

获取年、月、日、星期几

  1. int year = localDate.getYear();
  2. int year1 = localDate.get(ChronoField.YEAR);
  3. Month month = localDate.getMonth();
  4. int month1 = localDate.get(ChronoField.MONTH_OF_YEAR);
  5. int day = localDate.getDayOfMonth();
  6. int day1 = localDate.get(ChronoField.DAY_OF_MONTH);
  7. DayOfWeek dayOfWeek = localDate.getDayOfWeek();
  8. int dayOfWeek1 = localDate.get(ChronoField.DAY_OF_WEEK);

LocalTime

只会获取几点几分几秒

创建LocalTime

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

获取时分秒

  1. //获取小时
  2. int hour = localTime.getHour();
  3. int hour1 = localTime.get(ChronoField.HOUR_OF_DAY);
  4. //获取分
  5. int minute = localTime.getMinute();
  6. int minute1 = localTime.get(ChronoField.MINUTE_OF_HOUR);
  7. //获取秒
  8. int second = localTime.getSecond();
  9. int second1 = localTime.get(ChronoField.SECOND_OF_MINUTE);

LocalDateTime

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

创建LocalDateTime

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

获取LocalDate

  1. LocalDate localDate2 = localDateTime.toLocalDate();

获取LocalTime

  1. LocalTime localTime2 = localDateTime.toLocalTime();

Instant

创建Instant对象

  1. Instant instant = Instant.now();

获取秒数

  1. long currentSecond = instant.getEpochSecond();

获取毫秒数

  1. long currentMilli = instant.toEpochMilli();

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

修改LocalDate、LocalTime、LocalDateTime、Instant

LocalDate、LocalTime、LocalDateTime、Instant为不可变对象,修改这些对象对象会返回一个副本
增加、减少年数、月数、天数等 以LocalDateTime为例:

  1. LocalDateTime localDateTime = LocalDateTime.of(2019, Month.SEPTEMBER, 10, 14, 46, 56);
  2. //增加一年
  3. localDateTime = localDateTime.plusYears(1);
  4. localDateTime = localDateTime.plus(1, ChronoUnit.YEARS);
  5. //减少一个月
  6. localDateTime = localDateTime.minusMonths(1);
  7. localDateTime = localDateTime.minus(1, ChronoUnit.MONTHS);

通过with修改某些值

  1. //修改年为2019
  2. localDateTime = localDateTime.withYear(2020);
  3. //修改为2022
  4. localDateTime = localDateTime.with(ChronoField.YEAR, 2022);

还可以修改月、日

时间计算

比如有些时候想知道这个月的最后一天是几号、下个周末是几号,通过提供的时间和日期API可以很快得到答案
比如通过firstDayOfYear()返回了当前日期的第一天日期,还有很多方法这里不在举例说明

  1. LocalDate localDate = LocalDate.now();
  2. // 获取本年的第 n 天
  3. LocalDate localDate1 = localDate.withDayOfYear(100);
  4. // 获取本月的第 n 天
  5. LocalDate localDate2 = localDate.withDayOfMonth(3);
  6. // 累加三周
  7. LocalDate localDate3 = localDate.plusWeeks(3);

格式化时间

  1. LocalDate localDate = LocalDate.now();
  2. String format = localDate.format(DateTimeFormatter.BASIC_ISO_DATE);
  3. String format1 = localDate.format(DateTimeFormatter.ISO_LOCAL_DATE);
  4. //自定义格式化
  5. DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
  6. String format2 = localDate.format(dateTimeFormatter);

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

解析时间

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

和SimpleDateFormat相比,DateTimeFormatter是线程安全的

小结

LocalDateTime:Date有的我都有,Date没有的我也有,日期选择在 SpringBoot 中应用 LocalDateTime 将 LocalDateTime 字段以时间戳的方式返回给前端
添加日期转化类

  1. public class LocalDateTimeConverter extends JsonSerializer<LocalDateTime> {
  2. @Override
  3. public void serialize(LocalDateTime value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
  4. gen.writeNumber(value.toInstant(ZoneOffset.of("+8")).toEpochMilli());
  5. }
  6. }

并在LocalDateTime字段上添加 @JsonSerialize(using = LocalDateTimeConverter.class) 注解,如下:

  1. @JsonSerialize(using = LocalDateTimeConverter.class)
  2. protected LocalDateTime gmtModified;

将 LocalDateTime 字段以指定格式化日期的方式返回给前端。
在 LocalDateTime 字段上添加 @JsonFormat(shape=JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss") 注解即可,如下:

  1. @JsonFormat(shape=JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss")
  2. protected LocalDateTime gmtModified;

对前端传入的日期进行格式化 在 LocalDateTime 字段上添加 @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") 注解即可,如下:

  1. @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
  2. protected LocalDateTime gmtModified;

转自 https://mp.weixin.qq.com/s/M6MJ2OXkfy6P70YEZIru_Q