【Java】常用API（日期与时间）

Date

        Date类代表当前所在系统的日期时间信息

 Date的构造器

Date的常用方法

时间毫秒值→日期对象

public class DateDemo {
    public static void main(String[] args) {
        // 1、创建一个Date日期对象：代表了系统当前此刻日期时间信息
        Date d = new Date();
        System.out.println(d);

        // 2、获取时间毫秒值的形式：从19700101 0:0:0开始走到此刻的总毫秒值
        long time = d.getTime();  // long time = System.currentTimeMillis();
        System.out.println(time);

        System.out.println("-------------------");
        time += (60 * 60 + 123) * 1000;
        // 3、把时间毫秒值转换成日期对象
//        Date d2 = new Date(time);
//        System.out.println(d2);

        // 与上述代码逻辑一样，只是写法不同
        Date d2 = new Date();
        d2.setTime(time); // 修改日期对象成为time这个时间
        System.out.println(d2);
    }
}

1.日期对象如何创建，如何获取时间毫秒值？

        public  Date();

        public long getTime();

2.时间毫秒值怎么恢复成日期对象

        public Date(long time);

        public void setTime(long time); 

SimpleDateFormat

        可以去完成日期时间的格式化操作

样式：

        Date对象         →       2025年5月20日 13:14:00

        时间毫秒值      →       2025年5月20日 13:14:00

构造器

格式化方法

public class SimpleDateFormatDemo {
    public static void main(String[] args) {
        // 1、日期对象
        Date d = new Date();
        System.out.println(d);

        // 2、开始格式化：创建一个简单日期格式化对象
        // 注意：参数是格式化之后的时间形式，必须申明！
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy年MM月dd日 HH:mm:ss EEE a");

        // 3、开始格式化日期对象成为字符串形式
        String result = sdf.format(d);
        System.out.println(result);

        System.out.println("--------格式化时间毫秒值----------");
        long time = d.getTime() + 123 * 1000;
        System.out.println(sdf.format(time));
    }
}

解析方法

 解析字符串时间成为日期对象

        2025年5月20日 13:14:00 → Date日期对象

public class SimpleDateFormatDemo {
    public static void main(String[] args) throws ParseException {
        // 目标: 学会使用SimpleDateFormat解析字符串时间成为日期对象。
        // System.out.println("-----------案例驱动式教学：学习解析字符串时间--------------");
        // 有一个时间 2022年05月27日 12:12:12 往后 2天 12小时 24分 36秒后的时间是多少。
        // 1、拿到程序中来
        String timeStr = "2022年05月27日 12:12:12";

        // 2、把字符串时间解析成日期对象（本节重点）
        // 严重注意：简单日期格式化对象的入参形式必须与被解析的时间的形式完全一致，否则后期解析失败！！
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy年MM月dd日 HH:mm:ss");
        Date d = sdf.parse(timeStr); // 解析


        // 3、获取日期对象的时间毫秒值  + 2天14小时49分06秒
        long time = d.getTime() + (24L * 2 *60 * 60 + 12 * 60 *60 + 24 * 60 + 36) * 1000;

        // 4、格式化
        System.out.println("答案是：" +  sdf.format(time));
    }
}

Calendar

        Calendar代表了系统此刻日期对应的日历对象

        Calendar是一个抽象类，不能直接创建对象

Calendar日历类创建日历对象的方法

Calendar常用方法

注意：calendar是可变日期对象，一旦修改后其对象本身表示的时间将产生变化

public class CalendarDemo{
    public static void main(String[] args) {
        // 1、拿到系统此刻日历对象
        Calendar rightNow = Calendar.getInstance();
        System.out.println(rightNow);

        // 2、获取日历的信息:public int get(int field)：取日期中的某个字段信息。
        int year = rightNow.get(Calendar.YEAR);
        System.out.println(year);

        int mm = rightNow.get(Calendar.MONTH);
        System.out.println(mm + 1);

        int days = rightNow.get(Calendar.DAY_OF_YEAR);
        System.out.println(days);

        // 3、public void set(int field,int value)：修改日历的某个字段信息。 (用的很少)
        //rightNow.set(Calendar.HOUR , 12);
        //System.out.println(rightNow);

        // 4.public void add(int field,int amount)：为某个字段增加/减少指定的值
        // 请问64天后是什么时间
        //rightNow.add(Calendar.DAY_OF_YEAR , 64);
        // rightNow.add(Calendar.HOUR , 4);
        // System.out.println(rightNow);

        // 5.public final Date getTime(): 拿到此刻日期对象。(用的很少)
        Date d = rightNow.getTime();
        System.out.println(d);

        // 6.public long getTimeInMillis(): 拿到此刻时间毫秒值
        long time = rightNow.getTimeInMillis();
        System.out.println(new SimpleDateFormat("yyyy/MM/dd HH:mm:ss").format(time));
    }
}

