JDK8新增日期类的常用API

本是古典何须时尚 2023-09-26 11:34 162阅读 0赞

#### 文章目录 ####

*   *   *  JDK8新增日期类
         *   *  新增日期类介绍
             *  日期、时间、日期时间对象介绍
             *  修改日期时间相关方法
             *  Instant时间戳
             *  DateTimeFormatter

#### JDK8新增日期类 ####

##### 新增日期类介绍 #####

**从Java 8开始，java.time包提供了新的日期和时间API，主要涉及的类型有如下**：

![在这里插入图片描述][c67ec92dce844a18b552ec1edaeb74d7.png_pic_center]

> 新增的API严格区分了时刻、本地日期、本地时间，并且，对日期和时间进行运算更加方便。
> 
> 其次，新API的类型几乎全部是不变类型（和String的使用类似），可以放心使用不必担心被修改。

##### 日期、时间、日期时间对象介绍 #####

> 他们分别表示日期，时间，日期时间对象，他们的类的实例是不可变的对象。
> 
> 他们三者构建对象和API都是通用的

**构建对象的方式如下**:

方法: `Xxxx now();`, 静态方法，根据当前时间创建对象

> `LocalDate localDate = LocalDate.now();`
> 
> `LocalTime llocalTime = LocalTime.now();`
> 
> `LocalDateTime localDateTime = LocalDateTime.now();`

方法: `Xxxx of(…);`, 静态方法，指定日期/时间创建对象

> `LocalDate localDate1 = LocalDate.of(2099 , 11,11);`
> 
> `LocalTime localTime1 = LocalTime.of(11, 11, 11);`
> 
> `LocalDateTime localDateTime1 = LocalDateTime.of(2020, 10, 6, 13, 23, 43);`

**基本演示代码**:

> 根据当前时间创建对象

public static void main(String[] args) {
        
        // 只有日期
        LocalDate date = LocalDate.now();
        // 只有时间
        LocalTime time = LocalTime.now();
        // 日期和时间
        LocalDateTime dateTime = LocalDateTime.now();
    
        System.out.println(date); // 2022-10-14
        System.out.println(time); // 16:56:11.833919
        System.out.println(dateTime); // 2022-10-14T16:56:11.833935
    }

> 根据指定日期创建对象

public static void main(String[] args) {
        
            // 指定时间创建对象
            // 指定年月日
            LocalDate date1 = LocalDate.of(2019, 6, 9);
            // 指定时分秒纳秒
            LocalTime time1 = LocalTime.of(12, 34, 53, 5);
            // 指定年月日时分秒
            LocalDateTime dateTime1 = LocalDateTime.of(2019, 6, 29, 12, 23, 52, 1);
            System.out.println(date1); // 2019-06-09
            System.out.println(time1); // 12:34:53.000000005
            System.out.println(dateTime1); // 2019-06-29T12:23:52.000000001
        }
    }

> LocalDate还可以单独获取年、月、日、星期，示例代码如下：

public class LocalDateDemo {
        
        public static void main(String[] args) {
        
            LocalDate date = LocalDate.now();
    
            // 获取年
            System.out.println(date.getYear()); // 2022
            // 获取月
            System.out.println(date.getMonth()); // OCTOBER
            // 获取1月当中第几天
            System.out.println(date.getDayOfMonth()); // 14
            // 获取1年当中第几天
            System.out.println(date.getDayOfYear()); // 287
            // 获取1星期中第几天
            System.out.println(date.getDayOfWeek()); // FRIDAY
        }
    }

> LocalTime还可以获取小时、分钟、秒钟、纳秒，示例代码如下：

public class LocalTimeDemo {
        
        public static void main(String[] args) {
        
            LocalTime time = LocalTime.now();
    
            // 获取小时
            System.out.println(time.getHour());
            // 获取分钟
            System.out.println(time.getMinute());
            // 获取秒钟
            System.out.println(time.getSecond());
            // 获取纳秒
            System.out.println(time.getNano());
        }
    }

> LocalDateTime不仅可以单独获取年月日, 还可以获取时分秒;
> 
> LocalDateTime相当于包含LocalDate和LocalTime, 因此LocalDateTime对象可以转换为LocalDate和LocalTime对象

public class LocalDateTimeDemo {
        
        public static void main(String[] args) {
        
            LocalDateTime ldt = LocalDateTime.now();
            System.out.println(ldt); // 2022-10-14T17:33:23.048031
    
            // 转为日期对象
            LocalDate ld = ldt.toLocalDate();
            // 转为时间对象
            LocalTime lt = ldt.toLocalTime();
            System.out.println(ld); // 2022-10-14
            System.out.println(lt); // 17:33:23.048031
        }
    }

##### 修改日期时间相关方法 #####

> LocalDateTime 综合了 LocalDate 和 LocalTime 里面的方法，所以下面只用 LocalDate 和 LocalTime 来举例。
> 
> 这些方法返回的是一个新的实例引用，因为LocalDateTime 、LocalDate 、LocalTime 都是**不可变的**。

<table> 
 <thead> 
  <tr> 
   <th>方法名</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>plusDays, plusWeeks, plusMonths, plusYears</td> 
   <td>向当前 LocalDate 对象添加几天、几周、几个月、几年</td> 
  </tr> 
  <tr> 
   <td>minusDays, minusWeeks, minusMonths, minusYears</td> 
   <td>从当前 LocalDate 对象减去几天、几周、几个月、几年</td> 
  </tr> 
  <tr> 
   <td>withDayOfMonth, withDayOfYear, withMonth, withYear</td> 
   <td>将月份天数、年份天数、月份、年份修改为指定的值并返回新的LocalDate 对象</td> 
  </tr> 
  <tr> 
   <td>isBefore, isAfter</td> 
   <td>比较两个 LocalDate</td> 
  </tr> 
 </tbody> 
