Java8 日期時間的操作技巧

2020-09-28 12:01:57

在 Java 8 中 推出了LocalDate、LocalTime、LocalDateTime這個三個時間處理類,以此來彌補之前的日期時間類的不足,簡化日期時間的操作。

Java8
日期和時間類包含LocalDate、LocalTime、Instant、Duration以及Period,這些類都包含在java.time包中


在Java8之前,處理日期時間的類是Date、Calendar 。

  • java.util.Date和java.util.Calendar類易用性差,不支援時區,而且他們都不是執行緒安全的;
  • 用於格式化日期的類DateFormat被放在java.text包中,它是一個抽象類,所以我們需要範例化一個SimpleDateFormat物件來處理日期格式化,並且DateFormat也是非執行緒安全,這意味著如果你在多執行緒程式中呼叫同一個DateFormat物件,會得到意想不到的結果。
  • 對日期的計算方式繁瑣,而且容易出錯,因為月份是從0開始的,從Calendar中獲取的月份需要加一才能表示當前月份。

目前在西瓜視訊上免費刊登 Flutter 系列教學,每日更新,歡迎關注接收提醒

【x1】點選檢視提示

【x2】各種系列的教學


1 Java8 獲取當前的時間資料

LocalDate、LocalDateTime 的now()方法使用的是系統預設時區.

@SpringBootTest
class DemoDateTests {

  //紀錄檔
  private static final Logger LOG = LoggerFactory.getLogger(DemoDateTests.class);

  @Test
  void test() {
    //只獲取當前時區的日期
    LocalDate localDate = LocalDate.now();
    LOG.info("localDate: " + localDate);
    //localDate: 2020-09-23
    
    //只獲取當前時間
    LocalTime localTime = LocalTime.now();
    LOG.info("localTime: " + localTime);
    //localTime: 23:41:43.991

    //獲取不前的日期與時間
    LocalDateTime localDateTime2 = LocalDateTime.now();
    LOG.info("localDateTime2: " + localDateTime2);
    //localDateTime2: 2020-09-23T23:41:43.991
  }
}

在這裡獲取到的時間 2020-09-23T23:41:43.991 中間攜帶一個T指的是UTC時間。

UTC時間,是指零時區的時間,它的全稱是Coordinated Universal Time ,即世界協調時間。

另一個常見的縮寫是GMT,即格林威治標準時間,格林威治位於 零時區,因此,我們平時說的UTC時間和GMT時間在數值上面都是一樣的。

1884 年, 國際經度會議將地球表面按經線等分為24 區,稱為時區。即以本初子午線為基準, 東西經度各7.5 度的範圍作為零時區,
然後每隔15度為一時區,每個時區相差一小時,北京時區為東八區。
比如:北京時間 2020-09-23 12:00:00 那麼 utc 時間就是 2020-09-23 04:00:00;

當然獲取到的時間格式可能不是我們想要的,可以結合 DateTimeFormatter來對其進行格式化操作如下:

 @Test
 void test1() {
   
   //使用靜態方法生成此物件
   LocalDateTime localDateTime = LocalDateTime.now();
   LOG.info("localDateTime: " + localDateTime);
   ///localDateTime: 2020-09-23T23:47:41.752
   

   //格式化時間
   DateTimeFormatter formatter = DateTimeFormatter.ofPattern("YYYY-MM-dd HH:mm:ss");
   //格式化後的時間
   String formatDate = localDateTime.format(formatter);

   LOG.info("格式化之後的時間: " + formatDate);
   //格式化之後的時間: 2020-09-23 23:47:41
 }
1.1 LocalDate

LocalDate類表示一個具體的日期,但不包含具體時間,也不包含時區資訊。可以通過LocalDate的靜態方法of()建立一個範例,LocalDate也包含一些方法用來獲取年份,月份,天,星期幾等。

@Test
 void test3() {
   //當然你也可以使用當前的時間
   //LocalDate localDate = LocalDate.now();
   // 初始化一個日期:2020-09-24
   LocalDate localDate = LocalDate.of(2020, 9, 24);    
    
   int year = localDate.getYear();                     // 年份:2020
   Month month = localDate.getMonth();                 // 月份:SEPTEMBER
   int dayOfMonth = localDate.getDayOfMonth();         // 月份中的第幾天:24
   DayOfWeek dayOfWeek = localDate.getDayOfWeek();     // 一週的第幾天:THURSDAY
   int length = localDate.lengthOfMonth();             // 月份的天數:30
   boolean leapYear = localDate.isLeapYear();          // 是否為閏年:true
 }

斷點單元測試執行如下
在這裡插入圖片描述

1.2 LocalTime

LocalTime 與 LocalDate 類似,區別在於 LocalDate 不包含具體時間,而 LocalTime 包含具體時間

@Test
void test4() {
  //當前的時間
  LocalTime localTime = LocalTime.now();
  
  int hour = localTime.getHour();       // 時:07
  int minute = localTime.getMinute();   // 分:22
  int second = localTime.getSecond();   // 秒:20
}

