Java8 -- 处理时间

痛定思痛。 2023-03-01 12:25 183阅读 0赞

# 本地时间API #

Java 8 为处理本地的日期时间提供了三个类`LocalDate 、LocalTime 和 LocalDateTime`。分别用于处理 本地日期、本地时间 和 本地日期时间。  
当使用这三个类时，开发者并不需要关心时区是什么。因为它默认使用的是操作系统的时区。

<table> 
 <thead> 
  <tr> 
   <th>API</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>now() / * now(ZoneId zone)</td> 
   <td>静态方法，根据当前时间创建对象/指定时区的对象</td> 
  </tr> 
  <tr> 
   <td>of()</td> 
   <td>静态方法，根据指定日期/时间创建对象</td> 
  </tr> 
  <tr> 
   <td>getDayOfMonth()/getDayOfYear()</td> 
   <td>获得月份天数(1-31) /获得年份天数(1-366)</td> 
  </tr> 
  <tr> 
   <td>getDayOfWeek()</td> 
   <td>获得星期几(返回一个 DayOfWeek 枚举值)</td> 
  </tr> 
  <tr> 
   <td>getMonth()</td> 
   <td>获得月份, 返回一个 Month 枚举值</td> 
  </tr> 
  <tr> 
   <td>getMonthValue() / getYear()</td> 
   <td>获得月份(1-12) /获得年份</td> 
  </tr> 
  <tr> 
   <td>getHour()/getMinute()/getSecond()</td> 
   <td>获得当前对象对应的小时、分钟、秒</td> 
  </tr> 
  <tr> 
   <td>withDayOfMonth()/withDayOfYear()/</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>withMonth()/withYear()</td> 
   <td>将月份天数、年份天数、月份、年份修改为指定的值并返回新的对象</td> 
  </tr> 
  <tr> 
   <td>plusDays(), plusWeeks(), plusMonths(), plusYears(),plusHours()</td> 
   <td>向当前对象添加几天、几周、几个月、几年、几小时</td> 
  </tr> 
  <tr> 
   <td>minusMonths() / minusWeeks()/minusDays()/minusYears()/minusHours()</td> 
   <td>从当前对象减去几月、几周、几天、几年、几小时</td> 
  </tr> 
 </tbody> 
</table>

## LocalDate-日期 ##

*  创建LocalDate对象

@Test
        public void test_start() throws ParseException {
        
            //  获取当前日期
            LocalDate now = LocalDate.now();
            System.out.println("当前日期：" +now);
    
            LocalDate noeDay = LocalDate.of(2020, 6, 1);
            System.out.println("指定日期：" + noeDay);
    
            LocalDate nday = LocalDate.parse("2020-07-01");
            System.out.println("指定日期：" + nday);
        }

结果：

当前日期：2020-07-25
    指定日期：2020-06-01
    指定日期：2020-07-01

*  获取年月日周

int year = currday.getYear(); // 年
            int month = currday.getMonthValue(); // 月
            int day = currday.getDayOfMonth(); // 一月中的第几天
            int week = currday.getDayOfWeek().getValue();  一周的第几天
            System.out.printf("%d年%d月%d日，星期%d%n", year, month, day, week);

2020年7月25日，星期6

*  日期的比较：

LocalDate date1 = LocalDate.parse("2020-01-01");
            LocalDate date2 = LocalDate.parse("2020-01-01");
            System.out.println("比较两个日期是否相同:" +  date1.equals(date2));
    
            LocalDate data3 = LocalDate.parse("2020-03-01");
            boolean isBefore = date1.isBefore(data3);
            System.out.println("之前：" + isBefore);
            boolean isAfter = date1.isAfter(data3);
            System.out.println("之后：" + isAfter);

比较两个日期是否相同:true
    之前：true
    之后：false

*  日期加减:都是返回新的实例，而原来的实例并不会改变。

