LocalDateTime 简述

Java 8 更新的部分内容中,有一部分代替了以往比较难用的 java.util.Date 类,并且创建了一套新的时间类型,该类型为: java.time.LocalDateTime.

LocalDateTime 提供了许多方法供我们使用,

基本类型

java.time.LocalDate
java.time.LocalTime
java.time.LocalDateTime
java.time.ZoneId
java.time.format.DateTimeFormatter

java.time 包中提供的工具方法和类非常之多,但是我们在使用的时候基本上很难用到这里面所有的方法,很多时候我们甚至只了解其中的三分之一.

这些包中, LocalDate 表示日期, LocalTime 表示时间, LocalDateTime 表示日期和时间的组合.

ZoneId 表示时区,一般情况下可以使用 ZoneId.systemDefault() 获取当前系统默认的时区.当然,存在系统时区不正常的情况下我们可以使用 ZoneId.of("Asia/Shanghai") 的方法来避免.

DateTimeFormatte 包含了许多DateTimeFormatte类型的静态变量,它支持各种类型的日期和字符串之间的转换,具体的情况我们可以通过注释来查看.

基本方法

我们对于时间最常用的方法是获取时间,时间和字符串的转换,以及计算时间.

时间对象已经自带了很多的比较,计算的方法,相当显而易见,所以在这里不加赘述,大家可以直接进行调用.

获取时间

LocalDate LocalTime LocalDateTime 三个工具分别表示对应的时间,他们都有一些类似的方法,比如:

• now 方法都会获取到当前的时间.都有 MIN,MAX 属性,表示最大和最小的时间.
• of 方法会要求传入对应的 年月日时分秒 的信息,来返回对应的时间.
  
  还有一些比较有趣的方法比如:
  
  LocalDate

    public static LocalDate ofYearDay(int year, int dayOfYear);
    public static LocalDate ofEpochDay(long epochDay);

• ofYearDay 表示某一年的第几天,它会计算好对应的天数并且返回对应的日期.
• ofEpochDay 表示从 1970-01-01 开始计算之后的第几天的日期.

LocalTime

    public static LocalTime ofSecondOfDay(long secondOfDay);
    public static LocalTime ofNanoOfDay(long nanoOfDay);

• ofSecondOfDay 表示从一天开始的以秒计时的时间.
• ofNanoOfDay 表示从一天的开始的以纳秒计时的时间.

当然, LocalDateTime 也有一个名为 ofEpochSecond 的方法可以返回从 1970-01-01 00:00:00 开始计时的以秒计时的具体的时间日期,但是我目前没想到有什么用处.

完整时间

我们可以通过一些简单的方法获取对应的时间.

比如:

LocalDate 有一个最简单的 atTime 方法可以传入对应的 LocalTime 对象获取完整的时间. 或者可以选择 atStartOfDay 方法来获取这一天的开始时间.

LocalTime 同样也可以使用 atDate 方法来获取完整时间.

或者我们可以调用 LocalDateTime 方法的 of 方法来传入 LocalDate 和 LocalTime 对象来获得对应的时间.

字符串转换

字符串 -> 时间

parse 可以将字符串转换为对应的时间类型.

    LocalDate date = LocalDate.parse("2017-02-12");
    LocalTime time = LocalTime.parse("12:23:52");

除了这个我们还可以同时传入对应的 Formatter, 这个我们会在本文末尾提及.

    LocalDate date = LocalDate.parse("19870412", DateTimeFormatter.BASIC_ISO_DATE);

时间 -> 字符串

format 方法可以将时间转换成字符串.

    ZonedDateTime dateTime = ZonedDateTime.now();
    DateTimeFormatter formatter = DateTimeFormatter.RFC_1123_DATE_TIME;
    dateTime.format(formatter);
    formatter.format(dateTime);

我们需要对应的时间对象以及格式化对象,之后我们可以对任何一个对象进行 format 格式化.

DateTimeFormatter

这里我们只描述有关 DateTimeFormatter 的静态属性:

• ISO_LOCAL_DATE 日期: 例子: 2011-12-03
• ISO_OFFSET_DATE 日期: 例子: 2011-12-03+01:00
• ISO_DATE 日期: 例子: 2011-12-03 或者 2011-12-03+01:00
• ISO_LOCAL_TIME 时间: 例子: 10:15 或者 10:15:30
• ISO_OFFSET_TIME 带时区时间: 例子: 10:15+01:00 或者 10:15:30+01:00'
• ISO_TIME 时间: 例子: 10:15 或者 10:15:30 或者 10:15:30+01:00
• ISO_LOCAL_DATE_TIME 完整时间: 例子: 2011-12-03T10:15:30
• ISO_OFFSET_DATE_TIME 带时区完整时间: 例子: 2011-12-03T10:15:30+01:00
• ISO_ZONED_DATE_TIME 带时区带地区完整时间: 例子: 2011-12-03T10:15:30+01:00[Europe/Paris]
• ISO_DATE_TIME 完整时间: 例子: 2011-12-03T10:15:30 或者 2011-12-03T10:15:30+01:00 或者2011-12-03T10:15:30+01:00[Europe/Paris]
• ISO_ORDINAL_DATE 天数的日期: 例子: 2012-337
• ISO_WEEK_DATE 按周的日期: 例子: 2012-W48-6
• ISO_INSTANT 完整时间: 例子: 2011-12-03T10:15:30Z
• BASIC_ISO_DATE 日期: 例子: 20111203
• RFC_1123_DATE_TIME 完整时间 例子: Tue, 3 Jun 2008 11:05:30 GMT

转换时间的时候如果是带有时区的 formatter 我们需要使用 ZoneDateTime.