Java SimpleDateFormatter使用指南

一、SimpleDateFormat概述

SimpleDateFormat是Java API中處理日期格式化最常用的類之一。它允許以易於閱讀的格式提供輸出，並將字元串轉換為日期對象。SimpleDateFormat類使用單個字母來代表格式化模式，這些模式可用於創建日期格式表示。例如，yyyy-MM-dd表示年-月-日的日期格式。本文將介紹SimpleDateFormat類的使用方法和示例代碼。

二、SimpleDateFormat基本用法

SimpleDateFormat類有一個構造函數，可以用於創建新的SimpleDateFormat對象。

SimpleDateFormat(String pattern) 

pattern參數是字元串模式。通過使用不同的模式，SimpleDateFormat可將日期對象轉換為字元串和解析字元串。例如：

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

上述代碼將創建一個SimpleDateFormat對象，該對象使用”yyyy-MM-dd HH:mm:ss”格式化日期。現在，我們可以使用該對象將Date對象格式化為字元串或將字元串解析為Date對象。例如，以下代碼將使用SimpleDateFormat將日期對象格式化為字元串：

Date date = new Date();
String formattedDate = sdf.format(date);
System.out.println("格式化後的日期：" + formattedDate);

輸出：

格式化後的日期：2022-01-02 09:10:23

我們也可以將一個字元串轉換成日期對象：

String dateString = "2022-01-02 09:10:23";
Date date = sdf.parse(dateString);
System.out.println("解析後的日期："+ date);

輸出：

解析後的日期：Sun Jan 02 09:10:23 GMT+08:00 2022

三、SimpleDateFormat格式化佔位符

SimpleDateFormat支持不同的佔位符。下面是一些常用的佔位符：

如果要格式化年份為4個數字，則可以使用yyyy佔位符。例如：

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");

要格式化小時為12小時制，可以使用hh佔位符：

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss a");

其中a代表上午/下午。輸出如下：

格式化後的日期：2022-01-02 08:30:20 上午

四、SimpleDateFormat常用方法

除了上述介紹的基本用法外，SimpleDateFormat還提供了一些常用方法。

1. format(Date date)方法：將Date對象格式化為字元串。

Date date = new Date();
String formattedDate = sdf.format(date);

2. parse(String text)方法：將字元串解析為Date對象。

String dateString = "2022-01-02 09:10:23";
Date date = sdf.parse(dateString);

3. setTimeZone(TimeZone timeZone)方法：設置時區。例如：

sdf.setTimeZone(TimeZone.getTimeZone("GMT+08:00"));

4. setLenient(boolean lenient)：設置解析是否寬容。默認情況下，規則並不嚴格，例如將一個日期解析為2月31日會得到3月3日。如果希望在解析時驗證日期是否有效，可以將lenient設置為false。例如：

sdf.setLenient(false);

五、SimpleDateFormat線程安全

SimpleDateFormat不是線程安全的。在多線程環境中，不同的線程可以同時使用同一個SimpleDateFormat實例，並修改其狀態。因此，如果需要在多線程環境中使用SimpleDateFormat，應該在每個線程中使用不同的SimpleDateFormat實例。

六、結論

本文介紹了SimpleDateFormat類的基本用法、常用佔位符和方法，並討論了在多線程環境中使用SimpleDateFormat的安全注意事項。希望本文能夠幫助Java開發人員更好地理解和使用SimpleDateFormat。

附錄：完整示例代碼

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

public class SimpleDateFormatExample {

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

        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

        // 格式化
        Date date = new Date();
        String formattedDate = sdf.format(date);
        System.out.println("格式化後的日期：" + formattedDate);

        // 解析
        String dateString = "2022-01-02 09:10:23";
        Date date2 = sdf.parse(dateString);
        System.out.println("解析後的日期："+ date2);

        // 設置時區
        sdf.setTimeZone(TimeZone.getTimeZone("GMT+08:00"));

        // 解析時驗證日期是否有效
        sdf.setLenient(false);

    }

}