本文分享自華為雲社群《從入門到精通：SimpleDateFormat類高深用法，讓你的程式碼更簡潔！》，作者：bug菌。

環境說明：Windows 10 + IntelliJ IDEA 2021.3.2 + Jdk 1.8

@[toc]

前言

日期時間在開發中是非常常見的需求，尤其是在處理與時間相關的業務邏輯時，我們需要對日期時間進行格式化、比較等操作。在Java中，我們可以使用SimpleDateFormat類來方便地進行日期時間的格式化和解析操作。

本文將介紹SimpleDateFormat類的高深用法，旨在讓讀者更好地掌握該類的用法，讓程式碼更加簡潔。

摘要

本文中，我們將會介紹以下幾個方面：

SimpleDateFormat類的概述和常見用法
SimpleDateFormat類高深用法
程式碼實現及測試用例
小結和總結

SimpleDateFormat類

概述

SimpleDateFormat類是Java中用於格式化和解析日期時間的類。它提供了一系列的構造方法和格式化字串，使得我們能夠方便地進行日期時間的格式化和解析。

優缺點

SimpleDateFormat是Java中用於格式化日期和時間的類，它繼承自DateFormat類，是執行緒不安全的類。

優點：

簡單易用，可以快速地將日期格式化為指定的格式，並將字串轉換為對應的日期物件。
可以自定義日期格式，支援多種預定義的格式。
可以用於日期的解析和格式化操作。

缺點：

SimpleDateFormat是執行緒不安全的，不適合在多執行緒環境中使用。
對於某些日期格式，如年月日時分秒毫秒，需要使用一些特定的字元表示，這些字元具有一定的難度和複雜性。

應用場景

SimpleDateFormat適用於對日期進行格式化和解析的場景，如在紀錄檔記錄、資料庫操作、電子商務等領域中都有應用。例如，可以將時間戳轉換為指定格式的日期字串，也可以將日期字串解析為對應的日期物件。但要注意，由於SimpleDateFormat執行緒不安全，需要在多執行緒環境中使用時進行同步處理，或者使用執行緒安全的替代品，如Joda-Time庫中的DateTimeFormatter。

原始碼分析

SimpleDateFormat是Java中一個經典的時間格式化類，它可以將時間按照指定的格式轉換為字串，也可以將字串按照指定的格式轉換為時間。

其中對於SimpleDateFormat類原始碼比較複雜，因為它涉及了很多的時間格式化規則。在這裡，我們只簡單分析它的實現原理。

1.建構函式

SimpleDateFormat類有多個建構函式，其中比較常用的是以下兩個：

public SimpleDateFormat(String pattern)
public SimpleDateFormat(String pattern, Locale locale)

第一個建構函式的引數是時間格式化的模板，即時間字串的格式。第二個建構函式可以指定地理位置資訊。

2.格式化時間

SimpleDateFormat類將時間格式化為字串的主要方法是format()，該方法接收一個Date型別的引數，返回一個格式化後的時間字串。

3.解析時間

SimpleDateFormat類將字串解析為時間的主要方法是parse()，該方法接收一個時間字串作為引數，返回一個Date型別的日期物件。

4.執行緒安全

SimpleDateFormat類不是執行緒安全的，因為它的內部狀態可以被多個執行緒同時修改。如果要在多執行緒環境下使用它，可以使用ThreadLocal來實現執行緒隔離。

總的來說，SimpleDateFormat類是Java中一個非常常用的時間格式化類，可以方便地將時間轉換為指定格式的字串，也可以將字串解析為時間。在使用時，應該注意其執行緒安全性。

常見用法

以下是SimpleDateFormat類的幾個常見用法：

1. 格式化日期時間

SimpleDateFormat類的format()方法可以將日期時間按照指定的格式進行格式化。例如：

package com.demo.javase.day53;

import java.text.SimpleDateFormat;
import java.util.Date;

/**
 * @author bug菌
 * @date 2023/10/17 19:17
 */
public class SimpleDateFormatTest {

    //格式化日期時間
    public static void testFormat(){
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String dateStr = sdf.format(new Date());
        System.out.println(dateStr);
    }

