java中的日期类

1.1 第一代日期类

第一代日期时间API主要有java.util.Date和日期时间格式化有关的java.text.DateFormat及其子类。

1.1.1 Date类

JDK1.0就在java.util包下面提供了Date类用于表示特定的瞬间，可以精确到毫秒。
  通过API或源码，可以看出Date类的大部分方法已经过时，已被第二代日期类Calendar代替，剩下的Date类常见方法如下所示。

序号	方法	定义
1	Date()	返回一个代表当前系统时间的Date对象，精确到毫秒
2	Date(long date)	返回一个距离UTC时间date毫秒的新日期对象，精确到毫秒
3	int compareTo(Date anotherDate)	比较两个日期的大小
4	long getTime()	返回自1970年1月1日00:00:00 GMT以来此Date对象表示的毫秒数
5	String toString()	把此Date对象转换为以下形式的String:dow mon dd hh:mm:ss zzz yyyy其中：dow是一周中的某一天(Sun,Mon,Tue,Wed,Thu,Fri,Sat)

public class DateTest {
    public static void main(String[] args) {
        Date date = new Date();
        System.out.println("现在的系统时间是："+date);
        long time=date.getTime();
        System.out.println("当前时间距离UTC时间的毫秒数："+time);
    }
}

>>
现在的系统时间是：Thu Mar 14 15:40:17 CST 2024
当前时间距离UTC时间的毫秒数：1710402017697

1.1.2 SimpleDateFormat类

Date类显示的格式没有考虑国际化问题，如该格式不符合中国人查看时间的格式习惯，因此需要对其进行格式化操作。java.text.SimpleDateFormat类可以实现格式化操作，它是java.text.DateFormat的子类。

创建SimpleDateFormat类的对象非常简单，可以使用如下构造器：

• SimpleDateFormat()：用默认的模式和默认的语言环境的日期格式符号构造SimpleDateFormat。
• SimpleDateFormat(String pattern)：用给定的模式和默认语言环境的日期格式符号构造SimpleDateFormat。
• SimpleDateFormat(String pattern,Locale locale):用给定的模式和给定语言环境的日期格式符号构造。

常见的日期格式化模板如下：
 SimpleDataFormat类主要用于将Date日期转换为字符串，或者将某个字符串转换为Date对象，其常见方法如下所示：

方法定义	描述
format	将一个Date格式转化为日期/时间字符串，此方法继承的父类DateFormat的方法
parse	从给定字符串的开始解析文本，以生成一个日期，此方法为继承的父类DateFormat的方法

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

public class SimpleDateFormatTest {
    public static void main(String[] args) throws ParseException {
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy年MM月dd日HH小时mm分钟ss秒S毫秒");
        System.out.println("使用指定格式的日期字符串："+sdf.format(new Date()));
        String str="2021年1月15日 06小时44分钟05秒 123毫秒";
        Date date = sdf.parse(str);
        System.out.println("日期对象："+date);
    }
}

>>
使用指定格式的日期字符串：2024年03月14日15小时45分钟06秒915毫秒
日期对象：Fri Jan 15 06:44:05 CST 2021

1.2 第二代日期类Calendar

Date类用于返回日期对象，不适合获取日历字段。设置和获取日历字段的方法，被JDK1.1推出的Calendar代替。

java.util.Calendar类是一个抽象类，它为特定瞬间与一组诸如YEAR、MONTH、DAY_OF_MONTH、HOUR等日历字段之间的转换提供了一些方法，并为操作日历字段(如获得下星期的日期)提供了一些方法。

序号	方法定义	描述
1	static getInstance()	使用默认时区和语言环境获得一个日历，也可以通过getInstance(TimeZone time,Locale loc)或指定时区和语言环境的日历
2	get(int field)	获取指定的日历字段
3	set(int year,int month,int date,int hourOfDay,int minute,int second)	设置字段YEAR、MONTH、DAY_OF_MONTH、HOUR、MINUTE和SECOND的值

public class CalendarTest {
    public static void main(String[] args) {
        Calendar c = Calendar.getInstance(TimeZone.getTimeZone("Asia/Shanghai"), Locale.CHINA);
        System.out.println("年:"+c.get(Calendar.YEAR));
        System.out.println("月："+(c.get(Calendar.MONTH)+1));//1月从0开始
        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));
    }
}

>>
年:2024
月：3
日:14
小时:4
分钟:0
秒:28

上述代码中的TimeZone表示时区，Locale表示语言环境。例如TimeZone.getTimeZone(“Asia/Shanghai”)表示“亚洲/上海”时区，Locale.CHINA表示中国语言环境。

1.3 第三代日期类

java8中引入的java.time纠正了过去的缺陷，这就是第三代日期API。

java8吸收了Joda-Time的精华，以一个新的开始为Java创建优秀的API。新的java.time中包含了所有关于本地日期(LocalDate)、本地时间(LocalTime)、本地日期时间(LocalDateTime)、时区(ZonedDateTime)和持续时间(Duration)的类。历史悠久的Date类也新增了toInstant()方法，用于把Date类转换成新的表示形式。

接下来只介绍商用的几个类型。

1.3.1 LocalDate、LocalTime、LocalDateTime类

这三个类都代表日期对象，只是包含的日历字段不同，相当于Calendar类的代替。
  java.time.LocalDate类：代表一个只包含年、月、日的日期对象，如2007-12-03。LocalDate类常见方法如下所示。

序号	方法定义	描述
1	static LocalDate now()	返回默认时区下的当前日期对象
2	int getYear()	返回年份,从-999999999-01-01~+999999999-12-31
3	int getMonth()	返回月份，1-12
4	int getDayOfMonth()	返回日期，1-31
5	LocalDate parse(CharSequence text)	按默认格式解析字符串为LocalDate的日期对象
6	LocalDate parse(CharSequence text,DateTimeFormatter formatter)	按指定格式解析字符串为LocalDate的日期对象

