JDK 中日期 API 的使用

与墨学长
46 阅读6分钟

开启掘金成长之旅！这是我参与「掘金日新计划 · 2 月更文挑战」的第 4 天，点击查看活动详情

JDK8 之前日期 API

java.lang.System 类

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

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.text.SimpleDateFormat 类

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

  • 它允许进行格式化：日期 → 文本、解析：文本 → 日期

  • 格式化：

    • SimpleDateFormat()：默认的模式和语言环境创建对象。
    • public SimpleDateFormat(String pattern)：该构造方法可以用参数 pattern 指定的格式创建一个对象，该对象调用。
    • public String format(Date date)：方法格式化时间对象 date 。

  • 解析：

    • public Date parse(String source)：从给定字符串的开始解析文本，以生成一个日期。
     package DateTimeTest;
 ​
 import org.junit.Test;
 ​
 import java.text.ParseException;
 import java.text.SimpleDateFormat;
 import java.util.Date;
 ​
 public class DateTimeTest {
     @Test
     public void testSimpleDateFormat() throws ParseException {
         // 实例化 SimpleDateFormat
         SimpleDateFormat sdf = new SimpleDateFormat();
         // 格式化：日期 → 字符串
         Date date = new Date();
         String foemat = sdf.format(date);
         System.out.println(foemat);
         // 解析：字符串 → 日期
         String str = "2019-08-09";
         Date date1 = sdf.parse(str);
         System.out.println(date1);
     }
 }
 ​

java.util.Calendar (日历)类

  • Calendar 是一个抽象基类，主要用于完成日期字段之间相互操作的功能。

  • 获取 Calendar 实例的方法

    • 使用 Calendar.getInstance() 方法
    • 调用它的子类 GregorianCalendar 的构造器

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

    • public void set(int field, int value)
    • public void add(int field, int amount)
    • public final Date getTime()
    • public final void setTime(Date date)
     public void testCalendar() {
     // 实例化
     // 方式一：创建其子类（GregorianCalendar）的对象
     // 方式二：调用其静态方法 getInstance()
     Calendar calendar = Calendar.getInstance();
 ​
     // 常用方法
     // get()
     int days = calendar.get(Calendar.DAY_OF_MONTH);
     System.out.println(days);
     // set()
     calendar.set(Calendar.DAY_OF_MONTH, 22);
     days = calendar.get(Calendar.DAY_OF_MONTH);
     System.out.println(days);
     // add()
     calendar.add(Calendar.DAY_OF_MONTH, 3);
     days = calendar.get(Calendar.DAY_OF_MONTH);
     System.out.println(days);
     // getTime()
     Date date = calendar.getTime();
     System.out.println(date);
     // setTime()
     Date date1 = new Date();
     calendar.setTime(date1);
     days = calendar.get(Calendar.DAY_OF_MONTH);
     System.out.println(days);
 }
 ​

  • 注意：

    • 获取月份时：一月是0，二月是1，以此类推，12月是11
    • 获取星期时：周日是1，周二是2，。。。。。周六是7

JDK8 中新日期 API

  • 第三次引入的 API 是成功的，并且 Java 8 中引入的 java.time API 已经纠正了过去的缺陷，将来很长一段时间内它都会为我们服务。
  • Java 8 吸收了 Joda-Time 的精华，以一个新的开始为 Java 创建优秀的 API 。新的 java.time 中包含了所有关于本地日期（LocalDate）、本地时间（LocalTime）、本地日期时间（LocalDateTime）、时区（ZonedDateTime）和持续时间（Duration）的类。历史悠久的 Date 类新增了 toInstant() 方法，用于把 Date 转换成新的表示形式。这些新增的本地化时间日期 API 大大简化了日期和本地化的管理。

java.time — 包含值对象的基础包

java.time.chrono — 提供对不同日期的日历系统的访问

java.time.format — 格式化和解析时间和日期

java.time.temporal — 包括底层框架和扩展特性

java.time.zone — 包含时区支持的类

LocalDate、LocalTime、LocalDateTime

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

    • LocalDate 代表 IOS 格式（yyyy-MM-dd）的日期，可以存储生日、纪念日等日期。
    • LocalTime 表示一个时间，而不是日期。
    • LocalDateTime 是用来表示日期和时间的，这是一个最常用的类之一。
     package Local;
 ​
 import org.junit.Test;
 ​
 import java.time.LocalDate;
 import java.time.LocalDateTime;
 import java.time.LocalTime;
 ​
 public class localTest {
     @Test
     public void test1() {
         // now()：获取当前的日期、时间、日期+时间
         LocalDate localDate = LocalDate.now();
         LocalTime localTime = LocalTime.now();
         LocalDateTime localDateTime = LocalDateTime.now();
         System.out.println(localDate);
         System.out.println(localTime);
         System.out.println(localDateTime);
         // of()：设置指定的年月日时分秒，没有偏移量
         LocalDateTime localDateTime1 = LocalDateTime.of(2020, 6, 3, 20, 23, 45);
         System.out.println(localDateTime1);
         // getXxx：获取相关属性
         System.out.println(localDateTime.getDayOfMonth());
         System.out.println(localDateTime.getDayOfWeek());
         System.out.println(localDateTime.getMonth());
         System.out.println(localDateTime.getMonthValue());
         System.out.println(localDateTime.getMinute());
         // 体现不可变性：withXxx：设置相关属性
         LocalDate localDate1 = localDate.withDayOfMonth(22);
         System.out.println(localDate);
         System.out.println(localDate1);
 ​
         LocalDateTime localDateTime3 = localDateTime.plusMonths(3);
         System.out.println(localDateTime);
         System.out.println(localDateTime3);
         
         LocalDateTime localDateTime4 = localDateTime.minusMonths(3);
         System.out.println(localDateTime);
         System.out.println(localDateTime4);
     }
 }
 ​

