日期类

一、第一代日期类 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();
    }
}