阿里規定代碼中禁用這個，爲何？

雲棲號資訊：【點擊查看更多行業資訊】
在這裏您可以找到不同行業的第一手的上雲資訊，還在等什麼，快來！

在項目開發過程中經常遇到時間處理，但你真的用對了嗎，理解阿里巴巴開發手冊中禁用static修飾SimpleDateFormat嗎？
通過閱讀本篇文章你將瞭解到：

• 爲什麼需要LocalDate、LocalTime、LocalDateTime【java8新提供的類】
• java8新的時間API的使用方式，包括創建、格式化、解析、計算、修改

爲什麼需要LocalDate、LocalTime、LocalDateTime

1.Date如果不格式化，打印出的日期可讀性差

Tue Sep 10 09:34:04 CST 2019

2.使用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)方法裏主要完成了：

• 重置日期對象cal的屬性值
• 使用calb中中屬性設置cal
• 返回設置好的cal對象

但是這三步不是原子操作

多線程併發如何保證線程安全 - 避免線程之間共享一個SimpleDateFormat對象，每個線程使用時都創建一次SimpleDateFormat對象 => 創建和銷燬對象的開銷大 - 對使用format和parse方法的地方進行加鎖 => 線程阻塞性能差 - 使用ThreadLocal保證每個線程最多隻創建一次SimpleDateFormat對象 => 較好的方法
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
1.將LocalDateTime字段以時間戳的方式返回給前端
添加日期轉化類

public class LocalDateTimeConverter extends JsonSerializer {

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

2.將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;

3.對前端傳入的日期進行格式化
在LocalDateTime字段上添加@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")註解即可，如下：

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

>【雲棲號在線課堂】每天都有產品技術專家分享！
> 課程地址：https://yqh.aliyun.com/zhibo

> 立即加入社羣，與專家面對面，及時瞭解課程最新動態！
> 【雲棲號在線課堂 社羣】https://c.tb.cn/F3.Z8gvnK

原文發佈時間：2020-06-17
本文作者：互聯網架構師