斷點單元測試執行如下
在這裡插入圖片描述

1.3 LocalDateTime

LocalDateTime 類是 LocalDate 和 LocalTime 的結合體,可以通過of()方法直接建立,也可以呼叫 LocalDate 的 atTime() 方法或 LocalTime 的 atDate() 方法將 LocalDate 或 LocalTime 合併成一個LocalDateTime.

@Test
void test5() {
  
  ///通過 of 方法建立  LocalDateTime
  LocalDateTime localDateTime = LocalDateTime.of(
      2020,//年
      Month.JANUARY,//月 
      4, //日
      //時 分 秒
      17, 23, 52);

}

可以這樣理解 LocalDate 與 LocalTime 向 LocalDateTime 轉化,就是將兩者合併的過程,如下所示:

  @Test
  void test6() {


    //通過of方法來建立 LocalDate
    //引數為年 月 日
    LocalDate localDate = LocalDate.of(2020, Month.JANUARY, 4);

    //通過of方法來建立 LocalTime
    //引數為 時分秒
    LocalTime localTime = LocalTime.of(07, 23, 52);

    // LocalDate 轉 LocalDateTime
    LocalDateTime localDateTime = localDate.atTime(localTime);

    // LocalTime  轉 LocalDateTime
    LocalDateTime localDateTime1 = localTime.atDate(localDate);

  }

斷點單元測試執行如下在這裡插入圖片描述

當然也可以反過來 LocalDateTime 轉為 LocalDate 或者 LocalTime,如下所示:


LocalDate date = localDateTime.toLocalDate();

LocalTime time = localDateTime.toLocalTime();

2 LocalDateTime 與毫秒之間的妙操作

時間戳是指格林威治時間1970年01月01日00時00分00秒(北京時間1970年01月01日08時00分00秒)起至現在的總秒數

ZoneId 指地區
ZoneOffset指偏移資料

 @Test
 void test2() {

   //使用靜態方法生成此物件
   LocalDateTime localDateTime = LocalDateTime.now();
   LOG.info("localDateTime: " + localDateTime);
   ///localDateTime: 2020-09-23T23:49:11.832

   //轉化為時間戳(秒)
   long epochSecond = localDateTime.toEpochSecond(ZoneOffset.of("+8"));
   //轉化為毫秒
   long epochMilli = localDateTime.atZone(ZoneOffset.systemDefault()).toInstant().toEpochMilli();

   LOG.info("時間戳為:(秒) "   + epochSecond + "; (毫秒): " + epochMilli);
   ///時間戳為:(秒) 1600876151; (毫秒): 1600876151832



   //時間戳(毫秒)轉化成LocalDateTime
   Instant instant = Instant.ofEpochMilli(epochMilli);
   LocalDateTime localDateTime3 = LocalDateTime.ofInstant(instant, ZoneOffset.systemDefault());
  
   //時間戳(秒)轉化成LocalDateTime
   Instant instant2 = Instant.ofEpochSecond(epochSecond);
   LocalDateTime localDateTime4 = LocalDateTime.ofInstant(instant2, ZoneOffset.systemDefault());
  

 }
3 LocalDateTime 與 Date 的妙操作

Instant 類代表的是某個時間,是精確到納秒的,與我們常使用的System.currentTimeMillis()有些類似,不過Instant可以精確到納秒(Nano-Second),System.currentTimeMillis()方法只精確到毫秒(Milli-Second)。

如果使用納秒去表示一個時間則原來使用一位Long型別是不夠的,需要佔用更多一點的儲存空間,實際上其內部是由兩個Long欄位組成。

需要注意的是 但Instant 代表的是一個時間,並不包括時區的概念。

  // Date 轉化成 LocalDateTime
  public static LocalDateTime dateToLocalDate(Date date) {
    //Date轉納秒
    Instant instant = date.toInstant();
    //獲取系統預設的時區
    ZoneId zoneId = ZoneId.systemDefault();
    //轉化
    return instant.atZone(zoneId).toLocalDateTime();
  }


  // LocalDateTime 轉化成 Date
  public static Date localDateTimeToDate(LocalDateTime localDateTime) {
    ZoneId zoneId = ZoneId.systemDefault();
    ZonedDateTime zdt = localDateTime.atZone(zoneId);
    return Date.from(zdt.toInstant());
  }
 // Date 毫秒資料 轉化成 LocalDateTime
 public static LocalDateTime dateToLocalDateMil(Long datemilli) {
   //將毫秒資料轉化為納秒
   Instant instant = Instant.ofEpochMilli(datemilli);
   ZoneId zoneId = ZoneId.systemDefault();
   return instant.atZone(zoneId).toLocalDateTime();
 }

當然 Instant 也有很多妙操作

Instant 它的內部使用了兩個常數,seconds表示從 1970-01-01 00:00:00 開始到現在的秒數,nanos 表示納秒部分(nanos的值不會超過999,999,999)
在這裡插入圖片描述

Instant除了使用now()方法建立外,還可以通過ofEpochSecond方法建立:

