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-03ISO_OFFSET_DATE
日期: 例子: 2011-12-03+01:00ISO_DATE
日期: 例子: 2011-12-03 或者 2011-12-03+01:00ISO_LOCAL_TIME
时间: 例子: 10:15 或者 10:15:30ISO_OFFSET_TIME
带时区时间: 例子: 10:15+01:00 或者 10:15:30+01:00'ISO_TIME
时间: 例子: 10:15 或者 10:15:30 或者 10:15:30+01:00ISO_LOCAL_DATE_TIME
完整时间: 例子: 2011-12-03T10:15:30ISO_OFFSET_DATE_TIME
带时区完整时间: 例子: 2011-12-03T10:15:30+01:00ISO_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-337ISO_WEEK_DATE
按周的日期: 例子: 2012-W48-6ISO_INSTANT
完整时间: 例子: 2011-12-03T10:15:30ZBASIC_ISO_DATE
日期: 例子: 20111203RFC_1123_DATE_TIME
完整时间 例子: Tue, 3 Jun 2008 11:05:30 GMT
转换时间的时候如果是带有时区的 formatter 我们需要使用 ZoneDateTime.