1.概述作为本文的一部分,让我们从现有date和calendar api存在的一些问题入手,来探讨新的java 8 date和time api如何解决这些问题。
我们还将搞一搞java 8时间类库中的核心类,比如localdate, localtime, localdatetime, zoneddatetime, period, duration以及它们的api。
2. 旧的时间api(java8之前)的问题线程安全 - date 和calendar类不是线程安全的,使开发者难以调试这些api的并发问题,需要编写额外的代码来处理线程安全。java 8中引入的新的date和time api是不可变的和线程安全的,使得这些痛点得以解决。
api设计和易于理解 - 旧的时间api非常难以理解,操作都非常复杂,非常绕口,没有提供一些常用的解析转换方法。新的时间api是以iso为中心的,并遵循 date, time, duration 和 periods的一致域模型。提供了一些非常实用方法以支持最常见的操作。不再需要我们自己封装一些时间操作类。
zoneddate和time - 在旧的时间api中开发人员必须编写额外的逻辑来处理旧api的时区逻辑,而使用新的api,可以使用 local和zoneddate / time api来处理时区。无需过多关心时区转换问题。
3.使用localdate,localtime和localdatetime最常用的类是localdate,localtime和localdatetime。正如他们的名字所示,它们代表与上下文相结合的本地日期/时间。
这些类主要用于不需要在上下文中明确指定时区的情况。作为本节的一部分,我们将介绍最常用的api。
3.1.使用localdatelocaldate表示在iso格式(yyyy-mm-dd)下的不带具体时间的日期。
常用于表示生日或者我们最关心的发工资的日期。
获取当前系统时钟下的日期,如下所示:
localdate localdate = localdate.now();
表示特定日,月和年的localdate可以使用“ of ”方法或使用“ parse ”方法获得。例如,以下代码段代表2015年2月20日的localdate:
localdate.of(2015, 02, 20);localdate.parse("2015-02-20");
是不是非常直观而且方便呢!localdate提供各种实用方法,以获得各种日期信息。让我们快速浏览一下这些api方法。
以下代码段获取当前本地日期并添加一天:
localdate tomorrow = localdate.now().plusdays(1);
此示例获取当前日期并减去一个月。请注意它是如何接受枚举作为时间单位的:
localdate previousmonthsameday = localdate.now().minus(1, chronounit.months);
在以下两个代码示例中,我们分析日期“2016-06-12”并分别获取星期几和月中的某天。注意返回值,第一个是表示dayofweek的对象,而第二个是表示月份的序数值的int:
dayofweek sunday = localdate.parse("2016-06-12").getdayofweek();int twelve = localdate.parse("2016-06-12").getdayofmonth();
我们可以测试一个日期是否发生在闰年,如果用老方法怕不是要上天:
boolean leapyear = localdate.now().isleapyear();
判断日期的先后:
boolean notbefore = localdate.parse("2016-06-12").isbefore(localdate.parse("2016-06-11"));boolean isafter = localdate.parse("2016-06-12").isafter(localdate.parse("2016-06-11"));
日期边界可以从给定日期获得。在以下两个示例中,我们得到localdatetime,它代表给定日期的一天的开始(2016-06-12t00:00)和代表月初的localdate(2016-06-01):
localdatetime beginningofday = localdate.parse("2016-06-12").atstartofday();localdate firstdayofmonth = localdate.parse("2016-06-12").with(temporaladjusters.firstdayofmonth());
现在让我们来看看我们如何使用当地时间。
3.2.使用localtime在本地时间表示不带日期的时间。
与localdate类似,可以从系统时钟或使用“parse”和“of”方法创建localtime实例。快速浏览下面的一些常用api。
可以从系统时钟创建当前localtime的实例,如下所示:
localtime now = localtime.now();
在下面的代码示例中,我们通过解析字符串表示创建表示06:30 am 的localtime:
localtime sixthirty = localtime.parse("06:30");
方法“of”可用于创建localtime。例如,下面的代码使用“of”方法创建表示06:30 am的localtime:
localtime sixthirty = localtime.of(6, 30);
下面的示例通过解析字符串来创建localtime,并使用“plus”api为其添加一小时。结果将是代表07:30 am的localtime:
localtime seventhirty = localtime.parse("06:30").plus(1, chronounit.hours);
各种getter方法可用于获取特定的时间单位,如小时,分钟和秒,如下所示获取小时:
int six = localtime.parse("06:30").gethour();
同localdate一样检查特定时间是否在另一特定时间之前或之后。下面的代码示例比较结果为true的两个localtime:
boolean isbefore = localtime.parse("06:30").isbefore(localtime.parse("07:30"));
一天中的最大,最小和中午时间可以通过localtime类中的常量获得。在执行数据库查询以查找给定时间范围内的记录时,这非常有用。例如,下面的代码代表23:59:59.99:
localtime maxtime = localtime.max
现在让我们深入了解localdatetime。
3.3.使用localdatetime所述localdatetime用于表示日期和时间的组合。
当我们需要结合日期和时间时,这是最常用的类。该类提供了各种api,我们将介绍一些最常用的api。
类似于localdate和localtime从系统时钟获取localdatetime的实例:
localdatetime.now();
下面的代码示例解释了如何使用工厂“of”和“parse”方法创建实例。结果将是代表2015年2月20日06:30 am 的localdatetime实例:
localdatetime.of(2015, month.february, 20, 06, 30);localdatetime.parse("2015-02-20t06:30:00");
有一些实用的api可以支持特定时间单位的时间运算,例如天,月,年和分钟。以下代码示例演示了“加”和“减”方法的用法。这些api的行为与localdate和localtime中的 api完全相同:
localdatetime.plusdays(1);localdatetime.minushours(2);
getter方法可用于提取类似于日期和时间类的特定单位。鉴于上面的localdatetime实例,下面的代码示例将返回2月份的月份:
localdatetime.getmonth();
4.使用zoneddatetime api当我们需要处理时区特定的日期和时间时,java 8提供了zoneddatetime 类。zoneid是用于表示不同区域的标识符。大约有40个不同的时区,使用zoneid表示它们,如下所示
下面的代码我们来获取下“亚洲/上海”时区:
zoneid zoneid = zoneid.of("aisa/shanghai");
获取所有的时区:
set<string> allzoneids = zoneid.getavailablezoneids();
localdatetime转化为特定的时区中的时间:
zoneddatetime zoneddatetime = zoneddatetime.of(localdatetime, zoneid);
zoneddatetime提供解析方法来获取时区的特定日期时间:
zoneddatetime.parse("2015-05-03t10:15:30+01:00[aisa/shanghai]");
使用时区的另一种方法是使用offsetdatetime。offsetdatetime是具有偏移量的日期时间的不可变表示形式。此类存储所有日期和时间字段,精确到纳秒,以及从utc/格林威治的偏移量。可以使用zoneoffset创建offsetdatetime实例。这里我们创建一个localdatetime来表示2015年2月20日上午6:30:
localdatetime localdatetime = localdatetime.of(2015, month.february, 20, 06, 30);
然后我们通过创建zoneoffset并为localdatetime实例设置来增加两个小时:
zoneoffset offset = zoneoffset.of("+02:00");offsetdatetime offsetbytwo = offsetdatetime.of(localdatetime, offset);
我们现在的本地日期时间为2015-02-20 06:30 +02:00。现在让我们继续讨论如何使用period和duration类修改日期和时间值。
5.使用period和durationperiod : 用于计算两个日期(年月日)间隔。
duration : 用于计算两个时间(秒,纳秒)间隔。
5.1.使用periodperiod 类被广泛地用于修改给定的日期的值或者获取两个日期之间的差值:
localdate initialdate = localdate.parse("2007-05-10");localdate finaldate = initialdate.plus(period.ofdays(5));
period 类有各种getter方法,如getyears,getmonths和getdays从获取值周期对象。下面的代码示例返回一个int值为5,是基于上面示例的逆序操作:
int five = period.between(finaldate, initialdate).getdays();
该period 可以在特定的单元获得两个日期之间的如天或月或数年,使用chronounit.between:
int five = chronounit.days.between(finaldate , initialdate);
此代码示例返回五天。让我们继续看看duration类。
5.2.使用duration类似period ,该duration类是用来处理时间。在下面的代码中,我们创建一个本地时间上午6:30,然后加30秒的持续时间,以使本地时间上午6时三十〇分30秒的:
localtime initialtime = localtime.of(6, 30, 0);localtime finaltime = initialtime.plus(duration.ofseconds(30));
两个时刻之间的持续时间可以作为持续时间或作为特定单位获得。在第一个代码片段中,我们使用duration类的between()方法来查找finaltime和initialtime之间的时间差,并以秒为单位返回差异:
int thirty = duration.between(finaltime, initialtime).getseconds();
在第二个例子中,我们使用chronounit类的between()方法来执行相同的操作:
int thirty = chronounit.seconds.between(finaltime, initialtime);
现在我们来看看如何将旧的date 和calendar 转换为新的date和time。
6.与日期和日历的兼容性java 8添加了toinstant()方法,该方法有助于将旧api中的date和calendar实例转换为新的date time api,如下面的代码片段所示:
localdatetime.ofinstant(date.toinstant(), zoneid.systemdefault());localdatetime.ofinstant(calendar.toinstant(), zoneid.systemdefault());
所述localdatetime可以从如下“ofepochsecond"方法来构造。以下代码的结果将是代表2016-06-13t11:34:50 的localdatetime:
localdatetime.ofepochsecond(1465817690, 0, zoneoffset.utc);
现在让我们继续进行日期和时间格式化。
7. 日期和时间格式化java 8提供了用于轻松格式化日期和时间的 api :
localdatetime localdatetime = localdatetime.of(2015, month.january, 25, 6, 30);
以下代码传递iso日期格式以格式化本地日期。结果将是2015-01-25:
string localdatestring = localdatetime.format(datetimeformatter.iso_date);
该datetimeformatter提供多种标准格式选项。也可以提供自定义模式来格式化方法,如下所示,它将返回localdate为2015/01/25:
localdatetime.format(datetimeformatter.ofpattern("yyyy/mm/dd"));
我们可以将格式样式传递为short,long或medium作为格式化选项的一部分。
下面的代码示例输出2015年1月25日06:30:00 me的输:
localdatetime.format(datetimeformatter.oflocalizeddatetime(formatstyle.medium).withlocale(locale.uk);
最后让我们看看java 8 core date / time api 可用的替代方案。
8.替代方案8.1.使用threeten 类库对于从java 7或java 6这些老项目来说可以使用threeten ,然后可以像在上面java 8一样使用相同的功能,一旦你迁移到java 8 只需要修改你的包路径代码而无需变更:
<dependency><groupid>org.threeten</groupid><artifactid>threetenbp</artifactid><version>latest</version></dependency>
8.2.joda-time类库java 8 日期和时间库的另一种替代方案是joda-time库。事实上,java 8 date time api由joda-time库(stephen colebourne)和oracle共同领导。该库提供了java 8 date time项目中支持的几乎所有功能。通过在项目中引用以下pom依赖项就可以立即使用:
<dependency><groupid>joda-time</groupid><artifactid>joda-time</artifactid><version>latest</version></dependency>
以上就是java8 time api如何使用的详细内容。