日期類

一、第一代日期類 Date

1. Date：第一代日期類，精確到毫秒，代表特定的瞬間。
2. SimpleDateFormat：格式化和解析日期的具體類。它允許進行格式化（日期 -> 文本）、解析（文本 -> 日期）和規範化。

SimpleDateFormat日期-時間格式模式參數：

案例：

public class Date01 {
    public static void main(String[] args) throws ParseException {
        //1. 獲取當前系統時間
        //2. 這裡的 Date類 是在java.util包下
        //3. 預設輸出的日期格式是國外的方式
        Date d1 = new Date();//獲取當前系統時間
        System.out.println("當前日期 = " + d1);
        Date d2 = new Date(32417912374l);//通過指定毫秒數得到時間
        System.out.println("d2 = " + d2);//獲取某個時間對應的毫秒數


        //1. 創建 SimpleDateFormat 對象，可以指定相應的格式
        //2. 這裡的格式使用的字母是規定好的，不能亂寫
        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy年MM月dd日 hh:mm:ss E");
        String format = simpleDateFormat.format(d1);//format：將日期轉換成指定格式的字元串
        System.out.println("當前日期 = "  + format);

        //1. 可以把一個格式化的String 轉成對應的 Date
        //2. 得到Date在輸出時仍然還是按照國外的形式，如果希望指定形式輸出，需要轉換
        //3. 在把String -> Date，使用的simpleDateFormat 格式需要和你給的string的格式一樣，否則會拋出轉換異常
        String s = "1996年01月01日 10:20:30 星期一";
        Date parse = simpleDateFormat.parse(s);
        System.out.println("parse = " + parse);
        System.out.println(simpleDateFormat.format(parse));
    }
}

/*
	運行結果：
	當前日期 = Wed Feb 01 17:48:30 CST 2023
	d2 = Mon Jan 11 12:58:32 CST 1971
	當前日期 = 2023年02月01日 05:48:30 星期三
	parse = Mon Jan 01 10:20:30 CST 1996
	1996年01月01日 10:20:30 星期一
*/

二、第二代日期類 Calendar

1. 第二代日期類，主要就是 Calendar類（日曆）。

   public abstract class Calendar implements Serializable, Cloneable, Comparable<Calendar>
   

2. Calendar類 是一個抽象類，它為特定瞬間與一組諸如 YEAR、MONTH、DAY_OF_MONTH、HOUR 等 日曆欄位之間的轉換提供了一些方法，併為操作日曆欄位（例如獲得下星期的日期）提供了一些方法。

案例：

public class Calendar_ {
    public static void main(String[] args) {
        //1. Calendar 是一個抽象類，並且構造器是protect的
        //2. 可以通過 getInstance() 來獲取實例
        //3. 提供大量的方法和欄位給程式員
        //4. Calendar 沒有專門的格式化方法，所以需要程式員自己來組合來輸出顯示
        //5. 如果我們需要按照24小時進位獲取時間 Calendar.HOUR ==>修改成 Calendar.HOUR_OF_DAY
        Calendar c = Calendar.getInstance();//創建日曆對象，不可以用 new
        System.out.println("c = " + c);

        //2。 獲取日曆對象的某個日曆對象
        System.out.println("年：" + c.get(Calendar.YEAR));
        //這裡為什麼要 + 1，因為 Calendar 返回月的時候，是按照 0 開始編號的
        System.out.println("月：" + ( c.get(Calendar.MONTH) + 1));
        System.out.println("日：" + c.get(Calendar.DAY_OF_MONTH));
        System.out.println("小時：：" + c.get(Calendar.HOUR));
        System.out.println("分鐘：" + c.get(Calendar.MINUTE));
        System.out.println("秒：" + c.get(Calendar.SECOND));
        //Calendar 沒有專門的格式化方法，所以需要程式員自己來組合
        System.out.println(c.get(Calendar.YEAR) + "年" + (c.get(Calendar.MONTH) + 1) + "月"+ c.get(Calendar.DAY_OF_MONTH) +"日");
        System.out.println(c.get(Calendar.HOUR_OF_DAY) + ":" + (c.get(Calendar.MINUTE) + 1) + ":"+ c.get(Calendar.SECOND));

    }
}

