Java日期与时间API（详解全部新与旧API，含代码例子）

谁借莪１个温暖的怀抱￠ 2023-09-28 21:46 5阅读 0赞

**目录**

前言必读

二、新与旧API

新的API：

旧的API：

初步使用大全(SimpleDateFormat)

三、代码例子

1.获取当前时间

2.字符串转化为时间

四、新的API

1.LocalDate（新API）

2.LocalTime（新API）

3.LocalDateTime（新API）

4.DateTimeFormatter（新API）

5. Instant（新API）

6.period、Duration（新API）

7.Duration例子:

## 前言必读 ##

> [读者手册（必读）\_云边的快乐猫的博客-CSDN博客][-CSDN]

1.在时间工具类里面重点学习这两个就差不多了**LocalDateTime（全部）**和**DateTimeFormatter（转化格式）**

2.使用date和SimpleDateFormat配套使用(老旧API,线程不安全)。

使用LocalDateTime或ZonedLocalDateTime时，就用DateTimeFormatter配套使用。(新API，线程安全)。

## 二、新与旧API ##

### 新的API： ###

Instant:时间戳或者瞬间

LocalDate:本地日期(不包含具体时间)、period(只能精确到年月日)

LocalTime:本地时间(不包含年月日)、Duration(只能到天数后面的具体时间)

LocalDateTime:包含日期和时间(不包时差和时区)

ZonedDateTime:全包-------其中的localdate代替了Date，DateTimeFormatter代替了SimpleDateFormat，解决了线程不安全的问题

### 旧的API： ###

不建议使用了，线程不安全(Date ，Calendar，SimpleDateFormat)

### 初步使用大全(**SimpleDateFormat**) ###

> 日期和时间的获取有不同的方式
> 
> 年:yyyy
> 
> 月:MM
> 
> 日:dd
> 
> 小时(24小时制):HH
> 
> 分:mm
> 
> 毫秒:ss
> 
> 上下午标识:a
> 
> 24小时制:k
> 
> 12小时制:K
> 
> 时区:zZ
> 
> 星期几:E
> 
> 年中的天数:D
> 
> 年中的周数:w
> 
> 月份中的周数(实际计算):W

## 三、代码例子 ##

### **1.**获取当前时间 ###

package bao;
    import java.text.SimpleDateFormat;
    import java.util.Date;
    
    public class Test {
        public static void main(String[] args) {
            //1.创建日期对象
            Date d = new Date();
            //1.格式化日期对象
            SimpleDateFormat sdf = new SimpleDateFormat("yyyy年MM月dd日 HH:mm:ss EEE a k点,K点,时区:zZ,年中的周数:w,月份中的周数:W,年中的天数:D");
            //2.转化成字符串形式，括号里面填的就是首次创建对象的自变量值
            String rs = sdf.format(d);
            //4.输出当前日期
            System.out.println(rs);
        }
    }

运行结果:

> 2022年06月25日 18:42:38 周一 下午 21点,9点,时区:CST+0800,年中的周数:25,月份中的周数:3,年中的天数:204

### **2.**字符串转化为时间  ###

案例:把2022年08月07日06点05分04秒，往后走2天后5小时4分3秒时间是多少

package bao;
    import java.text.ParseException;
    import java.text.SimpleDateFormat;
    import java.util.Date;
    
    public class Test {
        public static void main(String[] args) throws ParseException {
            //1.日期储存在字符串中
            String dataStr ="2022年08月07日 06:05:04";
            //2.开始解析，解析格式对应
            SimpleDateFormat sdf = new SimpleDateFormat("yyyy年MM月dd日 HH:mm:ss");
            //为了避免异常，要抛出异常，快捷键:alt+回车键
            Date d = sdf.parse(dataStr);
            //3.计算2天后5小时4分3秒时间
            long time = d.getTime()+(2L*24*60*60 + 5*60*60 + 4*60 + 3)*1000;
            //输出结果公式:new出来的自定义变量+format+最新的计算后自定义变量
            System.out.println(sdf.format(time));
        }
    }

运行结果:

> 2022年08月09日 11:09:07

## **四、新的API**  ##

### **1.****LocalDate**（新API） ###

package bao;
    import java.time.LocalDate;
    
    public class Test {
        public static void main(String[] args) {
            //本地的日期
            LocalDate nowDate = LocalDate.now();
            System.out.println(nowDate);
            //年
            int year = nowDate.getYear();
            System.out.println(year);
            //月
            int month = nowDate.getMonthValue();
            System.out.println(month);
            //日
            int day = nowDate.getDayOfMonth();
            System.out.println(day);
            //获取其他的参考本文中的LocalDateTime
        }
    }

运行结果:

> 2022-08-25  
> 2022  
> 8  
> 25

### **2.LocalTime**（新API） ###

package bao;
    import java.time.LocalDateTime;
    
    public class Test {
        public static void main(String[] args) {
            //本地的时间
            LocalDateTime nowTime = LocalDateTime.now();
            System.out.println(nowTime);
            //小时
            int hour = nowTime.getHour();
            System.out.println(hour);
            //分钟
            int minute = nowTime.getMinute();
            System.out.println(minute);
            //秒
            int second = nowTime.getSecond();
            System.out.println(second);
            //纳秒
            int nano = nowTime.getNano();
            System.out.println(nano);
            //转到指定的时间
            System.out.println(LocalDateTime.of(1990,10,1,13,14,15,0));
        }
    }

运行结果:

> 2022-08-25T12:55:57.729269100  
> 12  
> 55  
> 57  
> 729269100  
> 1990-10-01T13:14:15

### **3.LocalDateTime**（新API） ###

例子：