    public static void main(String[] args) {
        testFormat();
    }
}

上述程式碼將當前時間格式化為"yyyy-MM-dd HH:mm:ss"的格式後輸出。

輸出結果如下所示：

2023-10-17 19:21:45

執行結果截圖如下：

2. 解析日期時間

SimpleDateFormat類的parse()方法可以將特定格式的字串解析成Date物件。例如：

    //解析日期時間
    public static void testParse() throws ParseException {
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
        Date date = sdf.parse("2023-10-17");
        System.out.println(date);
    }

    public static void main(String[] args) throws ParseException {
        testParse();
    }

上述程式碼將字串"2021-08-01"解析成Date物件後輸出。輸出結果如下所示：

Tue Oct 17 00:00:00 CST 2023

執行結果截圖如下：

3. 設定時區

SimpleDateFormat類的setTimeZone()方法可以設定時區。例如：

    //設定區時
    public static void testSetTimeZone(){
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        sdf.setTimeZone(TimeZone.getTimeZone("GMT+8"));
        String dateStr = sdf.format(new Date());
        System.out.println(dateStr);
    }

    public static void main(String[] args) throws ParseException {
        testSetTimeZone();
    }

上述程式碼設定時區為GMT+8後將當前時間格式化為"yyyy-MM-dd HH:mm:ss"的格式輸出。輸出結果如下所示：

2023-10-17 19:25:43

執行結果截圖如下：

高深用法

除了以上的常見用法外，SimpleDateFormat類還有一些高階用法，可以讓我們更加靈活地進行日期時間的格式化和解析。

1. 跳脫字元

SimpleDateFormat類支援使用跳脫字元來輸出特殊字元。例如：

    //跳脫字元
    public static void testSimpleDateFormat(){
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd 'at' HH:mm:ss");
        String dateStr = sdf.format(new Date());
        System.out.println(dateStr);
    }

    public static void main(String[] args) throws ParseException {
        testSimpleDateFormat();
    }

上述程式碼使用單引號將"at"括起來，表示輸出字元"at"。輸出結果如下所示：

2023-10-17 at 19:27:24

執行結果截圖如下：

2. 數位格式化

SimpleDateFormat類支援使用"#「和"0"來進行數位格式化。其中，」#"表示可選數位，"0"表示不足位數用0補全。例如：

    //數位格式化
    public static void testSimpleDateFormat_1(){
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSS");
        String dateStr = sdf.format(new Date());
        System.out.println(dateStr);
    }

    public static void main(String[] args) throws ParseException {
        testSimpleDateFormat_1();
    }

上述程式碼將當前時間格式化為"yyyy-MM-dd HH:mm:ss.SSS"的格式後輸出。輸出結果如下所示：

2023-10-17 19:28:31.478

執行結果截圖如下：

3. 格式化模式

SimpleDateFormat類支援使用格式化模式來輸出日期時間。格式化模式由日期和時間組成，可以自由組合。日期格式化模式包括"y"、「M」、「d」、「E"等，分別表示年、月、日、星期幾等。時間格式化模式包括"H」、「m」、「s」、"S"等，分別表示小時、分鐘、秒、毫秒等。例如：

    //格式化模式
    public static void testSimpleDateFormat_2() {
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd E HH:mm:ss");
        String dateStr = sdf.format(new Date());
        System.out.println(dateStr);
    }

    public static void main(String[] args) throws ParseException {
        testSimpleDateFormat_2();
    }

上述程式碼將當前時間格式化為"yyyy-MM-dd E HH:mm:ss"的格式後輸出。輸出結果如下所示：

2023-10-17 星期二 19:29:42

執行結果截圖如下：

測試用例

程式碼範例

以下是使用SimpleDateFormat類的範例程式碼及測試用例：

package com.demo.javase.day53;

import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.TimeZone;

/**
 * @author bug菌
 * @date 2023/10/17 19:17
 */
public class SimpleDateFormatDemo {