JDK8新增日期类

        从Java 8开始，java.time包提供了新的日期和时间API       

新增的API严格区分了时刻 本地日期 本地时间，并且对日期和时间进行运算更加方便

其次，新API的类型几乎全部是不变类型（和String的使用类似），不必担心被修改

LocalDate：                 不包含具体时间的日期。

LocalTime：                不含日期的时间。

LocalDateTime：        包含了日期及时间。

Instant：                      代表的是时间戳。

DateTimeFormatter： 用于做时间的格式化和解析

Duration：                   用于计算两个“时间”间隔

Period：                       用于计算两个“日期”间隔

LocalDate LocalTime LocalDateTime

        它们分别表示日期 时间 日期时间对象，他们的类的实例是不可变的对象

它们三者构建对象和API都是通用的

LocalDate LocalTime LocalDateTime构建对象

LocalDate

public class DemoLocalDate {
    public static void main(String[] args) {
        // 1、获取本地日期对象。
        LocalDate nowDate = LocalDate.now();
        //今天的日期：
        System.out.println("今天的日期：" + nowDate);

        int year = nowDate.getYear();
        System.out.println("year：" + year);

        int month = nowDate.getMonthValue();
        System.out.println("month：" + month);

        int day = nowDate.getDayOfMonth();
        System.out.println("day：" + day);

        //当年的第几天
        int dayOfYear = nowDate.getDayOfYear();
        System.out.println("dayOfYear：" + dayOfYear);

        //星期
        System.out.println(nowDate.getDayOfWeek());
        System.out.println(nowDate.getDayOfWeek().getValue());

        //月份
        System.out.println(nowDate.getMonth());
        System.out.println(nowDate.getMonth().getValue());

        LocalDate bt = LocalDate.of(2025, 5, 20);
        //直接传入对应的年月日
        System.out.println(bt);
        //相对上面只是把月换成了枚举
        System.out.println(LocalDate.of(2025, Month.MAY, 20));//相对上面只是把月换成了枚举
    }
}

LocalTime

public class DemoLocalTime {
    public static void main(String[] args) {
        // 1、获取本地时间对象。
        LocalTime nowTime = LocalTime.now();
        //今天的时间：
        System.out.println("今天的时间：" + nowTime);

        int hour = nowTime.getHour();//时
        System.out.println("hour：" + hour);//hour：

        int minute = nowTime.getMinute();//分
        System.out.println("minute：" + minute);//minute：

        int second = nowTime.getSecond();//秒
        System.out.println("second：" + second);//second：

        int nano = nowTime.getNano();//纳秒
        System.out.println("nano：" + nano);//nano：

        System.out.println("---------------");
        LocalTime time = LocalTime.of(8, 30);
        System.out.println(time);//时分
        System.out.println(LocalTime.of(8, 20, 30));//时分秒
        System.out.println(LocalTime.of(8, 20, 30, 150));//时分秒纳秒
        LocalTime iTime = LocalTime.of(8, 20, 30, 150);

        System.out.println("---------------");
        System.out.println(LocalDateTime.of(1999, 11, 11, 8, 20));
        System.out.println(LocalDateTime.of(1999, Month.NOVEMBER, 11, 8, 20));
        System.out.println(LocalDateTime.of(1999, 11, 11, 8, 20, 30));
        System.out.println(LocalDateTime.of(1999, Month.NOVEMBER, 11, 8, 20, 30));
        System.out.println(LocalDateTime.of(1999, 11, 11, 8, 20, 30, 150));
        System.out.println(LocalDateTime.of(1999, Month.NOVEMBER, 11, 8, 20, 30, 150));
    }
}

