java 8新特性 instant

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

1	`<code` `class="hljs lisp">Instant (<span` `class="hljs-name">java.time.Instant)</span></code>`

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

<code class="hljs kotlin"><span class="hljs-comment">//获得当前时间

Instant instant = Instant.now();

<span class="hljs-comment">// 以ISO-8601输出

System.<span class="hljs-keyword">out.println(instant);</code>

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

<code class="hljs javascript"><span class="hljs-comment">//将java.util.Date转换为Instant

Instant instant = Instant.ofEpochMilli(<span class="hljs-keyword">new <span class="hljs-built_in">Date().getTime());

<span class="hljs-comment">//从字符串类型中创建Instant类型的时间

instant = Instant.parse(<span class="hljs-string">"1995-10-23T10:12:35Z");</code>

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

1	`<code` `class="hljs css"><span` `class="hljs-selector-tag">instant<span` `class="hljs-selector-class">.plus(<span` `class="hljs-selector-tag">Duration<span` `class="hljs-selector-class">.ofHours(5)<span` `class="hljs-selector-class">.plusMinutes(4));</span></span></span></span></span></code>`

以上的代码表达的含义为，在现在的时间上加上5个小时4分钟。那么这个例子中，使用了多少个 java.time.Instant 实例呢？答案是两个。Java.time 这个包是线程安全的，并且和其他大部分类一样，是不可变类。Instant 也遵守这个规则，因此 plus() 方法会产生一个新的实例，如：

<code class="hljs gradle">Instant instant1 = instant.<span class="hljs-keyword">plus(Duration.ofHours(<span class="hljs-number">5).plusMinutes(<span class="hljs-number">4));

System.out.<span class="hljs-keyword">println(<span class="hljs-string">"Instant is immutable, so instant==instant returns: " + (instant == instant1));</code>

其输出为：

1	`<code` `class="hljs actionscript">Instant <span` `class="hljs-keyword">is immutable, so instant==instant returns: <span` `class="hljs-literal">false</span></span></code>`

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

<code class="hljs gradle"><span class="hljs-comment">//计算5天前的时间

instant.<span class="hljs-keyword">minus(<span class="hljs-number">5, ChronoUnit.DAYS); <span class="hljs-comment">// Option 1　方法1

instant.<span class="hljs-keyword">minus(Duration.ofDays(<span class="hljs-number">5)); <span class="hljs-comment">// Option 2 方法2

<span class="hljs-comment">//计算两个Instant之间的分钟数

<span class="hljs-keyword">long diffAsMinutes = instant.periodUntil(instant1, ChronoUnit.MINUTES); <span class="hljs-comment">// 方法1

<span class="hljs-keyword">long diffAsMinutes = ChronoUnit.MINUTES.between(instant, instant1); <span class="hljs-comment">// 方法2</code>

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

<code class="hljs less"><span class="hljs-comment">//用compareTo方法比较

System<span class="hljs-selector-class">.out<span class="hljs-selector-class">.format(<span class="hljs-string">"instant1.compareTo(instant)=%d.%n", instant1.compareTo(instant));

<span class="hljs-comment">// 使用isAfter()和isBefore()

System<span class="hljs-selector-class">.out<span class="hljs-selector-class">.format(<span class="hljs-string">"instant1.isAfter(instant)=%b, instant1.isBefore(instant)=%b.%n",

instant1.isAfter(instant), instant1.isBefore(instant))</code>

其输出结果为：

1 2	`<code` `class="hljs gradle">instant1.<span` `class="hljs-keyword">compareTo(instant)=<span` `class="hljs-number">1.` `instant1.isAfter(instant)=<span` `class="hljs-keyword">true, instant1.isBefore(instant)=<span` `class="hljs-keyword">false</span></span></span></span></code>`

Localdate 和 LocalTime

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

<code class="hljs bash">LocalDate <span class="hljs-built_in">localDate = LocalDate.now();

<span class="hljs-built_in">localDate = LocalDate.ofYearDay(2005, 86); // 获得2005年的第86天 (27-Mar-2005)

<span class="hljs-built_in">localDate = LocalDate.of(2013, Month.AUGUST, 10); //2013年8月10日

LocalTime <span class="hljs-built_in">localTime = LocalTime.of(22, 33); //10:33 PM

<span class="hljs-built_in">localTime = LocalTime.now();

<span class="hljs-built_in">localTime = LocalTime.ofSecondOfDay(4503); // 返回一天中的第4503秒 (1:15:30 AM)</code>

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

1 2	`<code` `class="hljs bash">LocalDate <span` `class="hljs-built_in">localDate1 = <span` `class="hljs-built_in">localDate.plus(5, ChronoUnit.HOURS);` `<span` `class="hljs-built_in">localDate.isBefore(<span` `class="hljs-built_in">localDate1);</span></span></span></span></code>`

LocalDateTime

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

<code class="hljs bash">LocalDateTime <span class="hljs-built_in">localDateTime = LocalDateTime.now();

//当前时间加上25小时３分钟

LocalDateTime <span class="hljs-keyword">inTheFuture = <span class="hljs-built_in">localDateTime.plusHours(25).plusMinutes(3);

// 同样也可以用在localTime和localDate中

System.out.println(<span class="hljs-built_in">localDateTime.toLocalTime().plusHours(25).plusMinutes(3));

System.out.println(<span class="hljs-built_in">localDateTime.toLocalDate().plusMonths(2));

// 也可以使用实现TemportalAmount接口的Duration类和Period类

System.out.println(<span class="hljs-built_in">localDateTime.toLocalTime().plus(Duration.ofHours(25).plusMinutes(3)));

System.out.println(<span class="hljs-built_in">localDateTime.toLocalDate().plus(Period.ofMonths(2)));</code>

java 8新特性 instant

猜你喜欢