日期类

一、第一代日期类 Date

Date：第一代日期类，精确到毫秒，代表特定的瞬间。
SimpleDateFormat：格式化和解析日期的具体类。它允许进行格式化（日期 -> 文本）、解析（文本 -> 日期）和规范化。

SimpleDateFormat日期-时间格式模式参数：

Letter	Date or Time Component	Presentation	Examples
`G`	Era designator	Text	`AD`
`y`	Year	Year	`1996`; `96`
`Y`	Week year	Year	`2009`; `09`
`M`	Month in year (context sensitive)	Month	`July`; `Jul`; `07`
`L`	Month in year (standalone form)	Month	`July`; `Jul`; `07`
`w`	Week in year	Number	`27`
`W`	Week in month	Number	`2`
`D`	Day in year	Number	`189`
`d`	Day in month	Number	`10`
`F`	Day of week in month	Number	`2`
`E`	Day name in week	Text	`Tuesday`; `Tue`
`u`	Day number of week (1 = Monday, ..., 7 = Sunday)	Number	`1`
`a`	Am/pm marker	Text	`PM`
`H`	Hour in day (0-23)	Number	`0`
`k`	Hour in day (1-24)	Number	`24`
`K`	Hour in am/pm (0-11)	Number	`0`
`h`	Hour in am/pm (1-12)	Number	`12`
`m`	Minute in hour	Number	`30`
`s`	Second in minute	Number	`55`
`S`	Millisecond	Number	`978`
`z`	Time zone	General time zone	`Pacific Standard Time`; `PST`; `GMT-08:00`
`Z`	Time zone	RFC 822 time zone	`-0800`
`X`	Time zone	ISO 8601 time zone	`-08`; `-0800`; `-08:00`

案例：

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

第二代日期类，主要就是 Calendar类（日历）。

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

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();
    }
}

标签 datetime, java, let, 日期

日期类

日期类

一、第一代日期类 Date

二、第二代日期类 Calendar

三、 第三代日期类

三、第三代日期类