Java中JDK8新日期时间API

Java
Java
发布日期:   2021-01-08
更新日期:   2022-07-31
文章字数:   1.8k
阅读时长:   8 分
阅读次数:  

  

引言：

java的JDK8中新增了许多更加实用的时间API，之前的一些时间API逐渐被弃用。

  JDK 1.0中包含了一个java.util.Date类，但是它的大多数方法已经在JDK 1.1引入Calendar类之后被弃用了。而Calendar并不比Date好多少。它们面临的问题是：

  • 可变性：像日期和时间这样的类应该是不可变的。
  • 偏移性：Date中的年份是从1900开始的，而月份都从0开始。
public void testDate() {
    //偏移量，从1900年开始算，月份从0开始算
    Date date = new Date(2021, 1, 8);
    System.out.println(date);//Tue Feb 08 00:00:00 CST 3921
}
  • 格式化：SimpleDateFormat格式化只对Date有用，Calendar则不行。
  • 此外，它们也不是线程安全的；不能处理闰秒等。

  Java 8 吸收了 Joda-Time 的精华，以一个新的开始为 Java 创建优秀的API。新的 java.time 中包含了所有关于本地日期（LocalDate）、本地时间（LocalTime）、本地日期时间（LocalDateTime）、时区（ZonedDateTime）和持续时间（Duration）的类。历史悠久的 Date 类新增了 toInstant() 方法，用于把 Date 转换成新的表示形式。这些新增的本地化时间日期 API 大大简化了日期时间和本地化的管理。
新时间日期API

一、LocalDate、LocalTine、LocalDateTime

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

  • LocalDate代表IOS格式（yyyy-MM-dd）的日期,可以存储 生日、纪念日等日期。
  • LocalTime表示一个时间，而不是日期。
  • LocalDateTime是用来表示日期和时间的，这是一个最常用的类之一。

常用方法：(有点类似于Calendar)

  • now() / now(ZoneId zone) 静态方法，根据当前时间创建对象/指定时区的对象
  • of() 静态方法，根据指定日期/时间创建对象
  • getDayOfMonth()/getDayOfYear() 获得月份天数(1-31)/获得年份天数(1-366)
  • getDayOfWeek() 获得星期几(返回一个 DayOfWeek 枚举值)
  • getMonth() 获得月份, 返回一个 Month 枚举值
  • getMonthValue() / getYear() 获得月份(1-12) / 获得年份
  • getHour()/getMinute()/getSecond() 获得当前对象对应的小时、分钟、秒
  • withDayOfMonth()/withDayOfYear()/ withMonth()/withYear() 将月份天数、年份天数、月份、年份修改为指定的值并返回新的对象
  • plusDays(), plusWeeks(), plusMonths(), plusYears(),plusHours() 向当前对象添加几天、几周、几个月、几年、几小时
  • minusMonths() / minusWeeks()/ minusDays()/minusYears()/minusHours() 从当前对象减去几月、几周、几天、几年、几小时
public class JDK8DateTimeTest {
    @Test
    public void test1() {
        //now()：获取当前的日期、时间、日期+时间
        LocalDate localDate = LocalDate.now();
        LocalTime localTime = LocalTime.now();
        LocalDateTime localDateTime = LocalDateTime.now();

        System.out.println(localDate);//2021-01-08
        System.out.println(localTime);//20:31:45.430
        System.out.println(localDateTime);//2021-01-08T20:31:45.430

        //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());//8
        System.out.println(localDateTime.getDayOfWeek());//FRIDAY
        System.out.println(localDateTime.getMonth());//JANUARY
        System.out.println(localDateTime.getMonthValue());//1
        System.out.println(localDateTime.getMinute());//31

        //体现不可变性
        //withXxx()：设置相关的属性
        LocalDate localDate1 = localDate.withDayOfMonth(22);
        System.out.println(localDate);//2021-01-08
        System.out.println(localDate1);//2021-01-22


        LocalDateTime localDateTime2 = localDateTime.withHour(4);
        System.out.println(localDateTime);//2021-01-08T20:31:45.430
        System.out.println(localDateTime2);//2021-01-08T04:31:45.430

        //不可变性
        //plusXXX()：加
        LocalDateTime localDateTime3 = localDateTime.plusMonths(3);
        System.out.println(localDateTime);//2021-01-08T20:31:45.430
        System.out.println(localDateTime3);//2021-04-08T20:31:45.430

        //不可变性
        //minusXXX()：减
        LocalDateTime localDateTime4 = localDateTime.minusDays(6);
        System.out.println(localDateTime);//2021-01-08T20:31:45.430
        System.out.println(localDateTime4);//2021-01-02T20:31:45.430
    }
}

二、瞬时 Instant

  Instant 表示时间线上的一个瞬时点。 这可能被用来记录应用程序中的事件时间戳。Instant表示时间线上的一点，而不需要任何上下文信息，例如，时区。概念上讲，它只是简单的表示自1970年1月1日0时0分0秒（UTC）开始的秒数。因为java.time包是基于纳秒计算的，所以Instant的精度可以达到纳秒级。