    public static void main(String[] args) throws Exception {
        // 格式化日期時間
        SimpleDateFormat sdf1 = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String dateStr1 = sdf1.format(new Date());
        System.out.println(dateStr1);

        // 解析日期時間
        SimpleDateFormat sdf2 = new SimpleDateFormat("yyyy-MM-dd");
        Date date2 = sdf2.parse("2023-10-17");
        System.out.println(date2);

        // 設定時區
        SimpleDateFormat sdf3 = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        sdf3.setTimeZone(TimeZone.getTimeZone("GMT+8"));
        String dateStr3 = sdf3.format(new Date());
        System.out.println(dateStr3);

        // 跳脫字元
        SimpleDateFormat sdf4 = new SimpleDateFormat("yyyy-MM-dd 'at' HH:mm:ss");
        String dateStr4 = sdf4.format(new Date());
        System.out.println(dateStr4);

        // 數位格式化
        SimpleDateFormat sdf5 = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss.SSS");
        String dateStr5 = sdf5.format(new Date());
        System.out.println(dateStr5);

        // 格式化模式
        SimpleDateFormat sdf6 = new SimpleDateFormat("yyyy-MM-dd E HH:mm:ss");
        String dateStr6 = sdf6.format(new Date());
        System.out.println(dateStr6);
    }
}

程式碼解析

針對如上的測試用例程式碼，給大家演示瞭如何使用Java中的SimpleDateFormat類對日期進行格式化和解析，具體介紹如下：

格式化日期時間

使用SimpleDateFormat的format()方法對當前時間進行格式化，將時間按照指定的格式輸出。

解析日期時間

使用SimpleDateFormat的parse()方法將字串轉換成Date型別的日期。

設定時區

使用SimpleDateFormat的setTimeZone()方法設定時區，將預設的時區改成GMT+8。

跳脫字元

使用單引號和雙引號將字元括起來，表示這部分內容不需要進行格式化。

數位格式化

在格式化日期中增加毫秒級別的時間。

格式化模式

使用SimpleDateFormat定義格式化模式，按照指定的格式輸出日期、星期幾和時間。

總的來說，SimpleDateFormat非常適合處理常規日期格式的轉換和簡單日期計算。但是需要注意的是它不是執行緒安全的，如果在多執行緒環境下使用，需要進行同步處理，或者使用ThreadLocal來實現執行緒區域性變數。

測試執行

輸出結果如下所示：

2023-10-17 19:31:16
Tue Oct 17 00:00:00 CST 2023
2023-10-17 19:31:16
2023-10-17 at 19:31:16
2023/10/17 19:31:16.783
2023-10-17 星期二 19:31:16\

執行結果截圖如下：

小結

本文向讀者介紹了SimpleDateFormat類的概述和常見用法，以及一些高深用法。通過學習本文，讀者可以更好地掌握SimpleDateFormat類的用法，讓程式碼更加簡潔。

附錄原始碼

如上涉及所有原始碼均已上傳同步在「Gitee」，提供給同學們一對一參考學習，輔助你更迅速的掌握。

總結

總的來說，本文介紹了Java中常用的日期格式化和解析類SimpleDateFormat的概述、常見用法和高深用法，以及使用該類的測試用例和程式碼實現。其中，常見用法包括格式化日期時間、解析日期時間和設定時區，而高深用法則包括跳脫字元、數位格式化和格式化模式等。

此外，本文還提到了SimpleDateFormat的優缺點和應用場景。需要注意的是，由於SimpleDateFormat是執行緒不安全的類，在多執行緒環境中需要進行同步處理，或者使用執行緒安全的替代品。通過學習本文，讀者可以更好地掌握SimpleDateFormat類的用法，進而更加靈活地進行日期時間的處理。

點選關注，第一時間瞭解華為雲新鮮技術~

想讓你的程式碼簡潔，試試這個SimpleDateFormat類高深用法

前言

摘要

SimpleDateFormat類

概述

優缺點

優點：

缺點：

應用場景

原始碼分析

1.建構函式

2.格式化時間

3.解析時間

4.執行緒安全

常見用法

1. 格式化日期時間

2. 解析日期時間

3. 設定時區

高深用法

1. 跳脫字元

2. 數位格式化

3. 格式化模式

測試用例

程式碼範例

程式碼解析

測試執行

小結

附錄原始碼

總結