日期时间API

合集 - JavaBase(25)

1.BigInteger与BigDecimal类2024-08-252.Java字符集2022-07-213.枚举类2024-08-254.Java比较器Comparable与Comparator2024-08-255.Java中System类2024-08-256.Java中Math类2024-08-257.Java内部类2024-08-258.Java关键字：this、super、final2024-08-259.Java代码块2024-08-2510.Java中继承性、多态性2024-08-2511.Java接口2020-11-2812.子类对象实例化的全过程2021-01-0213.static关键字2021-01-0214.Java中的关键字transient2021-02-0715.double转String结果为指数问题2021-10-2016.Java注解2022-07-04

17.日期时间API2022-07-21

18.String字符串函数2022-07-2119.Excepton异常类2022-07-2320.IO流2022-07-3121.Java反射机制2022-08-0822.JDK与JRE区别2024-08-2523.Java位运算2024-08-2524.Java方法重载2024-08-2525.Java属性赋值的先后顺序与对象的实例化过程2024-08-25

收起

目录

• JDK8之前的日期时间API
  • System类
  • Date日期类
    • 构造器
    • 常用方法
  • SimpleDateFormat日期格式化类
    • 构造方法
    • 格式规则
    • 常用方法
  • Calendar日历类
    • 获取方式
    • 常用方法
• JDK8日期时间API
  • LocaIDate、LocalTime、LocaIDateTime
  • Instant瞬时类
  • DateTimeFormatter格式化与解析日期或时间
  • 其他API

JDK8之前的日期时间API

System类

System类提供的public static long currentTimeMillis()用来返回当前时间与1970年1月1日0时0分0秒之间以毫秒为单位的时间差。此方法适用于计算时间差。

计算世界时间的主要标准有：

UTC(Coordinated Universal Time)

GMT(Greenwich Mean Time)

CST(Central Standard Time)

🌰：

@Test
public void test1() {
    long time = System.currentTimeMillis();
    //返回当前时间与1970年1月1日0时0分0秒之间以毫秒为单位的时间差。
    //称为时间戳
    System.out.println(time); // 1658149573357
}

Date日期类

java.util.Date表示特定的瞬间，精确到毫秒。

构造器

Date()：使用无参构造器创建的对象可以获取本地当前时间。

Date(long date)：创建指定毫秒数的Date对象

常用方法

getTime()：返回自1970年1月1日00:00:00 GMT以来此Date对象表示的毫秒数。

toString()：把此Date对象转换为以下形式的String：dow mon dd hh:mm:ss zzz yyyy其中，dow是一周中某一天(Sun、Mon、Tue、Wed、Thu、Fri、Sat)，zzz是时间标准。

其他很多方法都过时了。

🌰：

	/*
    java.util.Date类
           |---java.sql.Date类
 
    1.两个构造器的使用
        >构造器一：Date()：创建一个对应当前时间的Date对象
        >构造器二：创建指定毫秒数的Date对象
    2.两个方法的使用
        >toString():显示当前的年、月、日、时、分、秒
        >getTime():获取当前Date对象对应的毫秒数。（时间戳）
 
    3. java.sql.Date对应着数据库中的日期类型的变量
        >如何实例化
        >如何将java.util.Date对象转换为java.sql.Date对象
     */
    @Test
    public void test2() {
        //构造器一：Date()：创建一个对应当前时间的Date对象
        Date date1 = new Date();
        System.out.println(date1.toString()); // Sat Feb 16 16:35:31 GMT+08:00 2019
 
        System.out.println(date1.getTime()); // 1550306204104
 
        //构造器二：创建指定毫秒数的Date对象
        Date date2 = new Date(155030620410L);
        System.out.println(date2.toString()); // Sat Nov 30 16:03:40 CST 1974
 
        //创建java.sql.Date对象
        java.sql.Date date3 = new java.sql.Date(35235325345L);
        System.out.println(date3); //1971-02-13
 
        //如何将java.util.Date对象转换为java.sql.Date对象
        //情况一：
        Date date4 = new java.sql.Date(2343243242323L);
        java.sql.Date date5 = (java.sql.Date) date4;
        //情况二：
        Date date6 = new Date();
        java.sql.Date date7 = new java.sql.Date(date6.getTime());  // 通过毫秒数转化
        
    }

SimpleDateFormat日期格式化类

