1 日期类

1.1 Date

这是个已经过时的类，其中只有getTime()方法值得使用，目的是获得当前时间戳，即距离计算机元年(1970年1月1日 0点0分0秒)过去的总毫秒值

        Date date = new Date();
        long dateTime = date.getTime();
        System.out.println(dateTime);

输出结果:

1729251918473

1.2 Calendar

Calendar是一个抽象类，他提供丰富的方法来设置或获取时间，同时也提供方法来计算时间和日期，相较Date类，Calendar的功能公家丰富和灵活，易于使用

1.2.1 初始化Calendar

        Calendar calendar = Calendar.getInstance();

由于抽象类无法实例化，我们需要通过子类使用父类的方法，考虑当前系统的默认时区和语言环境来创建适合的实例，getInstance()方法通常用于创建一个为GregorianCalendar的对象，并通过向上转型当作Calendar的对象

获取日期信息

calendar.get() 用于获取 Calendar 对象当前设置的月份
Calendar.XXXX 是一个常量，用于在 Calendar 操作中标识月份字段

YEAR：年份。
MONTH：月份（从0开始，0表示一月）。
DAY_OF_MONTH：一个月中的哪一天。
HOUR_OF_DAY：一天中的小时数（0-23）。
MINUTE：分钟数。
SECOND：秒数。
MILLISECOND：毫秒数。
TIME_ZONE：时区信息。

代码如下:

        Calendar calendar = Calendar.getInstance();
        int year = calendar.get(Calendar.YEAR);
        int month = calendar.get(Calendar.MONTH);
        int dayOfMonth = calendar.get(Calendar.DAY_OF_MONTH);
        int hourOfDay = calendar.get(Calendar.HOUR_OF_DAY);
        int minute = calendar.get( Calendar.MINUTE);
        int second = calendar.get(Calendar.SECOND);
        System.out.println(year + "-" + month + "-" + dayOfMonth + " " + hourOfDay + ":" + minute + ":" + second);

运行结果:

2024-9-18 22:40:39

设置日期信息

我们可以使用calendar.set()方法设置calendar对象的日期:

        calendar.set(2024,12,30,15,36,22);

如果直接使用print方法打印carlendar对象，得到的将会是这个对象所包括的所有字段内容:

java.util.GregorianCalendar[time=?,areFieldsSet=false,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=2024,MONTH=12,WEEK_OF_YEAR=42,WEEK_OF_MONTH=3,DAY_OF_MONTH=30,DAY_OF_YEAR=292,DAY_OF_WEEK=6,DAY_OF_WEEK_IN_MONTH=3,AM_PM=1,HOUR=10,HOUR_OF_DAY=15,MINUTE=36,SECOND=22,MILLISECOND=843,ZONE_OFFSET=28800000,DST_OFFSET=0]

这个字段的解读如下：

time=?：这里显示的是time字段的值未知，因为没有给出具体的值。
areFieldsSet=false：表示没有单独设置任何字段。
areAllFieldsSet=true：表示所有字段都被设置了。
lenient=true：表示Calendar实例是宽松模式的，允许某些日期组合即使不符合规则也可以接受。
zone=sun.util.calendar.ZoneInfo[id="Asia/Shanghai"...]：表示使用的时区信息，这里是“亚洲/上海”时区。
firstDayOfWeek=1：表示一周的第一天是周日（1表示周日，2表示周一等）。
minimalDaysInFirstWeek=1：表示最少需要几天才能算作第一周。
ERA=1：表示纪元，1通常表示公元后。
YEAR=2024：表示年份为2024年。
MONTH=12：表示月份为12月（请注意，这里0表示1月，所以12表示12月）。
WEEK_OF_YEAR=42：表示这是这一年的第42周。
WEEK_OF_MONTH=3：表示这是这一月的第3周。
DAY_OF_MONTH=30：表示这是这一月的第30天。
DAY_OF_YEAR=292：表示这是这一年的第292天。
DAY_OF_WEEK=6：表示这是一周中的第六天，即周六（1表示周日，2表示周一等）。
DAY_OF_WEEK_IN_MONTH=3：表示这是这一月中周六的第3次出现。
AM_PM=1：表示使用的是12小时制，1表示PM。
HOUR=10：表示小时数为10（这里是12小时制）。
HOUR_OF_DAY=15：表示小时数为15（这里是24小时制）。
MINUTE=36：表示分钟数为36。
SECOND=22：表示秒数为22。
MILLISECOND=128：表示毫秒数为128。
ZONE_OFFSET=28800000：表示时区偏移量为28800000毫秒（即+08:00）。
DST_OFFSET=0：表示夏令时偏移量为0。

而使用calendar.getTime()方法则可以输出这个对象对应的日期，也就是我们刚刚设置的值:

Thu Jan 30 15:36:22 CST 2025

增加/减少日期

Calendar calendar = Calendar.getInstance();
calendar.add(Calendar.DAY_OF_MONTH, 1); // 增加一天
calendar.add(Calendar.HOUR, -2); // 减少两小时

特别注意

Calendar类不是线程安全的。在多线程环境中，应该为每个线程创建独立的Calendar实例，或者确保同步访问以避免竞态条件

1.3 Time包

1.3.1 Instance

1.3.2 间隔日期

2 日期格式化

2.1 SimpleDateFormat

由于DateFormat是抽象类，我们无法将其实例化，所以我们使用他的子类SimpleDateFormat来执行该类方法:

我们可以在创建SimpleDateFormat对象的时候通过传参pattern值，规定格式化时间字符串的格式:

SimpleDateFormat simpleDateFormat = new SimpleDateFormat(""); //在双引号内传参规则

以下是常用的字母模式(来自JDK官方文档):

字母	构成	样式	示例
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

        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy年MM月dd日 HH:mm:ss 星期u");
        String dateFormat = simpleDateFormat.format(dateTime);
        System.out.println(dateFormat);