常用方法：(有点类似于Date)

  • now() 静态方法，返回默认UTC时区的Instant类的对象
  • ofEpochMilli(long epochMilli) 静态方法，返回在1970-01-01 00:00:00基础上加上指定毫秒数之后的Instant类的对象
  • atOffset(ZoneOffset offset) 结合即时的偏移来创建一个 OffsetDateTime
  • toEpochMilli() 返回1970-01-01 00:00:00到当前时间的毫秒数，即为时间戳
public class JDK8DateTimeTest {

    @Test
    public void test2() {
        //now():获取本初子午线对应的标准时间
        Instant instant = Instant.now();
        System.out.println(instant);//2019-02-18T07:29:41.719Z

        //添加时间的偏移量
        OffsetDateTime offsetDateTime = instant.atOffset(ZoneOffset.ofHours(8));
        System.out.println(offsetDateTime);//2019-02-18T15:32:50.611+08:00

        //toEpochMilli():获取自1970年1月1日0时0分0秒（UTC）开始的毫秒数  ---> Date类的getTime()
        long milli = instant.toEpochMilli();
        System.out.println(milli);

        //ofEpochMilli():通过给定的毫秒数，获取Instant实例  -->Date(long millis)
        Instant instant1 = Instant.ofEpochMilli(1550475314878L);
        System.out.println(instant1);
    }
}

三、格式化与解析日期或时间

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

  • 预定义的标准格式。如：ISO_LOCAL_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIME
  • 本地化相关的格式。如：ofLocalizedDateTime(FormatStyle.LONG)
  • 自定义的格式。如：ofPattern(“yyyy-MM-dd hh:mm:ss”)

常用方法：(类似于SimpleDateFormat)

  • ofPattern(String pattern) 静态方法，返回一个指定字符串格式的DateTimeFormatter
  • format(TemporalAccessor t) 格式化一个日期、时间，返回字符串
  • parse(CharSequence text) 将指定格式的字符序列解析为一个日期、时间
public class JDK8DateTimeTest {
    @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(str1);//2019-02-18T15:42:18.797

        //解析：字符串 -->日期
        TemporalAccessor parse = formatter.parse("2019-02-18T15:42:18.797");
        System.out.println(parse);

        //方式二：
        //本地化相关的格式。如：ofLocalizedDateTime()
        //FormatStyle.LONG / FormatStyle.MEDIUM / FormatStyle.SHORT :适用于LocalDateTime
        DateTimeFormatter formatter1 = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.LONG);
        //格式化
        String str2 = formatter1.format(localDateTime);
        System.out.println(str2);//2019年2月18日 下午03时47分16秒


        //本地化相关的格式。如：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);//2019-2-18


        //重点： 方式三：自定义的格式。如：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);//2019-02-18 03:52:09

        //解析
        TemporalAccessor accessor = formatter3.parse("2019-02-18 03:52:09");
        System.out.println(accessor);
    }
}

四、其他日期时间API

  • ZoneId：该类中包含了所有的时区信息，一个时区的ID，如 Europe/Paris
  • ZonedDateTime：一个在ISO-8601日历系统时区的日期时间，如 2007-12-03T10:15:30+01:00 Europe/Paris。其中每个时区都对应着ID，地区ID都为“{区域}/{城市}”的格式，例如：Asia/Shanghai等
  • Clock：使用时区提供对当前即时、日期和时间的访问的时钟。
  • 持续时间：Duration，用于计算两个“时间”间隔
  • 日期间隔：Period，用于计算两个“日期”间隔
  • TemporalAdjuster : 时间校正器。有时我们可能需要获取例如：将日期调整到“下一个工作日”等操作。
  • TemporalAdjusters : 该类通过静态方法(firstDayOfXxx()/lastDayOfXxx()/nextXxx())提供了大量的常用TemporalAdjuster 的实现。
文章作者: YangChongZhi
文章链接: http://yczlab.top/posts/6117c966.html
版权声明: 本博客所有文章除特別声明外，均采用 CC BY 4.0 许可协议。转载请注明来源 YangChongZhi !
Java
赏
评论
 上一篇
Java中的String类常见算法题 Java中的String类常见算法题
   引言： java中关于String类的常见笔试算法题 将一个字符串进行反转。将字符串中指定部分进行反转。比如“abcdefg”反转为”abfedcg” public class StringDemo { //方
2021-01-08 Java
Java
下一篇 
Java中JDK8之前关于时间的API Java中JDK8之前关于时间的API
   引言： java在JDK8之前就提供了一些较为常用的关于时间的API。 一、java.lang.System 类  System类提供的 public static long currentTimeMillis() 用来返回当前时间
2021-01-08 Java
Java
  目录