瞬时：Instant

  • Instant：时间线上的一个瞬时点。这可能被用来记录应用程序中的事件时间戳。
  • 在处理时间和日期的时候，我们通常会想到年月日时分秒。然而，这只是时间的一个模型，是面向人类的。第二种通用模型是面向机器的，或者说是连续的。在此模型中，时间线中的一个点表示为一个很大的数，这有利于计算机处理。在 UNIX 中，这个数从 1970 年开始，以秒为单位；同样的，在 Java 中，也是从 1970 年开始，但以毫秒为单位。
  • java.time 包通过值类型 Instant 提供机器视图，不提供处理人类意义上的时间单位。 Instant 表示时间线上的一点，而不需要任何上下文信息，例如，时区。概念上讲，它只是简单的表示自 1970 年 1 月 1 日 0 时 0 分 0 秒（UTC）开始的秒数。因为 java.time 包是基于纳秒计算的，所以 Instant 的精度可以达到纳秒级。
  • 秒毫秒微秒纳秒
方法描述
now()静态方法，返回默认 UTC 时区的 Instant 类的对象
ofEpochMilli(long epochMilli)静态方法，返回在 1970-01-01 00:00:00 基础上加上指定毫秒数之后的 Instant 类的对象
atOffset(ZoneOffset offset)结合即时的便宜来创建一个 OffsetDateTime
toEpochMilli()返回 1970-01-01 00:00:00 到当前时间的毫秒数，即为时间戳
 package InstantTest;
 ​
 import org.junit.Test;
 ​
 import java.time.Instant;
 ​
 public class InstantTest {
     @Test
     public void test(){
         Instant instant = Instant.now();
         System.out.println(instant);  // 2023-01-30T05:41:54.591Z此处输出的是本初子午线时区的时间
     }
 }
 ​

格式化与解析日期或时间

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

    • 预定义的标准格式。如：ISO_LOCAL_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIME
    • 本地化相关的格式，如：ofLocalizedDateTime(FormatStyle.LONG)
    • 自定义的格式。如：ofPattern("yyyy-MM-dd hh:mm:ss E")
    方法描述
    ofPattern(String pattern)静态方法，返回一个指定字符串格式的 DateTimeFormatter
    format(TemporalAccessor t)格式化一个日期、时间，返回字符串
    parse(CharSequence text)将指定格式的字符序列解析为一个日期、时间

其他 API

  • Zoned：该类中包含了所有的时区信息，一个时区的 ID，如 Europe/Paris

  • ZonedDateTime：一个在 ISO-8601 日历系统时区的日期时间，如 2007-12-03T10：15：30+01：00 Europe/Paris 。

    • 其中每个时区都对应着 ID，地区 ID 都为“{区域}/{城市}”的格式，例如：AAsia/Shanghai 等。

  • Clock：使用失去提供对当前即时、日期和时间的访问的时钟。

  • 持续时间：Duration，用于计算两个“时间”间隔。

  • 日期间隔：Period，用于计算两个日期间隔。

  • TemporalAdjuster：时间校正器。例如：将日期调整到“下一个工作日”等操作。

  • TemporalAdjusters：该类通过静态方法（firstDayOfXxx()/lastDayOfXxx()/nextXxx()）提供了大量的常用 TemporalAdjuster 的实现。

参考：与传统日期处理的转换

类To 遗留类From 遗留类
java.time.Instant 与 java.util.DateDate.form(instant)date.toInstant()
java.time.Instant 与 java.sql.TimestampTimestamp.form(instant)timestamp.toInstant()
java.time.ZonedDateTime 与 java.util.GregorianCalendarGregorianCalendar.form(zonedDateTime)cal.toZoneDateTime()
java.time.LocalDate 与 java.sql.TimeDate.valueOf(localDate)date.toLocalDate()
java.time.LocalTime 与 java.sql.TimeDate.valueOf(localDate)date.toLocalTime()
java.time.LocalDateTime 与 java.sql.TimestampTimestamp.valueOf(localDateTime)timestamp.toLocalDateTime()
java.time.Zoneld 与 java.util.TimeZoneTiemzone.getTimeZone(id)timeZone.toZoneld()
java.time.format.DateTimeFormatter 与 java.text.DateFormatformatter.toFormat()无
avatar
文章
阅读
粉丝