文章目录

• Date类
• • 常用的方法
• Calendar类
• • 常用的方法
  • 重要的注意点
  • • add和roll方法的区别：
    • 设置Calendar的容错性
    • set()方法延迟修改
• Java8新增的日期、时间包
• • Clock
  • Duration
  • Instant
  • LocalDate
  • LocalTime
  • LocalDateTime
  • MonthDay
  • Year
  • YearMonth
  • ZonedDateTime
  • ZoneId
  • DayOfWeek
  • Month
• LocalDateTime、LocalDate、Date的相互转换
• • LocalDateTime 转 LocalDate
  • LocalDateTime 转 Date
  • LocalDate 转 LocalDateTime
  • LocalDate 转 Date
  • Date 转 LocalDateTime
  • Date 转 LocalDate

Date类

Java在java.util包中提供了Date类，这个类封装了当前的日期和时间。
从JDK1.0开始就有了。
注意，Date不能实现国际化，偏移量也不统一，它的月份和小时都是从0开始的，月份的天数则是从1开始，年又是从1900开始的。

A year y is represented by the integer y - 1900.
A month is represented by an integer from 0 to 11; 0 is January, 1 is February, and so forth; thus 11 is December.
A date (day of month) is represented by an integer from 1 to 31 in the usual manner.
An hour is represented by an integer from 0 to 23. Thus, the hour from midnight to 1 a.m. is hour 0, and the hour from noon to 1 p.m. is hour 12.

该类的大部分方法都已过时。

常用的方法

Date类支持两种构造函数：

1. 第一个构造函数，初始化对象的当前日期和时间。

Date()

2. 下面的构造函数接收一个参数等于自1970年1月1日 00:00:00 起已经过的毫秒数

Date(long millisec)

以下方法还可以使用：

Calendar类

从JDK1.1开始有的。用于表示日历，指最通用的 Gregorian Calendar，即公历，它是一个抽象类，它是所有日历类的模板，所以不能使用构造函数来创建Calendar对象，但它提供了几个静态方法来获取Calendar对象，根据TimeZone，Locale类获取特定的Calendar，如果不指定，则使用默认的TimeZone，Locale来创建Calendar。

// 创建一个默认的Calendar对象
Calendar calendar = Calendar.getInstance()

// 从Calendar对象中取出Date对象
Date date = calendar.getTime()

// 通过Date对象获得对应的Calendar对象
// Calendar没有直接接收Date对象的构造函数，因此只能通过下面的方式
Calendar calendar1 = Calendar.getInstance();
calendar1.setTime(date);

注意的时间字段：
Calendar.MONTH 代表月份，月份的起始是0，0代表1月。
Calendar.HOUR 12小时制的小时
Calendar.HOUR_OF_DAY 24小时制的小时

常用的方法

重要的注意点

add和roll方法的区别：

add(int field, int amount)方法
根据日历规则，给指定的日历字段添加（正数）或减去（负数）指定的时间量

1. 当被修改的字段超出它允许的范围时，会发生进位，即上一级字段也会发生变化
2. 如果下一级的字段也要发生变化，那么改字段也会修正到变化最小的值。

Calendar calendar = Calendar.getInstance();
calendar.set(2021, 0, 31);
System.out.println(calendar.getTime());
// 2021-1-31

calendar.add(Calendar.MONTH, 1);
System.out.println(calendar.getTime());
// 2021-02-28

calendar.add(Calendar.MONTH, 15);
System.out.println(calendar.getTime());
// 2022-05-28

roll(int field, int amount)

1. 与add方法类似。区别在于，加上amount后超过了该字段所能表示的最大范围时，也不会向上一个字段进位。
2. 下一级字段的处理规则与add方法相似

Calendar calendar = Calendar.getInstance();
calendar.set(2021, 0, 31);
calendar.roll(Calendar.MONTH, 15);
System.out.println(calendar.getTime());
// 2021-05-28

设置Calendar的容错性

调用set()方法来改变指定时间字段的值时，有可能会传入一个不合法的参数，例如 MONTH超过11。

通过调用 setLenient(boolean lenient) 方法实现：
它用于设置容错性，Calendar默认支持较好的容错性。通过setLenient(false)来关闭容错性，让它进行严格的参数检查。当超过指定时间字段允许的取值范围时，程序会抛出异常。

set()方法延迟修改

set(int field, int value)
尽管字段field是立即修改的，但该Calenda所代表的时间却不会立即修改，直到调用 get()、getTime()、getTimeInMillis()、add() 、roll() 时，才会重新计算日历的时间，这被称为set()方法的延迟修改。
优势： 多次调用set()方法不会触发多次不必要的计算（计算一个代表实际时间的long型整数）。

Java8新增的日期、时间包

