JDK8中新日期时间API

2023-12-12 15:50:16

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

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

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

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

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

说明：大多数开发者智慧用到基础包和format包，也可能会用到temporal包。因此，尽管有68个新的公开类型，大多数开发者，大概智慧用到其中的三分之一。

LocalDate、LocalTime、LocalDateTime

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

LocalDate：代表IOS格式（yyyy-MM-dd）的日期，可以存储生日、纪念日等日期。

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

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

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

方法 描述
now()/* now(Zoneld zone) 静态方法，根据当前时间创建对象/指定时区的对象
of() 静态方法，根据指定日期/时间创建对象
getDayOfMonth() / getDayOfYear() 获得月份天数（1-31）/获得年份天数（1-366）
getDayOfWeek() 获得星期几（返回一个DayOfWeek枚举值）
getMonth() 获得月份，返回一个Month枚举值
getMonthValue() / getYear() 获得月份（1-12）/获得年份
getHour() / getMinute / getSecond() 获得当前对象对应的小时、分钟、秒
withDayOfMonth() / withDayOfYear() / withMonth() / witjYear() 将月份天数、年份天数、月份、年份修改为指定的值并返回新的对象
plusDays(), plusWeeks(), plusMonths(), plusYears(), plusHours() 向当前对象添加几天、几周、几个月、几年、几小时
minusMonths(), minusWeeks(), minusDays(), minusYear(),minusHours 从当前对象减去几月、几周、几天、几年、几小时 
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.util.Date;

import static java.time.LocalDateTime.*;

/*
jdk 8中日期时间API的测试
 */
public class JDK8DateTimeTest {
    public void testDate(){
        //偏移量
        Date date1=new Date(2020-1900,9-1,8);
        System.out.println(date1);//Tue Sep 08 00:00:00 GMT+08:00 2020
    }

    /*
    LocalDate、LocalTime、LocalDateTime的使用
    说明：
        1.LocalDateTime相较于LocalDate、LocalTime
        2.类似于Calendar
     */
    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(2021,9,8,10,33,22);
        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());

        //体现不可变性
        localDate localDate1=localDate.withDayOfMonth(22);
        System.out.println(localDate);
        System.out.println(localDate1);

        LocalDateTime localDateTime2=localDateTime.withHour(4);
        System.out.println(localDateTime);
        System.out.println(localDateTime2);

        //不可变性 加月
        localDateTime localDateTime3=localDateTime.plusMonths(3);
        System.out.println(localDateTime);
        System.out.println(localDateTime3);

        //减天
        localDateTime localDateTime4=localDateTime.minusDays(6);
        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的精度可以达到纳秒级。

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

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

    时间戳是指格林威治时间1970年01月01日00时00分00秒（北京时间1970年01月01日08时00分00秒）起至现在的总秒数。

 /*
    Instant的使用
    类似于java.util.Date类
     */
    public void test2(){
        //now()：获取本初子午线对应的标准时间
        Instant instant=Instant.now();
        System.out.println(instant);

        //添加时间的偏移量
        OffsetDateTime offsetDateTime=instant.atOffset(ZoneOffset.ofHours(8));
        System.out.println(offsetDateTime);

        //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类：

该类提供了三种格式化方法：

1）预定义的标准格式，如：ISO_LOCAK_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIMR

2）本地化相关的格式。如：ofLocalized(FormatStyle.LONG)

3）自定义的格式。如：ofPattern("yyyy-MM-dd hh:mm:ss E")

方法 描述
ofPattern(String pattern) 静态方法，返回一个指定字符串格式的DateTimeFormatter
format(TemporalAccessoor t) 格式化一个日期、时间，返回字符串
parse(CharSequence text) 将指定格式的字符序列解析为一个日期、时间 
/*
    DateTimeFormatter:格式化或解析日期、时间
    类似于SimpleDateFormat
     */
    public void test3(){
        //方式一:预定义的标准格式，如：ISO_LOCAK_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIMR
        DateTimeFormatter formatter=DateTimeFormatter.ISO_LOCAL_DATE_TIME;
        //格式化:日期——>字符串
        LocalDateTime localDateTime=LocalDateTime.now();
        String str1=formatter.format(localDateTime);
        System.out.println(localDateTime);
        System.out.println(str1);

        //解析：字符串——>日期
        TemporalAccessor parse=formatter.parse("2021-09-08T16:05:18.787");
        System.out.println(parse);

        //方式二:本地化相关的格式。如：ofLocalized(FormatStyle.LONG)
        DateTimeFormatter formatter1=DateTimeFormatter.ofLocalizedDateTime(FormatStyle.SHORT);
        //格式化
        String str2=formatter1.format(localDateTime);
        System.out.println(str2);

        DateTimeFormatter formatter2=DateTimeFormatter.ofLocalizedDate(FormatStyle.FULL);
        //格式化
        String str3=formatter2.format(LocalDate.now());
        System.out.println(str3);//2021-9-8

        //重点：方式三：自定义的格式。如：ofPattern("yyyy-MM-dd hh:mm:ss E")
        DateTimeFormatter formatter3=DateTimeFormatter.ofPattern("yyyy-MM-dd hh:mm:ss");
        //格式化
        String str4=formatter1.format(localDateTime.now());
        System.out.println(str4);//2021-09-08 04:34:16
        //解析
        TemporalAccessor accessor=formatter3.parse("2021-09-08 04:34:16");
        System.out.println(accessor);

    }

其他API：

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

ZonedDateTime：一个在ISO-8601日历系统时区的日期时间，如2021-09-03T10:15:30+01:00 Europe/Paris。（每个时区都对应着ID，地区ID都为“{区域}/{城市}”的格式，例如：Asia/Shanghai等）

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

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

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

TemporalAdjuster：时间校正器。有时我们可能要获取例如：将日期调整到“下一个工作日”等操作。

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

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

类 To遗留类 From遗留类
java.time.Instant与java.util.Data Date.from(instant) date.toInstant()
java.time.Instant与java.sql.Timestamp Timestamp.from(instant) timestamp.toInstant()
java.time.ZonedDateTime与java.util.GregorianCalendar GregorianCalendar.from(zonedDate Time) cal.toZonedDateTime()
java.time.LocalDate与java.sql.Time Date.valueOf(localDate) date.toLocalDate()
java.time.LocalTime与java.sql.Time Date.valueOf(localDate) date.toLocalDate()
java.time.LocalDateTime与java.sql.Timestamp Timestamp.valueOf(localDateTime) timestamp.toLocalDateTime()
java.time.Zoneld与java.util.TimeZone Timezone.getTimeZone(id) timeZone.toZoneld()
java.time.format.DateTimeFormatter与java.text.DateFormat formatter.toFormat() 无

上一篇：Linux安装jdk8


下一篇：java-jdk8下载及安装