Java 8 -- Date-Time Package

梦里梦外; 2022-06-02 11:14 164阅读 0赞

## 使用 LocalDate、LocalTime、LocalDateTime ##

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

<table> 
 <thead> 
  <tr> 
   <th>方法</th> 
   <th>描述</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>now()</code></td> 
   <td>静态方法，根据当前时间创建对象</td> 
   <td><code>LocalDate localDate = LocalDate.now()</code><br><code>LocalTime localTime = LocalTime.now()</code><br><code>LocalDateTime localDateTime = LocalDateTime.now()</code></td> 
  </tr> 
  <tr> 
   <td><code>of()</code></td> 
   <td>静态方法，根据指定日期/时间创建对象</td> 
   <td><code>LocalDate localDate = LocalDate.of(2018, 1, 11)</code><br><code>LocalTime localTime = LocalTime.of(02, 22, 56)</code><br><code>LocalDateTime localDateTime = LocalDateTime.of(2018, 1, 11, 12, 10, 55)</code></td> 
  </tr> 
  <tr> 
   <td>plusDays, plusWeeks, plusMonths, plusYears</td> 
   <td>向当前 LocalDate 对象添加几天、几周、几个月、几年</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>minusDays, minusWeeks, minusMonths, minusYears</td> 
   <td>从当前 LocalDate 对象减去几天、几周、几个月、几年</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>plus, minus</td> 
   <td>添加或减少一个 Duration 或 Period</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>WithDayOfMonth, WithDayOfYear, WithMonth, WithYear</td> 
   <td>将月份天数、年份天数、月份、年份修改为指定的值并返回新的 LocalDate</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>getDayOfMonth</td> 
   <td>获得月份天数（1-31）</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>getDayOfYear</td> 
   <td>获得年份天数（1-366）</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>getDayOfWeek</td> 
   <td>获得星期几（返回一个 DayOfWeek 枚举值）</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>getMonth</td> 
   <td>获得月份，返回一个 Month 枚举值</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>getMonthValue</td> 
   <td>获得月份（1-12）</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>getYear</td> 
   <td>获得年份</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>until</td> 
   <td>获得两个日期之间的 Period 对象，或指定 ChonoUnits 的数字</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>isBefore, isAfter</td> 
   <td>比较两个LocalDate</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>isLeapYear</td> 
   <td>判断是否是闰年</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

## Instant 时间戳 ##

用于“时间戳”运算。它是一 Unix 元年（传统的设定为 UTC 时区 1970 年 1 月 1 日午夜时分）开始所经历的秒数进行运算。

## Duration 和 Period ##

*  Duration：用于计算两个“时间”间隔
 *  Period：用于计算两个“日期”间隔

## 日期的操纵 ##

*  TemporalAdjuster：时间校正器。有时我们可能需要获取栗如：将日期调整到“下个周日”等操作。
 *  TemporalAdjusters：该类通过静态方法提供了大量的常用 TemporalAdjuster 的实现。  
    栗如获取下个周日：

LocalDate nextSunday = LocalDate.now().with(TemporalAdjusters.next(DayOfWeek.SUNDAY));

## 解析与格式化 ##

`java.time.format.DateTimeFomatter`类：该类提供了三种格式化方法：  
\- 预定义的标准格式  
\- 语言环境相关的格式  
\- 自定义的格式

## 时区的处理 ##

Java 8 中加入了对时区的支持，带时区的时间分别为：  
`ZonedDate` `ZonedTime` `ZonedDateTime`  
其中每个时区都对应着 ID，地区 ID 都为“\{区域\}/\{城市\}”的格式  
栗如：Asia/Shanghai 等  
`ZoneId`：该类中包含了所有的时区信息  
`getAvailableZoneIds()`：可获取所有时区时区信息  
`of(id)`：用指定的时区信息获取 ZoneId 对象

## 与传统日期的转换 ##

<table> 
 <thead> 
  <tr> 
   <th>类</th> 
   <th>To遗留类</th> 
   <th>From遗留类</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>java.time.Instant</code><br><code>java.util.Date</code></td> 
   <td><code>Date.from(instant)</code></td> 
   <td><code>date.toInstant()</code></td> 
  </tr> 
  <tr> 
   <td><code>java.time.Instant</code><br><code>java.sql.Timestamp</code></td> 
   <td><code>timestamp.from(instant)</code></td> 
   <td><code>Timestamp.toInstant()</code></td> 
  </tr> 
  <tr> 
   <td><code>java.time.ZonedDateTime</code><br><code>java.util.GregorianCalndar</code></td> 
   <td><code>GregorianCalendar.from(zonedDateTime)</code></td> 
   <td><code>cal.toZonedDateTime()</code></td> 
  </tr> 
  <tr> 
   <td><code>java.time.LocalDate</code><br><code>java.sql.Time</code></td> 
   <td><code>Date.valueOf(localDate)</code></td> 
   <td><code>date.toLocalDate()</code></td> 
  </tr> 
  <tr> 
   <td><code>java.time.LocalTime</code><br><code>java.sql.Time</code></td> 
   <td><code>Date.valueOf(localTime)</code></td> 
   <td><code>date.toLocalTime()</code></td> 
  </tr> 
  <tr> 
   <td><code>java.time.LocalDate</code><br><code>java.sql.Timestamp</code></td> 
   <td><code>Timestamp.valueOf(localDateTime)</code></td> 
   <td><code>timestamp.toLocalDateTme()</code></td> 
  </tr> 
  <tr> 
   <td><code>java.time.ZoneId</code><br><code>java.util.TimeZone</code></td> 
   <td><code>Timezone.getTimeZone(id)</code></td> 
   <td><code>timeZone.toZoneId()</code></td> 
  </tr> 
  <tr> 
   <td><code>java.time.format.DateTimeFormatter</code><br><code>java.text.DateFormat</code></td> 
   <td><code>formatter.toFormat()</code></td> 
   <td>无</td> 
  </tr> 
 </tbody> 
</table>