Java 8中时间API初探之一

译文
开发 后端
Java 8目前已经开始进入大众的视线,其中笔者在写本文之前,留意到其中Java 8预览版中将会出现新的关于日期和时间的API(遵守JSR 310规范)。在本系列文章中,将对这些新的API进行举例说明。首先在本文中,将先介绍以下几个:Instant,LocalDate,LocalTime和LocalDateTime。

Java 8目前已经开始进入大众的视线,其中笔者在写本文之前,留意到其中Java 8预览版中将会出现新的关于日期和时间的API(遵守JSR 310规范)。在本系列文章中,将对这些新的API进行举例说明。首先在本文中,将先介绍以下几个:Instant,LocalDate,LocalTime和LocalDateTime。

  1. Instant (java.time.Instant) 

可能最容易开始学习java.time包中的内容的就是先来看看Instant这个类。所谓的Instant类代表的是某个时间(有点象java.util.Date),它是精确到纳秒的(而不是象旧版本的Date精确到毫秒)。如果使用纳秒去表示一个时间则原来的使用一位Long类型是不足够的,需要占用更多一点的存储空间,然而实际上其内部是由两个Long字段组成,***个部分保存的是自标准Java计算时代(就是1970年1月1日开始)到现在的秒数,第二部分保存的是纳秒数(永远不会超过999,999,999)。我们看下一个具体的例子:

  1.  //获得当前时间 
  2.  
  3. //获得当前时间 
  4. Instant instant = Instant.now();
  5. // 以ISO-8601输出 
  6. System.out.println(instant);

在Open JDK 中运行上面的代码,可以有如下格式的输出:2013-06-25T16:22:52.966Z,可以看到,输入了更为精确的日期。下面的例子是更多的关于Instant类的用法,如

  1. //将java.util.Date转换为Instant 
  2. Instant instant = Instant.ofEpochMilli(new Date().getTime()); 
  3. //从字符串类型中创建Instant类型的时间 
  4. instant = Instant.parse("1995-10-23T10:12:35Z"); 

注意,在上面的例子中,有一个字符串中创建Instant类型的时间,但Instant代表的是一个时间,并不包括时区的概念,所以必须传入的是符合UTC格式的字符串)。Instant API也提供了一些很有用的方法允许使用Instant和其他包中的类进行一些运算,下面是例子:

  1. instant.plus(Duration.ofHours(5).plusMinutes(4)); 

上面表达的含义为,将现在的时间加上5个小时4分钟。

那么这个例子中,使用了多少个java.time.Instant实例呢?答案是两个。Java.time这个包是线程安全的并且和其他大部分类一样是不可变类。Instant也遵守这个规则,因此plus方法产生一个新的实例,如:

  1. Instant instant1 = instant.plus(Duration.ofHours(5).plusMinutes(4)); 
  2. System.out.println("Instant is immutable, so instant==instant returns: " + (instant == instant1)); 

输出为:

  1. Instant is immutable, so instant==instant returns: false 

 

下面是更多关于计算的例子:

  1. // Substract 5 days of an instant 计算5天前 
  2. instant.minus(5, ChronoUnit.DAYS); // Option 1 方法1 
  3. instant.minus(Duration.ofDays(5)); // Option 2  方法2 
  4.  
  5. //计算两个Instant之间的分钟数 
  6. long diffAsMinutes = instant.periodUntil(instant1, ChronoUnit.MINUTES); // 方法1 
  7. long diffAsMinutes = ChronoUnit.MINUTES.between(instant, instant1); // 方法2 

Instant是可比较的,这意味着可以对两个Instant进行比较。它提供了isAfter()和isBefore()两个方法进行比较,如下代码所示:

  1. //用compareTo方法比较 
  2. System.out.format("instant1.compareTo(instant)=%d.%n", instant1.compareTo(instant)); 
  3.  
  4. // 使用isAfter()和isBefore() 
  5. System.out.format("instant1.isAfter(instant)=%b, instant1.isBefore(instant)=%b.%n",  
  6.  instant1.isAfter(instant), instant1.isBefore(instant)) 

输出结果:

  1. instant1.compareTo(instant)=1
  2. instant1.isAfter(instant)=true, instant1.isBefore(instant)=false 

 

Localdate和LocalTime