Java8新增了一个 java.time的包。
同时也增加了一个 java.time.temporal 包，包括Temporal、TemporalAdjuster 等接口，下面的一些类都实现了这些接口，使用的时候注意下。

Clock

获取指定时区的当前日期、时间。
该类可取代System类的currentTimeMillis()方法，而且提供了更多方法获取日期、时间。

Duration

代表持续时间。可以方便的获取一段时间。

Instant

代表一个具体的时刻，可以精确到纳秒。

LocalDate

代表一个不带时区的日期。
案例：

LocalDate today = LocalDate.now();
// 获取本周周一和周日
LocalDate monday = today.with(TemporalAdjusters.previousOrSame(DayOfWeek.MONDAY));
LocalDate sunday = today.with(TemporalAdjusters.nextOrSame(DayOfWeek.SUNDAY));

LocalTime

代表一个不带时区的时间。

LocalDateTime

代表一个不带时区的日期、时间。

MonthDay

代表月日。

Year

代表年。

YearMonth

代表年月。

ZonedDateTime

代表一个带时区的日期、时间

ZoneId

代表一个时区

DayOfWeek

枚举类，定义了周日到周六的枚举。

Month

枚举类，定义了一月到十二月的枚举。

相关案例如下：

public static void main(String[] args) {

        Clock clock = Clock.systemUTC();
        System.out.println("当前时刻：" + clock.instant());
        System.out.println(clock.getZone());
        // 获取clock对应的毫秒数，和System.currentTimeMillis()输出相同
        System.out.println(System.currentTimeMillis());
        System.out.println(clock.millis());

        Duration duration = Duration.ofSeconds(60100);
        System.out.println(duration.toHours());

        Instant instant = Instant.now();
        System.out.println(instant);
        System.out.println(instant.plusMillis(5));

        LocalDate localDate = LocalDate.now();
        System.out.println(localDate);

        // 设置为某一天
        System.out.println(LocalDate.of(2021, 1, 1));

        LocalTime localTime = LocalTime.now();
        System.out.println(localTime);

        Year year = Year.now();
        System.out.println(year);

        YearMonth yearMonth = YearMonth.now();
        System.out.println(yearMonth);

        MonthDay monthDay = MonthDay.now();
        System.out.println(monthDay);
        System.out.println(monthDay.withMonth(2).withDayOfMonth(4));

    }

LocalDateTime、LocalDate、Date的相互转换

LocalDateTime 转 LocalDate

直接调用 toLocalDate() 方法

LocalDateTime localDateTime = LocalDateTime.now();
LocalDate localDate = localDateTime.toLocalDate();

LocalDateTime 转 Date

在LocalDateTime 转 Date 时，需要使用到 Java 8的几个类

ZoneId/ZoneOffset：表示时区
ZonedDateTime： 表示特定时区的日期和时间
Instant：表示时刻，不直接对应年月日信息，需要通过时区转换

LocalDateTime localDateTime = LocalDateTime.now();
//获取系统默认时区
ZoneId zoneId = ZoneId.systemDefault();
//时区的日期和时间
ZonedDateTime zonedDateTime = localDateTime.atZone(zoneId);
//获取时刻
Date date = Date.from(zonedDateTime.toInstant());
System.out.println("格式化前：localDateTime:" + localDateTime + "  Date:" + date);
//格式化LocalDateTime、Date
DateTimeFormatter localDateTimeFormat = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
System.out.println("格式化后：localDateTime:" + localDateTimeFormat.format(localDateTime) + "  Date:" + dateFormat.format(date));

输出结果如下：

格式化前：localDateTime:2022-01-03T17:43:54.544  Date:Mon Jan 03 17:43:54 CST 2022
格式化后：localDateTime:2022-01-03 17:43:54  Date:2022-01-03 17:43:54

LocalDate 转 LocalDateTime

一般调用 atTime() 方法进行赋值

LocalDate localDate = LocalDate.now();
LocalDateTime localDateTime1 = localDate.atStartOfDay();
LocalDateTime localDateTime2 = localDate.atTime(8,20,33);
LocalDateTime localDateTime3 = localDate.atTime(LocalTime.now());

LocalDate 转 Date

先调用 atStartOfDay() 方法转 LocalDateTime 再转 Date

LocalDate localDate = LocalDate.now();
ZoneId zoneId = ZoneId.systemDefault();
Date date = Date.from(localDate.atStartOfDay().atZone(zoneId).toInstant());

Date 转 LocalDateTime

先转 ZonedDateTime 再转 LocalDateTime

Date date = new Date();
ZoneId zoneId = ZoneId.systemDefault();
LocalDateTime localDateTime = date.toInstant().atZone(zoneId).toLocalDateTime();

Date 转 LocalDate

跟 LocalDate 同理

Date date = new Date();
ZoneId zoneId = ZoneId.systemDefault();
LocalDate localDate = date.toInstant().atZone(zoneId).toLocalDate();