java.time.LocalTime类：代表一个只包含小时、分钟、秒的日期对象，如13:45.30.123456789。LocalTime常见方法如下：

序号	方法定义	描述
1	static LocalTime now()	返回默认时区下的当前时间对象
2	int getHour()	返回小时,0-23
3	int getMinute()	返回分钟，0-59
4	int getSecond()	返回秒，0-59
5	LocalTime parse(CharSequence text)	按默认格式解析字符串为LocalTime的日期对象
6	LocalTime parse(CharSequence text,DateTimeFormatter formatter)	按指定格式解析字符串为LocalTime的日期对象

java.time.LocalDateTime类：代表一个包含年、月、日、小时、分钟、秒的日期对象，如2007-12-03T10:15:30。LocalDateTime常见方法如下：

序号	方法定义	描述
1	static LocalDateTime now()	返回默认时区下的当前日期对象
2	int getYear()	返回年份,从-999999999-01-01~+999999999-12-31
3	int getMonth()	返回月份，1-12
4	int getDayOfMonth()	返回日期：1-31
5	int getHour()	返回小时：0-23
6	int getMinute()	返回分钟：0-59
7	int getSecond()	返回秒：0-59
8	LocalDateTime parse(CharSequence text)	按默认格式解析字符串为LocalDateTime的日期对象
9	LocalDateTime parse(CharSequence text,DateTimeFormatter formatter)	按指定格式解析字符串为LocalDateTime的日期对象

import java.time.LocalDateTime;

public class LocalDateTimeTest {
    public static void main(String[] args) {
        //1、创建一个日期对象
        LocalDateTime now = LocalDateTime.now();
        //2、获取日历字段
        System.out.println("年:"+now.getYear());
        System.out.println("月:"+now.getMonthValue());
        System.out.println("月："+now.getMonth());
        System.out.println("日："+now.getDayOfMonth());
        System.out.println("小时："+now.getHour());
        System.out.println("分钟："+now.getMinute());
        System.out.println("秒："+now.getSecond());
    }
}

>>
年:2024
月:3
月：MARCH
日：14
小时：16
分钟：8
秒：10

1.3.2 Instant类

在处理时间和日期时，我们通常会想到年、月、日、时、分、秒。然而，这只是时间的一个模型，是面向人类的。第二种通用模型是面向计算机的，在此模型中，时间线中的一个点表示一个整数，这有利于计算机处理。在UNIX中这个数从1970年开始，以秒为单位；同样在Java中也是从1970年开始的，但以毫秒为单位。

java.time包通过值类型Instant提供机器视图，不提供人类意义上的时间单位。Instant类表示时间线商的一点，不需要要任何上下文信息。例如，时区。从概念上讲，它只是简单地表示自1970年1月1日0时0分0秒(UTC)开始地秒数。因为java.time包是基于纳秒计算的，所以Instant类的精度可以达到纳秒级。
 Instant类的常见方法如下：

序号	方法定义	描述
1	static Instant now()	静态方法，返回默认UTC时区的Instant类的对象
2	static Instant ofEpochMillo(long epochMilli)	静态方法，返回在1970-01-01 00:00:00基础上加上指定毫秒数之后的Instant类的对象
3	static OffsetDateTime atOffset(ZoneOffset offset)	结合即时的便宜来创建一个OffsetDateTime
4	long toEpochMilli()	返回1970-01-01 00:00:00到当前时间的毫秒数，即时间戳

Instant类和第一代日期类Date的相互转换：

import java.time.Instant;
import java.util.Date;

public class InstantTest {
    public static void main(String[] args) {
        //1、创建一个Instant对象
        Instant now = Instant.now();
        System.out.println("now="+now);
        //2、转换方法
        //[1]Instant->Date
        Date d = Date.from(now);
        System.out.println("d="+d);
        //[2]Date->Instant
        Instant instant = d.toInstant();
        System.out.println("instant="+instant);
    }
}

>>
now=2024-03-14T08:15:44.544Z
d=Thu Mar 14 16:15:44 CST 2024
instant=2024-03-14T08:15:44.544Z

1.3.3 DateTimeFormatter类
  java.time.format.DateTimeFormatter类提供了格式化日期的方法，这个类和第一代日期的SimpleDateFormatter类似，但SimpleDateFormat只能格式化Date类，对Calendar类无效。DateTimeFormatter可以格式化LocalDate、LocalTime、LocalDateTime及Instant类。
 DateTimeFormatter类常见方法如下：

序号	方法定义	描述
1	static DateTimeFormatter ofPattern(String pattern)	静态方法，返回一个DateTimeFormatter对象
2	String format(TemporalAccessor t)	格式化一个日期、时间，返回字符串
3	TemporalAccessor parse(CharSequence text)	将指定格式的字符序列解析为一个日期、时间

TemporalAccessor 是java.time.temporal包下的接口，LocalDate、LocalTime、LocalDateTime、Instant都实现了该接口。

下面以LocalDateTime日期的格式为例，进行代码演示。

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class DateTimeFormatterTest {
    public static void main(String[] args) {
        LocalDateTime now = LocalDateTime.now();
        DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd a hh小时mm分钟ss秒");
        //格式化日期(日期->文本)
        String format = dtf.format(now);
        System.out.println(format);
        //解析字符串为日期(文本->日期)
        String s="2018-08-08 下午 05小时06分钟43秒";
        LocalDateTime parse = LocalDateTime.parse(s, dtf);
        System.out.println(parse);

    }
}

>>
2024-03-14 下午 04小时18分钟20秒
2018-08-08T17:06:43