LocalDate表示不带时区的日期,比如1-1-2000。LocalTime表示不带时区的时间,比如04:44:50.12,和之前提到的Instant类是从1970年计算偏移量不同,这两个类的输出是人们习惯阅读的日期和时间。有很多种方法去获得LocalTime和LocalDate的实例,如

  1. LocalDate localDate = LocalDate.now(); 
  2. localDate = LocalDate.ofYearDay(200586); // 获得2005年的第86天 (27-Mar-2005) 
  3. localDate = LocalDate.of(2013, Month.AUGUST, 10); //2013年8月10日 
  4. LocalTime localTime = LocalTime.of(2233); //10:33 PM 
  5. localTime = LocalTime.now(); 
  6. localTime = LocalTime.ofSecondOfDay(4503); // 返回一天中的第4503秒 (1:15:30 AM)

LocalDate和LocalTime和Instant一样遵守同样的线程规定―― 如它们的实例子都是不可变的。LocalDate和LocalTime和Instant有同样的计算和比较方法(其中有些方法是在java.time.temporal.Temporal接口中定义的,并且上面这些类都实现了这些方法):

  1. LocalDate localDate1 = localDate.plus(5, ChronoUnit.HOURS); 
  2. localDate.isBefore(localDate1); 

LocalDateTime

***来看下在简单日期和时间类中最重要的一个:LocalDataTeime。它是LocalDate和LocalTime的组合体,表示的是不带时区的日期及时间。看上去,LocalDateTime和Instant很象,但记得的是“Instant中是不带时区的即时时间点。可能有人说,即时的时间点不就是日期+时间么?看上去是这样的,但还是有所区别,比如LocalDateTime对于用户来说,可能就只是一个简单的日期和时间的概念,考虑如下的例子:两个人都在2013年7月2日11点出生,***个人是在英国出生,而第二个是在加尼福利亚,如果我们问他们是在什么时候出生的话,则他们看上去都是在同样的时间出生(就是LocalDateTime所表达的),但如果我们根据时间线(如格林威治时间线)去仔细考察,则会发现在出生的人会比在英国出生的人稍微晚几个小时(这就是Instant所表达的概念,并且要将其转换为UTC格式的时间)。除此之外,LocalDateTime的用法和上述介绍的其他类都很相似,如下例子所示:

  1. LocalDateTime localDateTime = LocalDateTime.now(); 
  2.  
  3. //当前时间加上25小时3分钟 
  4.  
  5. LocalDateTime inTheFuture = localDateTime.plusHours(25).plusMinutes(3); 
  6.  
  7. // 同样也可以用在localTime和localDate中 
  8.  
  9. System.out.println(localDateTime.toLocalTime().plusHours(25).plusMinutes(3)); 
  10.  
  11. System.out.println(localDateTime.toLocalDate().plusMonths(2)); 
  12.  
  13. //  也可以使用实现TemportalAmount接口的Duration类和Period类 
  14.  
  15. System.out.println(localDateTime.toLocalTime().plus(Duration.ofHours(25).plusMinutes(3))); 
  16. System.out.println(localDateTime.toLocalDate().plus(Period.ofMonths(2))); 

原文链接:http://blog.eyallupu.com/2013/07/java-8-apis-javautiltime-instant.html

责任编辑:陈四芳 来源: 51CTO
相关推荐

2010-09-08 17:26:46

JavaScript

2014-12-22 10:14:31

Java8

2017-02-27 14:09:45

HTTPAPI网关Kong

2020-10-27 10:40:18

JavaAPI V3支付

2014-09-17 13:48:16

iOS 8Size Classe

2011-09-20 09:38:13

Windows 8安全模式

2023-01-10 08:27:35

Java8APIJava

2024-02-02 11:18:37

Java 8API对象

2024-03-18 00:00:00

CalendaJava8Date

2024-02-04 08:35:03

APIJava 8数据库

2012-09-26 09:52:57

项目项目回顾时间管理

2021-03-12 00:04:52

网关Api

2021-04-23 08:35:16

k8s故障检测

2012-03-15 16:12:57

JavaHashMap

2022-03-15 15:24:53

操作系统RTOSAT模块

2021-07-07 09:18:00

Java并发编程

2011-08-24 09:30:29

JavaJVM

2012-04-05 13:50:38

Java

2018-04-17 16:29:24

Java面试HTTP

2023-05-12 07:40:01

Java8API工具
点赞
收藏

51CTO技术栈公众号