LocalDate date1 = LocalDate.parse("2020-01-01");
            System.out.println("日期：" + date1);
            System.out.println("+1天：" + date1.plusDays(1));
            System.out.println("+1周：" + date1.plusWeeks(1));
            System.out.println("+1月：" + date1.plusMonths(1));
            System.out.println("+1年：" + date1.plusYears(1));
    
            LocalDate date = LocalDate.now();
            LocalDate newDate = date.plus(1, ChronoUnit.DAYS);
            System.out.println("newDate=" + newDate);
    
    
     
            LocalDateTime currentTime = LocalDateTime.now();
            System.out.println("当前日期时间: " + currentTime);
            LocalDateTime data = currentTime.withDayOfMonth(10);
            System.out.println("新的日期时间: " + data);
            System.out.println("原来的日期时间: " + currentTime);

## LocalTime-时间 ##

LocalTime和LocalDate类似，区别在于LocalDate不包含具体时间，而LocalTime包含具体时间。同样可以使用now、of或parse方法来获得对象。

ocalDate类似它也拥有isBefore、isAfter、获取时间单元等方法，就不再赘述。

需要注意的是，LocalTime获得的时间格式为：11:41:58.904。也就是，HH:mm:ss.nnn，这里nnn是纳秒。

还有一个在实战中查询日期区间时我们经常定义的“23:59:59.99”常量再也不用自己定义了。

LocalTime time = LocalTime.now();
            LocalTime time2 =LocalTime.of(11, 7,3);
            LocalTime time3 =LocalTime.parse("11:07:03");
    
            System.out.println("当前时间：" + time);
            System.out.println("指定时间：" + time2);
            System.out.println("指定时间：" + time3);
    
            LocalTime maxTime = LocalTime.MAX;
            LocalTime minTime  = LocalTime.MIN;
            System.out.println("最大时间：" + maxTime);
            System.out.println("最小时间：" + minTime);

当前时间：12:09:12.381
    指定时间：11:07:03
    指定时间：11:07:03
    最大时间：23:59:59.999999999
    最小时间：00:00

## LocalDateTime-日期和时间的组合 ##

*  获取指定时区的时间

LocalDateTime localDateTime = LocalDateTime.now(ZoneId.of("Asia/Tokyo"));
    System.out.println(localDateTime);

LocalDateTime dateTime = LocalDateTime.now();
            LocalDateTime dateTime1 =LocalDateTime.of(2020, 1,11,11,54,30);
            LocalDateTime dateTime2 =LocalDateTime.parse("2020-07-25T12:13:35.552");
            LocalDateTime datetime4=LocalDate.now().atTime(LocalTime.now());
            LocalDateTime datetime5=LocalTime.now().atDate(LocalDate.now());
    
            System.out.println("当前时间：" + dateTime);
            System.out.println("指定时间：" + dateTime1);
            System.out.println("指定时间：" + dateTime2);
            System.out.println("当前时间：" + datetime4);
            System.out.println("当前时间：" + datetime5)

当前时间：2020-07-25T12:13:58.653
    指定时间：2020-01-11T11:54:30
    指定时间：2020-07-25T12:13:35.552
    当前时间：2020-07-25T12:13:58.762
    当前时间：2020-07-25T12:13:58.762

# Clock-- 获取当前时钟 #

@Test
        public void test_start() throws ParseException {
        
            Clock clock =  Clock.systemUTC();
            System.out.println(clock); //SystemClock[Z]
    
            //获取clock对应的毫秒数
            System.out.println(clock.millis());
            System.out.println(System.currentTimeMillis());
    
            // 当前时间
            System.out.println(clock.instant()); // 2020-07-25T05:01:44.325Z
        }

# Instant-时间戳 #

*  1秒 = 1000毫秒 =106微秒=109纳秒
 *  用于“时间戳”的运算。它是以Unix元年(传统的设定为UTC时区1970年1月1日午夜时分)开始所经历的描述进行运算。
 *  时间戳是指格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数。

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

// 指定系统时间戳
            Instant instant1 = Instant.ofEpochMilli(System.currentTimeMillis());
            System.out.println(instant1); // 2020-07-25T05:04:35.959Z