java.text.DateFormat是日期/时间格式化子类的抽象类，我们通过这个类可以帮我们完成日期和文本之间的转换，也就是可以在Date对象与String对象之间进行来回转换。

Date类的API不易于国际化，大部分被废弃了，java.text.SimpleDateFormat类是一个不与语言环境有关的方式来格式化和解析日期的具体类。它允许进行格式化：日期→文本、解析：文本→日期

• 格式化：按照指定的格式，把Date对象转换为String对象
• 解析：按照指定的格式，把String对象转换为Date对象

构造方法

由于DateFormat为抽象类，不能直接使用，所以需要常用的子类java.text.SimpleDateFormat。这个类需要一个模式（格式）来指定格式化或解析的标准。构造方法为：

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

• SimpleDateFormat()：默认的模式和语言环境创建对象

参数pattern是一个字符串，代表日期时间的自定义格式。如：yyyy:年 MM：月 dd：日 HH：时 mm：分 ss：秒

格式规则

常用方法

• public String format(Date date)：将Date对象格式化为字符串。
• public Date parse(String source)：将字符串解析为Date对象。

🌰：

@Test
public void testSimpleDateFormat() throws ParseException {  // 抛出异常
    //实例化SimpleDateFormat:使用默认的构造器
    SimpleDateFormat sdf = new SimpleDateFormat();
 
    //格式化：日期 --->字符串
    Date date = new Date();
    System.out.println(date); // Mon Jul 18 21:32:50 CST 2022
 
    String format = sdf.format(date);
    System.out.println(format); // 22-7-18 下午9:32
 
    //解析：格式化的逆过程，字符串 ---> 日期
    String str = "19-12-18 上午11:43";
    Date date1 = sdf.parse(str);
    System.out.println(date1); // Wed Dec 18 11:43:00 CST 2019
 
    //*************按照指定的方式格式化和解析：调用带参的构造器*****************
    //        SimpleDateFormat sdf1 = new SimpleDateFormat("yyyyy.MMMMM.dd GGG hh:mm aaa");
    SimpleDateFormat sdf1 = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
    //格式化
    String format1 = sdf1.format(date);
    System.out.println(format1); // 2022-07-18 09:32:50
    //解析:要求字符串必须是符合SimpleDateFormat识别的格式(通过构造器参数体现),
    //否则，抛异常
    Date date2 = sdf1.parse("2022-07-18 09:32:50");
    System.out.println(date2); // Mon Jul 18 09:32:50 CST 2022
}

Calendar日历类

java.util.Calendar是一个抽象基类，主要用于完成日期字段之间相互操作的功能。不能直接创建对象，而是通过静态方法创建，返回子类对象。

Object -java.lang
	--Calendar -java.util
		--GregorianCalendar -java.util
			--BuddhistCalendar -sun.util

获取方式

获取Calendar实例的方法

• 使用Calendar.getInstance()方法

• 调用它的子类GregorianCalendar的构造器。

常用方法

一个Calendar的实例是系统时间的抽象表示，通过get(int field)方法来取得想要的时间信息。比如：YEAR、MONTH、DAY_OF_WEEK、HOUR_OF_DAY、MINUTE、SECOND

public int get(int field)：返回给定日历字段的值

public void set(int field, int value)：将给定的日历字段设置为给定值

public abstract void add(int field, int amount)：根据日历的规则，为给定的日历字段添加或减去指定的时间量。

field：时间字段信息，年：Calendar.YEAR。

amount：时间偏移量，正数：往未来偏移时间，负数：往过去偏移时间。

public final Date getTime()：返回一个表示此Calendar时间值（从历元到现在的毫秒偏移量）的Date对象。

public final void setTime(Date date)

小贴士📢：

西方星期的开始为周日，中国为周一。获取星期时：周日是1，周二是2，...周六是7

在Calendar类中，月份的表示是以0-11代表1-12月

日期是有大小关系的，时间靠后，时间越大。

Calendar类中提供很多成员常量，代表给定的日历字段：

🌰：

