jsr310：Java日期和时间API

一、jsr310规范

Java SE 8中引入了一个新的日期和时间API——jsr310，其设计旨在提高用于日期和时间操作的类的易用性和可读性。jsr310日期和时间API提供了新的类来表示具体的地区日期时间（例如LocalDate、LocalTime、LocalDateTime、ZonedDateTime、OffsetDateTime、OffsetTime和Duration）以及日期时间对象之间的操作方法。在此之前的Java日期和时间API使用起来非常不直观，也不便于扩展和修改。而jsr310规范则根据ISO标准定义了一个更加通用和易于理解的日期和时间API。

在jsr310规范中，一些公共模式被抽象为“Temporal”接口的一些方法，比如LocalDate和ZonedDateTime都实现了Temporal接口。它们使用这些公共方法来提供通用的实现，并通过自身的方法对特定类型的日期时间进行了实现。比如，LocalDate实现了Temproral接口的方法 plus(long,int)、minus(long,int)等。

此外，jsr310还针对一些常见日期和时区的问题提供了解决方案，如时区偏移量、闰秒、累加秒和毫秒到时间和日期对象等，这些都让jsr310成为Java丰富的日期和时间API中的一个重要部分。

二、jsr310 enable handling

在jsr310规范中提供的日期和时间API支持无缝地处理时区、闰秒和夏令时等问题。它通过ZoneId和ZoneOffset两个对象来表示时区信息，并且提供了一些方法来处理这些对象，例如withZoneSameInstant()和withZoneSameLocal()方法等。

在处理时区的同时，jsr310还提供了对闰秒的支持，它通过Duration.appendSeconds(long)和Instant.plusSeconds(long)等方法来处理秒的累加问题。此外，jsr310还允许与时区相关的偏移量与日期时间组合来创建OffsetDateTime和OffsetTime对象来表示与UTC偏移数。

除此之外，jsr310还提供了用于添加和解析符合ISO格式协调世界时的Date-Time字符串以及Java时间和日期API之间的转换的标准方法。这些转换可以通过java.time.format.DateTimeFormatter和java.time.Period类型来实现。

三、jsr310:date api

以下是几个jsr310中比较重要的日期时间类的介绍。

1. LocalDate类

该类表示一个ISO-8601格式的日期，如“2018-12-18”。它是一种本地日期，不包含时区或偏移量信息。该类提供了一些方法来处理日期和时间。

public final class LocalDate implements Temporal, TemporalAdjuster, ChronoLocalDate, Serializable {
     //获取年份
     public int getYear()
     //获取月份
     public int getMonthValue()
     //获取日
     public int getDayOfMonth() 
     //增加或减少一个天数
     public LocalDate plusDays(long daysToAdd)
}

2. LocalTime类

该类表示一个ISO-8601格式的时间，如“23:01:30.001”。它是一种本地时间，不包含时区或偏移量信息。该类提供了一些方法来处理时间和日期。

public final class LocalTime implements Temporal, TemporalAdjuster, Serializable, Comparable
    {
    //获取时钟
    public int getHour()
    //获取分钟
    public int getMinute()
    //获取秒
    public int getSecond()
    //获取毫秒
    public int getNano()
    //增加或减少分钟
    public LocalTime plusMinutes(long minutesToAdd)
}
   

3. LocalDateTime类

该类代表一个日期和时间，如“2018-12-18T23:01:30.001”。它是一种不带时区的ISO-8601格式的日期时间类型。

public final class LocalDateTime implements Temporal, TemporalAdjuster, Serializable, Comparable
   , ChronoLocalDateTime
     {
    //获取日期
    public LocalDate toLocalDate() 
    //获取时间
    public LocalTime toLocalTime() 
    //获取给定年的DateTime
    public static LocalDateTime of(int year, Month month, int dayOfMonth, int hour, int minute, int second) 
}
    
   

4. ZonedDateTime类

该类代表一个带时区偏移量的日期和时间，如“2018-12-18T23:01:30.001+08:00[Asia/Shanghai]”。它是一种ISO-8601格式的日期时间，带有时区偏移量和时区信息。

public final class ZonedDateTime implements Temporal, ChronoZonedDateTime
    {
    //获取所述时区的时钟规则
    public ZoneRules getZoneRules()
    //返回指定时区的时间日期
    public ZonedDateTime withZoneSameInstant(ZoneId zone)
}
   

5. Duration类

该类代表一段时间长度，可以用于处理各种时间单位，如日、秒、毫秒等。Duration类和Period类对日期和时间进行了不同的处理。

public class Duration implements TemporalAmount, Serializable, Comparable
    {
    //获取天数
    public long toDays()
    //获取小时数
    public long toHours()
    //获取秒数
    public long getSeconds()
    //增加duration
    public Duration plus​(Duration duration)
}
   

以上是jsr310一些重要的日期时间类的介绍和常用方法的解释。其中，jsr310日期时间API具有很好的可读性和易用性，可大大简化代码逻辑和开发人员的工作。