// 偏移量运算
            OffsetDateTime offsetDateTime =instant.atOffset(ZoneOffset.ofHours(8));
            System.out.println("当前时间（东时区）:"+offsetDateTime);

// 以Unix元年为起点，进行偏移量运算 ---- 通过指定ms数，获取时间
            Instant instant2 = Instant.ofEpochSecond(60);
            System.out.println(instant2);  #1970-01-01T00:01:00Z

@Test
        public void test_start() throws ParseException {
        
            // 解析指定时间戳
            Instant instant2 = Instant.parse("2019-06-10T03:42:39Z");
            System.out.println(instant2); //2019-06-10T03:42:39Z
           
    
            // 获取当前时间戳
            Instant instant = Instant.now();
            System.out.println("当前时间（UTC时区）:"+instant);
            System.out.println("获取时间戳（UTC时区）:"+instant.toEpochMilli());
    
            // 时间戳转LocalDateTime
            LocalDateTime localDateTime = LocalDateTime.ofInstant(instant, ZoneId.systemDefault());
            System.out.println(localDateTime);
            // 时间戳转时区时间
            ZonedDateTime zonedDateTime = ZonedDateTime.ofInstant(instant, ZoneId.of("Asia/Shanghai"));
            System.out.println(zonedDateTime);
        }

当前时间（UTC时区）:2020-07-25T04:17:27.540Z
    获取时间戳（UTC时区）:1595650647540
    当前时间（UTC时区）:2020-07-25T12:17:27.540+08:00

# Duration-获取时间段 #

Duration的内部实现与Instant类似，但Duration表示时间段，通过between方法创建。

//
            LocalDateTime frome = LocalDateTime.now();
            LocalDateTime to = LocalDateTime.now().plusDays(1);
            Duration duration = Duration.between(frome, to);
    
            long days = duration.toDays();
            long hours = duration.toHours();
            long millis = duration.toMillis();
            long seconds = duration.getSeconds();
            long minutes = duration.toMinutes();
            long nanos =  duration.toNanos();
    
            System.out.println("天数"+days);
            System.out.println("小时"+hours);
            System.out.println("分钟"+millis);
            System.out.println("秒数"+seconds);
            System.out.println("毫秒数"+minutes);
            System.out.println("纳秒数"+nanos);
    
            // Duration对象可以通过of()方法创建，该方法参数为时间段长度和时间单位。
            Duration duration1 = Duration.of(7, ChronoUnit.DAYS);
            Duration duration2 = Duration.of(60, ChronoUnit.SECONDS);

# Period-获取日期段 #

Period与Duration类似，获取一个时间段，只不过单位为年月日，也可以通过of方法和between方法创建，between方法接收的参数为LocalDate。

Period period=Period.of(2020, 1, 11);
            Period period1 = Period.between(LocalDate.now(), LocalDate.now().plusYears(1));

# ZoneId&&ZonedDateTime-创建时区时间 #

*  ZonedDateTime类，用于处理带时区的日期和时间。
 *  ZoneId表示不同的时区。大约有40不同的时区。

Set<String> allZoneIds=ZoneId.getAvailableZoneIds();
            System.out.println(allZoneIds.toString());
            
           // 创建时区：
            ZoneId zoneId=ZoneId.of("Asia/Shanghai");
            System.out.println("创建时区：" + zoneId); //Asia/Shanghai
    
            //获取当前时区：
            System.out.println("获取当前时区：" + ZoneId.systemDefault()); //Asia/Shanghai

//  ZonedDateTime的now():获取本时区的ZonedDateTime对象
            ZonedDateTime dd = ZonedDateTime.now();
            System.out.println("当前时区时" +  dd.getZone());
    
    		// ZonedDateTime的now(ZoneId id):获取指定时区的ZonedDateTime对象
    		ZonedDateTime zonedDateTime1 = ZonedDateTime.now(ZoneId.of("Asia/Tokyo"));
    		System.out.println(zonedDateTime1);

*  ZonedDateTime转：LocalDateTime 、LocalDate、LocalTime