/**
* Calendar日历类(抽象类）的使用
*/
@Test
public void testCalendar() {
    //1.实例化
    //方式一：创建Calendar其子类（GregorianCalendar）的对象
    GregorianCalendar gregorianCalendar = new GregorianCalendar();
 
    //方式二：调用其静态方法getInstance()
    Calendar calendar = Calendar.getInstance();
    System.out.println(calendar.getClass()); // class java.util.GregorianCalendar
 
    //2.常用方法
    //get()
    int days = calendar.get(Calendar.DAY_OF_MONTH);
    System.out.println(days); // 18
    System.out.println(calendar.get(Calendar.DAY_OF_YEAR)); // 199
 
    //set()
    //calendar可变性
    calendar.set(Calendar.DAY_OF_MONTH, 22);
    days = calendar.get(Calendar.DAY_OF_MONTH);
    System.out.println(days); // 22
 
    //add()
    calendar.add(Calendar.DAY_OF_MONTH, -3);
    days = calendar.get(Calendar.DAY_OF_MONTH);
    System.out.println(days); // 19
 
    //getTime():日历类---> Date
    Date date = calendar.getTime();
    System.out.println(date); // Tue Jul 19 23:16:56 CST 2022
 
    //setTime():Date ---> 日历类
    Date date1 = new Date();
    calendar.setTime(date1);
    days = calendar.get(Calendar.DAY_OF_MONTH);
    System.out.println(days); // 18
 
}

JDK8日期时间API

LocaIDate、LocalTime、LocaIDateTime

LocaIDate、LocalTime、LocaIDateTime类是较重要的几个类，它们的实例是不可变的对象，分别表示使用ISO-8601日历系统的日期、时间、日期和时间。它们提供了简单的本地日期或时间，并不包含当前的时间信息，也不包含与时区相关的信息。