</table>

**演示代码**:

> 向当前LocalDate对象添加几天、几周、几个月、几年
> 
> 向当前LocalTime对象添加几时, 几分, 几秒, 几纳秒

public class UpDateTime {
        
        public static void main(String[] args) {
        
            LocalDate date = LocalDate.now();
    
            // 当前日期
            System.out.println(date); // 2022-10-14
            // 当前日期添加两天
            System.out.println(date.plusDays(2)); // 2022-10-16
            // 当前日期添加2月
            System.out.println(date.plusMonths(2)); // 2022-12-14
            // 当前时间添加10年
            System.out.println(date.plusYears(10)); // 2032-10-14
    
            LocalTime time = LocalTime.now();
    
            // 当前时间
            System.out.println(time);
            // 当前时间加2小时
            System.out.println(time.plusHours(2)); // 17:51:59.346348
            // 当前时间加10分钟
            System.out.println(time.plusMinutes(10)); // 18:01:59.346348
            // 当前时间加30秒
            System.out.println(time.plusSeconds(30)); // 17:52:29.346348
            // 当前时间加100纳秒
            System.out.println(time.plusNanos(100)); // 17:51:59.346348100
        }
    }

> 从当前 LocalDate 对象减去几天、几周、几个月、几年
> 
> 从当前 LocalTime 对象减去几小时、几分钟、几秒钟、几纳秒

public class UpDateTime2 {
        
        public static void main(String[] args) {
        
            LocalDate date = LocalDate.now();
    
            // 当前日期
            System.out.println(date); // 2022-10-14
            // 当前日期减少两天
            System.out.println(date.minusDays(2)); // 2022-10-12
            // 当前日期减少2月
            System.out.println(date.minusMonths(2)); // 2022-08-14
            // 当前时间减少10年
            System.out.println(date.minusYears(10)); // 2012-10-14
    
            LocalTime time = LocalTime.now();
    
            // 当前时间
            System.out.println(time);
            // 当前时间减去2小时
            System.out.println(time.minusHours(2)); // 15:58:15.366978
            // 当前时间减去10分钟
            System.out.println(time.minusMinutes(10)); // 17:48:15.366978
            // 当前时间减去30秒
            System.out.println(time.minusSeconds(30)); // 17:57:45.366978
            // 当前时间减去100纳秒
            System.out.println(time.minusNanos(100)); // 17:58:15.366977900
        }
    }

> isBefore, isAfter比较两个时间的方法, 示例代码如下:

public static void main(String[] args) {
        
    
        // 定义一个时间
        LocalDate oldDate = LocalDate.of(2019, 6, 29);
        // 获取当前时间
        LocalDate nowDate = LocalDate.now();
    
        // 比较时间
        System.out.println(nowDate.isBefore(oldDate)); // false
        System.out.println(nowDate.isAfter(oldDate)); // true
    }

##### Instant时间戳 #####

> JDK8获取时间戳特别简单，且功能更丰富。Instant类由一个静态的工厂方法now()可以返回当前时间戳。

public class InstantDemo {
        
        public static void main(String[] args) {
        
            // 获取国际时间戳对象
            Instant instant = Instant.now();
            System.out.println(instant); // 2022-10-14T10:40:30.621346Z
    
            // 获取中国当前的时间对象
            System.out.println(instant.atZone(ZoneId.systemDefault())); // 2022-10-14T18:40:30.621346+08:00[Asia/Shanghai]
        }
    }

> 时间戳是包含日期和时间的，与java.util.Date很类似，事实上Instant就是类似JDK8 以前的Date。
> 
> Instant和Date这两个类可以进行转换。

public class InstantDemo {
        
        public static void main(String[] args) {
        
            // 获取国际时间戳对象, 北京时间+8小时＝国际时间
            Instant instant = Instant.now();
            System.out.println(instant); // 2022-10-14T10:40:30.621346Z
    
            // 将Instant转为Date对象
            Date date = Date.from(instant);
            System.out.println(date); // Fri Oct 14 18:52:45 CST 2022
            // Date也可以转回Instant
            Instant ins = date.toInstant();
            System.out.println(ins); // 2022-10-14T10:52:45.160Z
        }
    }

##### DateTimeFormatter #####

> 在JDK8中，引入了一个全新的日期与时间格式器DateTimeFormatter。
> 
> 正反都能调用format方法来格式化时间。

public class Format {
        
        public static void main(String[] args) {
        
            LocalDateTime ldt = LocalDateTime.now();
            System.out.println(ldt); // 2022-10-14T19:01:22.072597
    
            DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
            // 正向格式化
            System.out.println(dtf.format(ldt)); // 2022-10-14 19:01:22
            // 反向格式化
            System.out.println(ldt.format(dtf)); // 2022-10-14 19:01:22
        }
    }

> 解析字符串时间为日期对象, 解析完成后就可以调用日期的方法

public class Format {
        
        public static void main(String[] args) {
        
            // 创建格式化器
            DateTimeFormatter dtf1 = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
            // 调用parse方法, 传入解析的时间和格式化器
            LocalDateTime ldt1 = LocalDateTime.parse("2011-11-11 11:11:11", dtf1);
            System.out.println(ldt1); // 2011-11-11T11:11:11
        }
    }

[c67ec92dce844a18b552ec1edaeb74d7.png_pic_center]: https://img-blog.csdnimg.cn/c67ec92dce844a18b552ec1edaeb74d7.png#pic_center