LocalDateTime

public class DemoLocalDateTime {
    public static void main(String[] args) {
        // 日期 时间
        LocalDateTime nowDateTime = LocalDateTime.now();
        //今天是：
        System.out.println("今天是：" + nowDateTime);
        System.out.println(nowDateTime.getYear());//年
        System.out.println(nowDateTime.getMonthValue());//月
        System.out.println(nowDateTime.getDayOfMonth());//日
        System.out.println(nowDateTime.getHour());//时
        System.out.println(nowDateTime.getMinute());//分
        System.out.println(nowDateTime.getSecond());//秒
        System.out.println(nowDateTime.getNano());//纳秒
        //日：当年的第几天
        System.out.println(nowDateTime.getDayOfYear());
        //星期
        System.out.println(nowDateTime.getDayOfWeek());//枚举
        System.out.println(nowDateTime.getDayOfWeek().getValue());//数组
        //月份
        System.out.println(nowDateTime.getMonth());//枚举
        System.out.println(nowDateTime.getMonth().getValue());//数组


        LocalDate ld = nowDateTime.toLocalDate();
        System.out.println(ld);

        LocalTime lt = nowDateTime.toLocalTime();
        System.out.println(lt.getHour());//小时
        System.out.println(lt.getMinute());//分钟
        System.out.println(lt.getSecond());//秒
    }
}

LocalDate LocalTime LocalDateTime获取信息的API

LocalDateTime转换相关的API

LocalDateTime的转换API

修改相关的API

         LocalDateTime 综合了 LocalDate 和 LocalTime 里面的方法，所以下面只用 LocalDate 和 LocalTime 来举例

        这些方法返回的是一个新的实例引用，因为LocalDateTime 、LocalDate 、LocalTime 都是不可变的

public class DemoUpdateTime {
    public static void main(String[] args) {
        LocalTime nowTime = LocalTime.now();
        System.out.println(nowTime);//当前时间
        System.out.println(nowTime.minusHours(1));//一小时前
        System.out.println(nowTime.minusMinutes(1));//一分钟前
        System.out.println(nowTime.minusSeconds(1));//一秒前
        System.out.println(nowTime.minusNanos(1));//一纳秒前
        System.out.println(nowTime);

        System.out.println("----------------");

        System.out.println(nowTime.plusHours(1));//一小时后
        System.out.println(nowTime.plusMinutes(1));//一分钟后
        System.out.println(nowTime.plusSeconds(1));//一秒后
        System.out.println(nowTime.plusNanos(1));//一纳秒后

        System.out.println("----------------");
        // 不可变对象，每次修改产生新对象！
        System.out.println(nowTime);

        System.out.println("----------------");
        LocalDate myDate = LocalDate.of(2022, 5, 27);
        LocalDate nowDate = LocalDate.now();

        System.out.println("今天是2022-5-27吗？ " + nowDate.equals(myDate));//false
        System.out.println(myDate + "是否在" + nowDate + "之前？ " + myDate.isBefore(nowDate));//true
        System.out.println(myDate + "是否在" + nowDate + "之后？ " + myDate.isAfter(nowDate));//false

        System.out.println("----------------");
        // 判断今天是否是你的生日
        LocalDate birDate = LocalDate.of(2022, 5, 27);
        LocalDate nowDate1 = LocalDate.now();

        // 提取你的 月 和 日 对象封装成月日对象
        MonthDay birMd = MonthDay.of(birDate.getMonthValue(), birDate.getDayOfMonth());
        MonthDay nowMd = MonthDay.from(nowDate1);
        System.out.println("今天是你的生日吗？ " + birMd.equals(nowMd));//今天是你的生日吗？ false
    }
}

Instant时间戳

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

例：

//非完整代码
Instant instant = Instant.now();
System.out.println("当前时间戳是：" + instant);

Date date = Date.from(instant);
System.out.println("当前时间戳是：" + date);

instant = date.toInstant();
System.out.println(instant);

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