@Test
void test7() {

  //引數一為秒,引數二為納秒,
  //這裡的程式碼錶示從1970-01-01 00:00:00開始後三分鐘的10萬納秒的時刻
  Instant instant = Instant.ofEpochSecond(180, 100000);

  LOG.info("時間為:"   + instant );

}

斷點單元測試執行如下
在這裡插入圖片描述

4 Duration 類

在上述的操作中沒有提到這個類,Duration的內部實現與Instant類似,也是包含兩部分:seconds表示秒,nanos表示納秒。兩者的區別是Instant用於表示一個時間戳(或者說是一個時間點),而Duration表示一個時間段,所以Duration類中不包含now()靜態方法。可以通過Duration.between()方法建立Duration物件。

@Test
 void test8() {

   ///開始時間
   LocalDateTime from = LocalDateTime.of(2020, Month.JANUARY, 9, 10, 7, 0);    // 2017-01-05 10:07:00
   //結束時間
   LocalDateTime to = LocalDateTime.of(2020, Month.FEBRUARY, 10, 10, 7, 0);

   // 表示從 2020-09-05 10:07:00 到 2020-09-05 10:07:00 這段時間
   Duration duration = Duration.between(from, to);

   long days = duration.toDays();              // 這段時間的總天數
   long hours = duration.toHours();            // 這段時間的小時數
   long minutes = duration.toMinutes();        // 這段時間的分鐘數
   long seconds = duration.getSeconds();       // 這段時間的秒數
   long milliSeconds = duration.toMillis();    // 這段時間的毫秒數
   long nanoSeconds = duration.toNanos();      // 這段時間的納秒數


   LOG.info("時間為:"   + duration );

 }

斷點單元測試執行如下
在這裡插入圖片描述

5 Period 類

Period在概念上與Duration類似,區別在於Period是以年月日來衡量一個時間段,比如1年3個月6天(程式碼清單 5-1)。

Period物件可以通過構造方法與between()方法建立,值得注意的是,由於Period是以年月日衡量時間段,所以between()方法只能接收LocalDate型別的引數。

//程式碼清單 5-1
 @Test
 void test9() {

   //1年3個月6天
   Period period = Period.of(1, 3, 6);

   // 2017-01-05 到 2017-02-05 這段時間
   Period period2 = Period.between(
       LocalDate.of(2020, 1, 5),
       LocalDate.of(2020, 2, 5));

   LOG.info("時間為:"   + period );
 }

斷點單元測試執行如下在這裡插入圖片描述

6 指定日期的前後時間妙操作

//程式碼清單 6-1
@Test
void test10() {
   //使用當前的時間
  LocalDate localDate = LocalDate.now();

  LocalDate date4 = localDate.plusYears(1);                // 增加一年 2021-09-24
  LocalDate date5 = localDate.minusMonths(2);              // 減少兩個月 2021-07-24
  LocalDate date6 = localDate.plus(5, ChronoUnit.DAYS);    // 增加5天 2021-09-29

  LOG.info("時間為:"   + date6 );
}

斷點單元測試執行如下
在這裡插入圖片描述

7 格式化日期

新的日期API中提供了一個 DateTimeFormatter 類(在上述也有使用到)用於處理日期格式化操作,它被包含在java.time.format包中,Java 8的日期類有一個format()方法用於將日期格式化為字串,該方法接收處理一個DateTimeFormatter型別引數

//程式碼清單 7-1
@Test
void test11() {
  //使用當前的時間
  LocalDateTime dateTime = LocalDateTime.now();


  String strDate1 = dateTime.format(DateTimeFormatter.BASIC_ISO_DATE);    // 20200924
  String strDate2 = dateTime.format(DateTimeFormatter.ISO_LOCAL_DATE);    // 2020-09-24
  String strDate3 = dateTime.format(DateTimeFormatter.ISO_LOCAL_TIME);    // 08:23:31.463
  String strDate4 = dateTime.format(DateTimeFormatter.ofPattern("yyyy-MM-dd"));   // 2020-09-24

  LOG.info("時間為:"   + dateTime );
}

斷點單元測試執行如下在這裡插入圖片描述
將現有的日期字串解析為 LocalDateTime 、LocalDate、LocalTime 如下程式碼清單7-2所示。

解析的核心思路為 先定義 格式對映 DateTimeFormatter,然後再呼叫對應的parse方法

//程式碼清單 7-2
@Test
void test12() {

  String strDate = "2020-09-24";
  String strDate2 = "2020-09-24 08:23:31";

  LocalDate date = LocalDate.parse(strDate, DateTimeFormatter.ofPattern("yyyy-MM-dd"));
  
  LocalTime time = LocalTime.parse(strDate, DateTimeFormatter.ofPattern(" HH:mm:ss"));

  //定義 formatter
  DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
  //解析操作
  LocalDateTime dateTime = LocalDateTime.parse(strDate2, dateTimeFormatter);

  LOG.info("時間為:"   + dateTime );

}

斷點單元測試執行如下
在這裡插入圖片描述


當然也有公眾號了,感興的夥伴可以關注關注

在這裡插入圖片描述