//本地的时间
            LocalDateTime today = LocalDateTime.now();
            System.out.println(today);
            //生日的时间
            LocalDateTime birthDate = LocalDateTime.of(1990,10,1,8,7,6);
            System.out.println(birthDate);
            //开始对比
            System.out.println("相差的年数"+ ChronoUnit.YEARS.between(birthDate,today));
            System.out.println("相差的月数"+ ChronoUnit.MONTHS.between(birthDate,today));
            System.out.println("相差的周数"+ ChronoUnit.WEEKS.between(birthDate,today));
            System.out.println("相差的天数"+ ChronoUnit.DAYS.between(birthDate,today));
            System.out.println("相差的时数"+ ChronoUnit.HOURS.between(birthDate,today));
            System.out.println("相差的分数"+ ChronoUnit.MINUTES.between(birthDate,today));
            System.out.println("相差的秒数"+ ChronoUnit.SECONDS.between(birthDate,today));
            System.out.println("相差的毫秒数"+ ChronoUnit.MILLIS.between(birthDate,today));
            System.out.println("相差的微秒数"+ ChronoUnit.MICROS.between(birthDate,today));
            System.out.println("相差的纳秒数"+ ChronoUnit.NANOS.between(birthDate,today));
            System.out.println("相差的半天数"+ ChronoUnit.HALF_DAYS.between(birthDate,today));
            System.out.println("相差的十年数"+ ChronoUnit.DECADES.between(birthDate,today));
            System.out.println("相差的世纪(百年)数"+ ChronoUnit.CENTURIES.between(birthDate,today));
            System.out.println("相差的千年数"+ ChronoUnit.MILLENNIA.between(birthDate,today));
            System.out.println("相差的纪元数"+ ChronoUnit.ERAS.between(birthDate,today));

运行结果:

> 2022-08-25T10:31:57.963103  
> 1990-10-01T08:07:06  
> 相差的年数31  
> 相差的月数382  
> 相差的周数1664  
> 相差的天数11651  
> 相差的时数279626  
> 相差的分数16777584  
> 相差的秒数1006655091  
> 相差的毫秒数1006655091963  
> 相差的微秒数1006655091963103  
> 相差的纳秒数1006655091963103000  
> 相差的半天数23302  
> 相差的十年数3  
> 相差的世纪(百年)数0  
> 相差的千年数0  
> 相差的纪元数0

### **4.DateTimeFormatter**（新API） ###

package bao;
    import java.time.LocalDateTime;
    import java.time.format.DateTimeFormatter;
    
    public class Test {
        public static void main(String[] args) {
            //本地的时间
            LocalDateTime ldt = LocalDateTime.now();
            //解析格式化时间
            DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
            //正向格式化
            String a = ldt.format(dtf);
            System.out.println(a);
            //逆向格式化
            String b = dtf.format(ldt);
            System.out.println(b);
    
            //解析字符串时间,转换成本地时间。dtf是上面那个解析器，代表要解析成那样的格式,注意点:字符串如果和解析器对应不上就会报错的
            LocalDateTime JieXi = LocalDateTime.parse("2019-11-11 11:11:11", dtf);
            System.out.println(JieXi);
        }
    }

运行结果:

> 2022-08-25 13:32:06  
> 2022-08-25 13:32:06  
> 2019-11-11T11:11:11

### **5.****Instant**（新API） ###

例子：

//得到一个时间戳
            Instant instant = Instant.now();
            System.out.println(instant);
            //得到系统的时间戳
            Instant instant1 = Instant.now();
            System.out.println(instant.atZone(ZoneId.systemDefault()));
            //时间戳(instant)转data
            Date date = Date.from(instant);
            System.out.println(date);
            //data转时间戳(instant)
            Instant instant2 = date.toInstant();
            System.out.println(instant2);

运行结果:

> 2022-08-25T01:52:14.561748900Z  
> 2022-08-25T09:52:14.561748900+08:00\[Asia/Shanghai\]  
> Thu Aug 25 09:52:14 CST 2022  
> 2022-08-25T01:52:14.561Z

### **6.period**、**Duration**（新API） ###

可以计算出生到现在过去了多久

period例子:

//本地的时间
            LocalDate today = LocalDate.now();
            System.out.println(today);
            //生日的时间
            LocalDate birthDate = LocalDate.of(1990,10,1);
            System.out.println(birthDate);
            //开始对比
            Period period = Period.between(birthDate, today);//第二个参数减第一个参数
            System.out.println(period.getYears());
            System.out.println(period.getMonths());
            System.out.println(period.getDays());

运行结果：

> 2022-08-25  
> 1990-10-01  
> 31
> 
> 10  
> 24

### 7.Duration例子: ###

//本地的时间
            LocalDateTime today = LocalDateTime.now();
            System.out.println(today);
            //生日的时间
            LocalDateTime birthDate = LocalDateTime.of(1990,10,1,0,0,0);
            System.out.println(birthDate);
            //开始对比
            Duration duration = Duration.between(birthDate, today);//第二个参数减第一个
            System.out.println(duration.toDays());//时间差的天数
            System.out.println(duration.toHours());//时间差的小时数
            System.out.println(duration.toMinutes());//时间差的分钟数
            System.out.println(duration.toMillis());//时间差的毫秒数
            System.out.println(duration.toNanos());//时间差的纳秒数

运行结果：

> 2022-08-25T11:29:10.515524900  
> 1990-10-01T00:00  
> 11651  
> 279635  
> 16778129  
> 1006687750515  
> 1006687750515524900

[-CSDN]: https://blog.csdn.net/m0_52861000/article/details/128148568?spm=1001.2014.3001.5501