//  // 获取当前时区当前时间 
            ZonedDateTime dd = ZonedDateTime.now();
            LocalDateTime dateTime = dd.toLocalDateTime();
            LocalDate     date = dd.toLocalDate();
            LocalTime     time = dd.toLocalTime();
            System.out.println("获取当前时区的日期时间:" +  dd); //2020-07-25T12:38:37.742+08:00[Asia/Shanghai]
            System.out.println("时区转换日期时间:" +  dateTime); //2020-07-25T12:38:37.742
            System.out.println("时区转换日期:" +  date); //2020-07-25
            System.out.println("时区转换时间:" +  time); //12:38:37.742

// 把LocalDateTime转换成特定的时区：
            ZonedDateTime zonedDateTime=ZonedDateTime.of(LocalDateTime.now(), ZoneId.of("Asia/Tokyo"));
            System.out.println(zonedDateTime);
    
    // 指定时间及时区
            ZonedDateTime zonedDateTime1 = ZonedDateTime.of(2019, 06, 10, 10, 30,30, 00,  ZoneId.of("UTC"));
            System.out.println(zonedDateTime1);
    
    		System.out.println();
    		// // 解析指定时间
            ZonedDateTime date1 = ZonedDateTime.parse("2015-12-03T10:15:30+05:30[Asia/Shanghai]");
            System.out.println(date1);

# 日期时间格式化 #

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

*  预定义的标准格式。如：ISO\_LOCAL\_DATE\_TIME;ISO\_LOCAL\_DATE;ISO\_LOCAL\_TIME
 *  本地化相关的格式。如：ofLocalizedDateTime(FormatStyle.LONG)
 *  自定义的格式。如：ofPattern(“yyyy-MM-dd hh:mm:ss”)

<table> 
 <thead> 
  <tr> 
   <th>API</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>ofPattern(String pattern)</td> 
   <td>静态方法 ， 返 回 一 个 指 定 字 符 串 格 式 的DateTimeFormatter</td> 
  </tr> 
  <tr> 
   <td>format(TemporalAccessor t)</td> 
   <td>格式化一个日期、时间，返回字符串</td> 
  </tr> 
  <tr> 
   <td>parse(CharSequence text)</td> 
   <td>将指定格式的字符序列解析为一个日期、时间</td> 
  </tr> 
 </tbody> 
</table>

// ----------- 日期 ---> 字符串
            // 可以使用DateTimeFormatter预置的格式，也可以通过DateTimeFormatter.ofPattern方法来指定格式。
            LocalDateTime dateTime = LocalDateTime.now();
            String str = dateTime.format(DateTimeFormatter.BASIC_ISO_DATE);
            System.out.println(str);
    
            DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
            str = dateTime.format(formatter);
            System.out.println(str);
    
            //---------字符串---》 日期
            String dataTimeStr = "2020-07-25 12:48:37";
            LocalDateTime dateTime1 = LocalDateTime.parse(dataTimeStr, formatter);
            System.out.println(dateTime1);

# TemporalAdjuster:时间校正器 #

// 获取当前日期的下一个周日是哪天？
    TemporalAdjuster temporalAdjuster = TemporalAdjusters.next(DayOfWeek.SUNDAY);
    LocalDateTime localDateTime = LocalDateTime.now().with(temporalAdjuster);
    System.out.println(localDateTime);
    // 获取下一个工作日是哪天？
    LocalDate localDate = LocalDate.now().with(new TemporalAdjuster() {
        
    @Override
    public Temporal adjustInto(Temporal temporal) {
        
    LocalDate date = (LocalDate) temporal;
    if (date.getDayOfWeek().equals(DayOfWeek.FRIDAY)) {
        
    return date.plusDays(3);
    } else if (date.getDayOfWeek().equals(DayOfWeek.SATURDAY)) {
        
    return date.plusDays(2);
    } else {
        
    return date.plusDays(1);
    } }
    });
    System.out.println("下一个工作日是：" + localDate);

# 新API与传统API之间的转换 #

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