/*
	運行結果：
	c = java.util.GregorianCalendar[time=1675245494713,areFieldsSet=true,areAllFieldsSet=true,lenient=true,zone=sun.util.calendar.ZoneInfo[id="Asia/Shanghai",offset=28800000,dstSavings=0,useDaylight=false,transitions=31,lastRule=null],firstDayOfWeek=1,minimalDaysInFirstWeek=1,ERA=1,YEAR=2023,MONTH=1,WEEK_OF_YEAR=5,WEEK_OF_MONTH=1,DAY_OF_MONTH=1,DAY_OF_YEAR=32,DAY_OF_WEEK=4,DAY_OF_WEEK_IN_MONTH=1,AM_PM=1,HOUR=5,HOUR_OF_DAY=17,MINUTE=58,SECOND=14,MILLISECOND=713,ZONE_OFFSET=28800000,DST_OFFSET=0]
	年：2023
	月：2
	日：1
	小時：：5
	分鐘：58
	秒：14
	2023年2月1日
	17:59:14
*/

三、 第三代日期類

• 前面兩代日期類的不足分析：

  JDK 1.0 中包含了一個 java.util.Date類，但是它的大多數方法已經在JDK1.1引入 Calendar類 之後被棄用了。而Calendar也存在的問題是：

  1. 可變性：像日期和時間這樣的類應該是不可變的。
  2. 偏移性：Date中的年份是從1900開始的，而月份都從0開始。
  3. 格式化：格式化只對Date有用，而Calendar 則不行。
  4. 此外，它們也不是線程安全的；不能處理閏秒等（每隔2天，多出1秒）。

• 第三代日期類

  LocalDate（日期/年月日）、LocalTime（時間/時分秒）、LocalDateTime（日期時間/年月日時分秒）JDK8加入

  1. LocalDate 只包含日期，可以獲取日期欄位
  2. LocalTime 只包含時間，可以獲取時間欄位
  3. LocalDateTime 包含 日期 + 時間，可以獲取日期和時間欄位

• DateTimeFormatter 格式日期類

  類似於SimpleDateFormat

  DateTimeFormatter dft = DateTimeFormatter.ofPattern(格式);
  String str = dtf.format(日期對象);
  

案例：

public class LocalDate_ {
    public static void main(String[] args) {
        //第三代日期
        //1. 使用now() 返回表示當前日期時間的 對象
        LocalDateTime ldt = LocalDateTime.now();//LocalDate.now();//LocalTime.now
        System.out.println(ldt);
        System.out.println("年 = " + ldt.getYear());
        System.out.println("月 = " + ldt.getMonth());
        System.out.println("月 = " + ldt.getMonthValue());
        System.out.println("日 = " + ldt.getDayOfMonth());
        System.out.println("時 = " + ldt.getHour());
        System.out.println("分 = " + ldt.getMinute());
        System.out.println("秒 = " + ldt.getSecond());

        LocalDate now = LocalDate.now();//可以獲取年月日
        LocalTime now1 = LocalTime.now();//可以獲取時分秒
        System.out.println(now);
        System.out.println(now1);

        //2. 使用DateTimeFormatter  對象來進行格式化
        //關於 DateTimeFormatter 的各個參數，需要看jdk8的文檔。
        DateTimeFormatter dateTimeformatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH小時mm分鐘ss秒");
        String format = dateTimeformatter.format(ldt);
        System.out.println("格式化後日期 = " + format);

        //提供了 plus 和 minus 方法可以對當前的時間進行加或減
        //看看890天後時什麼時候 把 年月日 時分秒 輸出
        LocalDateTime ldt2 = ldt.plusDays(890);
        String format2 = dateTimeformatter.format(ldt2);
        System.out.println("890天後的時間 = " + format2);

        //看看 3456分鐘前是什麼時候 把 年月日 時分秒 輸出
        LocalDateTime ldt3 = ldt.minusMinutes(3456);
        System.out.println("3456分鐘前的時間 = " + dateTimeformatter.format(ldt3));
    }
}

/*
	運行結果：
	2023-02-01T18:14:29.882
	年 = 2023
	月 = FEBRUARY
	月 = 2	
	日 = 1
	時 = 18
	分 = 14
	秒 = 29
	2023-02-01
	18:14:29.883
	格式化後日期 = 2023年02月01日 18小時14分鐘29秒
	890天後的時間 = 2025年07月10日 18小時14分鐘29秒
	3456分鐘前的時間 = 2023年01月30日 08小時38分鐘29秒
*/

• Instant 時間戳

  類似Date

  提供了一系列和Date類轉換的方式

  Instant ——> Date：

  Date date = Date.from(instant);

  Date ——> Instant：

  Instant instant = date.toInstant();

案例：

public class Instant_ {
    public static void main(String[] args) {
        //1. 通過靜態方法 now() 獲取當前時間戳的對象
        Instant now = Instant.now();
        System.out.println(now);
        //2. 可以通過 from 可以把 Instant 轉成 Date
        Date date = Date.from(now);
        //3. 通過 date 的 toInstant() 可以把 date 轉成 Instant
        Instant instant = date.toInstant();
    }
}