Java 8中的时间api初探1

本文是本人翻译做品,原文发表在:http://developer.51cto.com/art/201307/403828.htm Java 8目前已经开始进入大众的视线，其中笔者在写本文以前，留意到其中Java 8预览版中将会出现新的关于日期和时间的API（遵照JSR 310规范）。在本系列文章中，将对这些新的API进行举例说明。首先在本文中，将先介绍如下几个：Instant，LocalDate，LocalTime和LocalDateTime。 Java 8目前已经开始进入大众的视线，其中笔者在写本文以前，留意到其中Java 8预览版中将会出现新的关于日期和时间的API（遵照JSR 310规范）。在本系列文章中，将对这些新的API进行举例说明。首先在本文中，将先介绍如下几个：Instant，LocalDate，LocalTime和LocalDateTime。 Instant (java.time.Instant)  可能最容易开始学习java.time包中的内容的就是先来看看Instant这个类。所谓的Instant类表明的是某个时间（有点象java.util.Date），它是精确到纳秒的（而不是象旧版本的Date精确到毫秒）。若是使用纳秒去表示一个时间则原来的使用一位Long类型是不足够的，须要占用更多一点的存储空间，然而实际上其内部是由两个Long字段组成，第一个部分保存的是自标准Java计算时代（就是1970年1月1日开始）到如今的秒数，第二部分保存的是纳秒数（永远不会超过999,999,999）。咱们看下一个具体的例子： 　//得到当前时间    //得到当前时间  Instant instant = Instant.now(); // 以ISO-8601输出  System.out.println(instant);  在Open JDK 中运行上面的代码，能够有以下格式的输出：2013-06-25T16:22:52.966Z,能够看到，输入了更为精确的日期。下面的例子是更多的关于Instant类的用法，如 //将java.util.Date转换为Instant  Instant instant = Instant.ofEpochMilli(new Date().getTime());  //从字符串类型中建立Instant类型的时间  instant = Instant.parse("1995-10-23T10:12:35Z");  注意，在上面的例子中，有一个字符串中建立Instant类型的时间，但Instant表明的是一个时间，并不包括时区的概念，因此必须传入的是符合UTC格式的字符串）。Instant　API也提供了一些颇有用的方法容许使用Instant和其余包中的类进行一些运算，下面是例子： instant.plus(Duration.ofHours(5).plusMinutes(4));  上面表达的含义为，将如今的时间加上5个小时4分钟。 那么这个例子中，使用了多少个java.time.Instant实例呢？答案是两个。Java.time这个包是线程安全的而且和其余大部分类同样是不可变类。Instant也遵照这个规则，所以plus方法产生一个新的实例，如： Instant instant1 = instant.plus(Duration.ofHours(5).plusMinutes(4));  System.out.println("Instant is immutable, so instant==instant returns: " + (instant == instant1));  输出为： Instant is immutable, so instant==instant returns: false  下面是更多关于计算的例子： // Substract 5 days of an instant　计算5天前  instant.minus(5, ChronoUnit.DAYS); // Option 1　方法1  instant.minus(Duration.ofDays(5)); // Option 2  方法2    //计算两个Instant之间的分钟数  long diffAsMinutes = instant.periodUntil(instant1, ChronoUnit.MINUTES); // 方法1  long diffAsMinutes = ChronoUnit.MINUTES.between(instant, instant1); // 方法2  Instant是可比较的，这意味着能够对两个Instant进行比较。它提供了isAfter()和isBefore()两个方法进行比较，以下代码所示： //用compareTo方法比较  System.out.format("instant1.compareTo(instant)=%d.%n", instant1.compareTo(instant));    // 使用isAfter()和isBefore()  System.out.format("instant1.isAfter(instant)=%b, instant1.isBefore(instant)=%b.%n",    instant1.isAfter(instant), instant1.isBefore(instant))  输出结果： instant1.compareTo(instant)=1.  instant1.isAfter(instant)=true, instant1.isBefore(instant)=false  Localdate和LocalTime LocalDate表示不带时区的日期，好比1-1-2000。LocalTime表示不带时区的时间，好比04:44:50.12，和以前提到的Instant类是从1970年计算偏移量不一样，这两个类的输出是人们习惯阅读的日期和时间。有不少种方法去得到LocalTime和LocalDate的实例，如 LocalDate localDate = LocalDate.now();  localDate = LocalDate.ofYearDay(2005, 86); // 得到2005年的第86天 (27-Mar-2005)  localDate = LocalDate.of(2013, Month.AUGUST, 10); //2013年8月10日  LocalTime localTime = LocalTime.of(22, 33); //10:33 PM  localTime = LocalTime.now();  localTime = LocalTime.ofSecondOfDay(4503); // 返回一天中的第4503秒 (1:15:30 AM)  LocalDate和LocalTime和Instant同样遵照一样的线程规定―― 如它们的实例子都是不可变的。LocalDate和LocalTime和Instant有一样的计算和比较方法（其中有些方法是在java.time.temporal.Temporal接口中定义的，而且上面这些类都实现了这些方法）： LocalDate localDate1 = localDate.plus(5, ChronoUnit.HOURS);  localDate.isBefore(localDate1);  LocalDateTime 最后来看下在简单日期和时间类中最重要的一个:LocalDataTeime。它是LocalDate和LocalTime的组合体，表示的是不带时区的日期及时间。看上去，LocalDateTime和Instant很象，但记得的是“Instant中是不带时区的即时时间点。可能有人说，即时的时间点不就是日期＋时间么？看上去是这样的，但仍是有所区别，好比LocalDateTime对于用户来讲，可能就只是一个简单的日期和时间的概念，考虑以下的例子：两我的都在2013年７月２日１１点出生，第一我的是在英国出生，而第二个是在加尼福利亚，若是咱们问他们是在何时出生的话，则他们看上去都是在一样的时间出生（就是LocalDateTime所表达的），但若是咱们根据时间线（如格林威治时间线）去仔细考察，则会发如今出生的人会比在英国出生的人稍微晚几个小时（这就是Instant所表达的概念，而且要将其转换为UTC格式的时间）。除此以外，LocalDateTime的用法和上述介绍的其余类都很类似，以下例子所示： LocalDateTime localDateTime = LocalDateTime.now();    //当前时间加上25小时３分钟    LocalDateTime inTheFuture = localDateTime.plusHours(25).plusMinutes(3);    // 一样也能够用在localTime和localDate中    System.out.println(localDateTime.toLocalTime().plusHours(25).plusMinutes(3));    System.out.println(localDateTime.toLocalDate().plusMonths(2));    //  也可使用实现TemportalAmount接口的Duration类和Period类    System.out.println(localDateTime.toLocalTime().plus(Duration.ofHours(25).plusMinutes(3)));  System.out.println(localDateTime.toLocalDate().plus(Period.ofMonths(2)));