public class DemoInstant {
    public static void main(String[] args) {
        // 1、得到一个Instant时间戳对象
        Instant instant = Instant.now();
        System.out.println(instant);

        // 2、系统此刻的时间戳怎么办？
        Instant instant1 = Instant.now();
        System.out.println(instant1.atZone(ZoneId.systemDefault()));

        // 3、如何去返回Date对象
        Date date = Date.from(instant);
        System.out.println(date);

        Instant i2 = date.toInstant();
        System.out.println(i2);

        LocalDateTime ldt = LocalDateTime.ofInstant(i2, ZoneId.systemDefault() );
        System.out.println(ldt.getDayOfMonth());
    }
}

DateTimeFormatter

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

//非完整代码
LocalDateTime ldt = LocalDateTime.now();
System.out.println(ldt);//2022-05-30T21:13:39.450

DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
String ldtStr = ldt.format(dtf);
System.out.println(ldtStr);//2022-05-30 21:13:39

String ldtStr1 = dtf.format(ldt);
System.out.println(ldtStr1);//2022-05-30 21:13:39

public class DemoDateTimeFormat {
    public static void main(String[] args) {
        // 本地此刻  日期时间 对象
        LocalDateTime ldt = LocalDateTime.now();
        System.out.println(ldt);

        // 解析/格式化器
        DateTimeFormatter dtf =
                DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss EEE a");
        // 正向格式化
        System.out.println(dtf.format(ldt));
        // 逆向格式化
        System.out.println(ldt.format(dtf));

        // 解析字符串时间
        DateTimeFormatter dtf1 = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        // 解析当前字符串时间成为本地日期时间对象
        LocalDateTime ldt1 = LocalDateTime.parse("2022-11-11 11:11:11" ,  dtf1);
        System.out.println(ldt1);
        System.out.println(ldt1.getDayOfYear());
    }
}

Period

        在JDK8中，我们可以使用以下类来计算日期间隔差异：java.time.Period

主要是 Period 类方法 getYears() getMonths() getDays() 来计算，只能精确到年月日
用于 LocalDate 之间的比较

LocalDate today = LocalDate.now();
System.out.println(today);// 2022-05-27

LocalDate birthDate = LocalDate.of(1999, 1, 11);
System.out.println(birthDate); // 1999-01-11

Period period = Period.between(birthDate, today);
System.out.printf("年龄:%d年%d月%d日", period.getYears(), period.getMonths(), period.getDays());

public class DemoPeriod {
    public static void main(String[] args) {
        // 当前本地 年月日
        LocalDate today = LocalDate.now();
        System.out.println(today);// 2022-5-27

        // 生日的 年月日
        LocalDate birthDate = LocalDate.of(1999, 1, 13);
        System.out.println(birthDate); // 1999-1-13

        Period period = Period.between(birthDate, today);//第二个参数减第一个参数
        System.out.println(period.getYears());
        System.out.println(period.getMonths());
        System.out.println(period.getDays());
        System.out.println(period.toTotalMonths());
    }
}

Duration

        在JDK8中，我们可以使用以下类来计算时间间隔差异：java.time.Duration

提供了使用基于时间的值测量时间量的方法
用于 LocalDateTime 之间的比较，也可用于 Instant 之间的比较

//非完整代码
LocalDateTime today = LocalDateTime.now();
System.out.println(today);
LocalDateTime birthDate = LocalDateTime.of(1990,10,1,10,50,30);
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());//两个时间差的纳秒数

public class DemoDuration {
    public static void main(String[] args) {
        // 本地日期时间对象。
        LocalDateTime today = LocalDateTime.now();
        System.out.println(today);

        // 出生的日期时间对象
        LocalDateTime birthDate = LocalDateTime.of(1999,10
                ,10,13,00,00);

        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());//两个时间差的纳秒数
    }
}

ChronoUnit

        java.time.temporal.ChronoUnit 

        可用于在单个时间单位内测量一段时间，这个工具类是最全的了，可以用于比较所有的时间单位

public class DemoChronoUnit {
    public static void main(String[] args) {
        // 本地日期时间对象：此刻的
        LocalDateTime today = LocalDateTime.now();
        System.out.println(today);

        // 生日时间
        LocalDateTime birthDate = LocalDateTime.of(1990,10,1,10,50,59);
        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));
    }
}