LocaIDate代表IOS格式(yyyy-MM-dd）的日期,可以存储生日、纪念日等日期。

LocalTime表示一个时间，而不是日期。

LocaIDateTime是用来表示日期和时间的，这是一个最常用的类之一

注：ISO-8601日历系统是国际标准化组织制定的现代公民的日期和时间的表示法，也就是公历。

举个🌰：

@SpringBootTest
public class JDK8DateTimeTest {
 
    @Test
    public void testDate() {
        //偏移量
        Date date1 = new Date(2020 - 1900, 9 - 1, 8);
        System.out.println(date1); // Tue Sep 08 00:00:00 CST 2020
    }
 
    /*
    LocalDate、LocalTime、LocalDateTime 的使用
    说明：
        1.LocalDateTime相较于LocalDate、LocalTime，使用频率要高
        2.类似于Calendar
     */
    @Test
    public void test1() {
        //now():获取当前的日期、时间、日期+时间
        LocalDate localDate = LocalDate.now();
        LocalTime localTime = LocalTime.now();
        LocalDateTime localDateTime = LocalDateTime.now();
 
        System.out.println(localDate); // 2022-07-21
        System.out.println(localTime); // 20:53:52.466
        System.out.println(localDateTime); // 2022-07-21T20:53:52.466
 
        //of():设置指定的年、月、日、时、分、秒。没有偏移量
        LocalDateTime localDateTime1 = LocalDateTime.of(2020, 10, 6, 13, 23, 43);
        System.out.println(localDateTime1); // 2020-10-06T13:23:43
 
 
        //getXxx()：获取相关的属性
        System.out.println(localDateTime.getDayOfMonth()); // 日：21
        System.out.println(localDateTime.getDayOfWeek()); // 周：THURSDAY
        System.out.println(localDateTime.getMonth()); // 月：JULY
        System.out.println(localDateTime.getMonthValue()); // 月：7
        System.out.println(localDateTime.getMinute()); // 分钟：53
 
        //体现不可变性
        //withXxx():设置相关的属性
        LocalDate localDate1 = localDate.withDayOfMonth(22);
        System.out.println(localDate); // 2022-07-21
        System.out.println(localDate1); // 2022-07-22
 
 
        LocalDateTime localDateTime2 = localDateTime.withHour(4);
        System.out.println(localDateTime); // 2022-07-21T20:53:52.466
        System.out.println(localDateTime2); // 2022-07-21T04:53:52.466
 
        //不可变性
        LocalDateTime localDateTime3 = localDateTime.plusMonths(3);
        System.out.println(localDateTime); // 2022-07-21T20:53:52.466
        System.out.println(localDateTime3); // 2022-10-21T20:53:52.466
 
        LocalDateTime localDateTime4 = localDateTime.minusDays(6);
        System.out.println(localDateTime); // 2022-07-21T20:53:52.466
        System.out.println(localDateTime4); // 2022-07-15T20:53:52.466
    }
}

Instant瞬时类

Instant：时间线上的一个瞬时点。这可能被用来记录应用程序中的事件时间戳。

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

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

(1 ns = 10^-9 s)  1秒 = 1000毫秒 = 10^6 微妙 = 10^9纳秒

举个🌰：

/*
  Instant的使用
  类似于 java.util.Date类
*/
@Test
public void test2() {
    //now():获取本初子午线对应的标准时间
    Instant instant = Instant.now();
    System.out.println(instant); // 2022-07-21T13:06:07.739Z
 
    //添加时间的偏移量 ZoneOffset.ofHours(8)设置时区
    OffsetDateTime offsetDateTime = instant.atOffset(ZoneOffset.ofHours(8));
    System.out.println(offsetDateTime); // 2022-07-21T21:06:07.739+08:00
 
    //toEpochMilli():获取自1970年1月1日0时0分0秒（UTC）开始的毫秒数  ---> Date类的getTime()
    long milli = instant.toEpochMilli();
    System.out.println(milli); // 1658408767739
 
    //ofEpochMilli():通过给定的毫秒数，获取Instant实例  -->Date(long millis)
    Instant instant1 = Instant.ofEpochMilli(1550475314878L);
    System.out.println(instant1); // 2019-02-18T07:35:14.878Z
}

DateTimeFormatter格式化与解析日期或时间

java.time.format.DateTimeFormatter类：该类提供了三种格式化方法。

• 预定义的标准格式。如：

  ISO_LOCAL_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIME

• 本地化相关的格式。如：

  ofLocalizedDateTime(FormatStyle.LONG)

• 自定义的格式。如：

  ofPattern("yyyy-MM-dd hh:mm:ss")

举个🌰：

/*
  DateTimeFormatter:格式化或解析日期、时间
  类似于SimpleDateFormat
*/
@Test
public void test3() {
    // 方式一：预定义的标准格式。如：ISO_LOCAL_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIME
    DateTimeFormatter formatter = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
    // 格式化:日期-->字符串
    LocalDateTime localDateTime = LocalDateTime.now();
    String str1 = formatter.format(localDateTime);
    System.out.println(localDateTime); // 2022-07-21T21:18:37.053
    System.out.println(str1); // 2022-07-21T21:18:37.053
 
    // 解析：字符串 -->日期
    TemporalAccessor parse = formatter.parse("2019-02-18T15:42:18.797");
    System.out.println(parse); // {},ISO resolved to 2019-02-18T15:42:18.797
 
    // 方式二：
    // 本地化相关的格式。如：ofLocalizedDateTime()
    // FormatStyle.LONG / FormatStyle.MEDIUM / FormatStyle.SHORT :适用于LocalDateTime
    DateTimeFormatter formatter1 = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.LONG);
    // 格式化
    String str2 = formatter1.format(localDateTime);
    System.out.println(str2); // 2022年7月21日 下午09时19分23秒
 
 
    // 本地化相关的格式。如：ofLocalizedDate()
    // FormatStyle.FULL / FormatStyle.LONG / FormatStyle.MEDIUM / FormatStyle.SHORT : 适用于LocalDate
    DateTimeFormatter formatter2 = DateTimeFormatter.ofLocalizedDate(FormatStyle.MEDIUM);
    // 格式化
    String str3 = formatter2.format(LocalDate.now());
    System.out.println(str3); // 2022-7-21
 
 
    // 重点： 方式三：自定义的格式。如：ofPattern(“yyyy-MM-dd hh:mm:ss”)
    DateTimeFormatter formatter3 = DateTimeFormatter.ofPattern("yyyy-MM-dd hh:mm:ss");
    // 格式化
    String str4 = formatter3.format(LocalDateTime.now());
    System.out.println(str4); // 2022-07-21 09:19:23
 
    // 解析
    TemporalAccessor accessor = formatter3.parse("2019-02-18 03:52:09");
    // {MinuteOfHour=52, SecondOfMinute=9, HourOfAmPm=3, MilliOfSecond=0, NanoOfSecond=0, MicroOfSecond=0},ISO resolved to 2019-02-18
    System.out.println(accessor);
 
}

其他API

与传统日期处理的转换