JDK8的LocalDateTime用法

參考資料：好好學Java  https://mp.weixin.qq.com/s/Dd_7yUh3lq3TqE2cjsYXvw

 

JDK8新特性里提供了3個時間類：LocalDate、LocalTime、LocalDateTime

在項目開發中，已經需要對Date類型進行格式，否則可讀性很差，格式化Date類型要使用SimpleDateFormat，但SimpleDateFormat是現成不安全的。

1. 為什么需要LocalDate、LocalTime、LocalDateTime

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

Tue Sep 10 09:34:04 CST 2019

1.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)方法里主要完成了

　　a、重置日期對象cal的屬性值

　　b、使用calb中中屬性設置cal

　　c、返回設置好的cal對象

　　但是這三步不是原子操作。

　　多線程並發如何保證線程安全 - 避免線程之間共享一個SimpleDateFormat對象，每個線程使用時都創建一次SimpleDateFormat對象 => 創建和銷毀對象的開銷大 - 對使用format和parse方法的地方進行加鎖 => 線程阻塞性能差 - 使用ThreadLocal保證每個線程最多只創建一次SimpleDateFormat對象 => 較好的方法。Date對時間處理比較麻煩，比如想獲取某年、某月、某星期，以及n天以后的時間，如果用Date來處理的話真是太難了，你可能會說Date類不是有getYear、getMonth這些方法嗎，獲取年月日很Easy，但都被棄用了。

　　

2. Java8全新的日期和時間API

2.1 LocalDate

　　LocalDate是日期處理類，具體API如下：

// 獲取當前日期
LocalDate now = LocalDate.now();
// 設置日期
LocalDate localDate = LocalDate.of(2019, 9, 10);
// 獲取年
int year = localDate.getYear();     //結果：2019
int year1 = localDate.get(ChronoField.YEAR); //結果：2019
// 獲取月
Month month = localDate.getMonth();   // 結果：SEPTEMBER
int month1 = localDate.get(ChronoField.MONTH_OF_YEAR); //結果：9
// 獲取日
int day = localDate.getDayOfMonth();   //結果：10
int day1 = localDate.get(ChronoField.DAY_OF_MONTH); // 結果：10
// 獲取星期
DayOfWeek dayOfWeek = localDate.getDayOfWeek();   //結果：TUESDAY
int dayOfWeek1 = localDate.get(ChronoField.DAY_OF_WEEK); //結果：2

 

2.2 LocalTime

　　LocalTime是時間處理類，具體API如下：

// 獲取當前時間
LocalTime now = LocalTime.now();
// 設置時間
LocalTime localTime = LocalTime.of(13, 51, 10);
//獲取小時
int hour = localTime.getHour();    // 結果：13
int hour1 = localTime.get(ChronoField.HOUR_OF_DAY); // 結果：13
//獲取分
int minute = localTime.getMinute();  // 結果：51
int minute1 = localTime.get(ChronoField.MINUTE_OF_HOUR); // 結果：51
//獲取秒
int second = localTime.getSecond();   // 結果：10
int second1 = localTime.get(ChronoField.SECOND_OF_MINUTE); // 結果：10

 

2.3 LocalDateTime

　　LocalDateTime可以設置年月日時分秒，相當於LocalDate + LocalTime

// 獲取當前日期時間
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();

 

2.4 Instant

// 創建Instant對象
Instant instant = Instant.now();
// 獲取秒
long currentSecond = instant.getEpochSecond();
// 獲取毫秒
long currentMilli = instant.toEpochMilli();

　　如果只是為了獲取秒數或者毫秒數，使用System.currentTimeMillis()來得更為方便

 

2.5 修改LocalDate、LocalTime、LocalDateTime、Instant

　　LocalDate、LocalTime、LocalDateTime、Instant為不可變對象，修改這些對象對象會返回一個副本。增加、減少年數、月數、天數等 以LocalDateTime為例。

// 創建日期：2019-09-10 14:46:56
LocalDateTime localDateTime = LocalDateTime.of(2019, Month.SEPTEMBER, 10, 14, 46, 56);
//增加一年
localDateTime = localDateTime.plusYears(1);  //結果： 2020-09-10 14:46:56
localDateTime = localDateTime.plus(1, ChronoUnit.YEARS); //結果： 2021-09-10 14:46:56
//減少一個月
localDateTime = localDateTime.minusMonths(1);  //結果： 2021-08-10 14:46:56
localDateTime = localDateTime.minus(1, ChronoUnit.MONTHS); //結果： 2021-07-10 14:46:56

　　通過with修改某些值，年月日時分秒都可以通過with方法設置。

//修改年為2019
localDateTime = localDateTime.withYear(2020);
//修改為2022
localDateTime = localDateTime.with(ChronoField.YEAR, 2022);

　　日期計算。比如有些時候想知道這個月的最后一天是幾號、下個周末是幾號，通過提供的時間和日期API可以很快得到答案 。TemporalAdjusters提供的各種日期時間格式化的靜態類，比如firstDayOfYear是當前日期所屬年的第一天

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

 　　格式化時間。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);

　　解析時間。和SimpleDateFormat相比，DateTimeFormatter是線程安全的

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

　　Date與LocalDateTime轉換。

/**
  * LocalDateTime轉毫秒時間戳
  * @param localDateTime LocalDateTime
  * @return 時間戳
  */
public static Long localDateTimeToTimestamp(LocalDateTime localDateTime) {
    try {
        ZoneId zoneId = ZoneId.systemDefault();
        Instant instant = localDateTime.atZone(zoneId).toInstant();
        return instant.toEpochMilli();
    } catch (Exception e) {
        e.printStackTrace();
    }
    return null;
}

/**
 * 時間戳轉LocalDateTime
 * @param timestamp 時間戳
 * @return LocalDateTime
 */
public static LocalDateTime timestampToLocalDateTime(long timestamp) {
    try {
        Instant instant = Instant.ofEpochMilli(timestamp);
        ZoneId zone = ZoneId.systemDefault();
        return LocalDateTime.ofInstant(instant, zone);
    } catch (Exception e) {
        e.printStackTrace();
    }
    return null;
}

/**
 * Date轉LocalDateTime
 * @param date Date
 * @return LocalDateTime
 */
public static LocalDateTime dateToLocalDateTime(Date date) {
    try {
        Instant instant = date.toInstant();
        ZoneId zoneId = ZoneId.systemDefault();
        return instant.atZone(zoneId).toLocalDateTime();
    } catch (Exception e) {
        e.printStackTrace();
    }
    return null;
}

/**
 * LocalDateTime轉Date
 * @param localDateTime LocalDateTime
 * @return Date
 */
public static Date localDateTimeToDate(LocalDateTime localDateTime) {
    try {
        ZoneId zoneId = ZoneId.systemDefault();
        ZonedDateTime zdt = localDateTime.atZone(zoneId);
        return Date.from(zdt.toInstant());
    } catch (Exception e) {
        e.printStackTrace();
    }
    return null;
}

　　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;

　　總結：

　　LocalDateTime：Date有的我都有，Date沒有的我也有，