除了lambda表达式,stream以及几个小的改进之外,Java 8还引入了一套全新的时间日期API,在本篇教程中我们将通过几个简单的任务演示样例来学习怎样使用Java 8的这套API。Java对日期,日历及时间的处理一直以来都饱受诟病。尤其是它决定将java.util.Date定义为可改动的以及将SimpleDateFormat实现成非线程安全的。
看来Java已经意识到须要为时间及日期功能提供更好的支持了,这对已经习惯使用Joda时间日期库的社区而言也是件好事。
关于这个新的时间日期库的最大的长处就在于它定义清楚了时间日期相关的一些概念,比方说,瞬时时间(Instant),持续时间(duration)。日期(date),时间(time)。时区(time-zone)以及时间段(Period)。同一时候它也借鉴了Joda库的一些长处。比方将人和机器对时间日期的理解区分开的。
Java 8仍然延用了ISO的日历体系。而且与它的前辈们不同。java.time包中的类是不可变且线程安全的。
新的时间及日期API位于java.time包中,以下是里面的一些关键的类:
- Instant——它代表的是时间戳
- LocalDate——不包括详细时间的日期。比方2014-01-14。它能够用来存储生日。周年纪念日,入职日期等。
- LocalTime——它代表的是不含日期的时间
- LocalDateTime——它包括了日期及时间。只是还是没有偏移信息或者说时区。
- ZonedDateTime——这是一个包括时区的完整的日期时间,偏移量是以UTC/格林威治时间为基准的。
新的库还添加了ZoneOffset及Zoned,能够为时区提供更好的支持。有了新的DateTimeFormatter之后日期的解析及格式化也变得焕然一新了。随便提一句。我是在去年这个时候Java正要推出这个新功能时写的这篇文章,所以你会发现演示样例中的时间都还是去年的。你执行下这些样例,它们返回的值肯定都是正确的。
Java 8是怎样处理时间及日期的
有人问我学习一个新库的最佳途径是什么?我的回答是,就是在实际项目中那样去使用它。在一个真实的项目中会有各种各样的需求,这会促使开发者去探索和研究这个新库。简言之,仅仅有任务本身才会真正促使你去探索及学习。
java 8的新的日期及时间API也是一样。
为了学习Java 8的这个新库。这里我创建了20个以任务为导向的样例。我们先从一个简单的任务開始。比方说怎样用Java 8的时间日期库来表示今天,接着再进一步生成一个带时间及时区的完整日期,然后再研究下怎样完毕一些更实际的任务。比方说开发一个提醒类的应用,来找出距离一些特定日期比方生日,周日纪念日,下一个帐单日,下一个溢价日或者信用卡过期时间还有多少天。
演示样例1 怎样 在Java 8中获取当天的日期
Java 8中有一个叫LocalDate的类,它能用来表示今天的日期。
这个类与java.util.Date略有不同,由于它仅仅包括日期,没有时间。因此,假设你仅仅须要表示日期而不包括时间。就能够使用它。
LocalDate today = LocalDate.now(); System.out.println("Today‘s Local date : " + today);
Output
Today‘s Local date : 2014-01-14
你能够看到它创建了今天的日期却不包括时间信息。它还将日期格式化完了再输出出来,不像之前的Date类那样,打印出来的数据都是未经格式化的。
演示样例2 怎样在Java 8中获取当前的年月日
LocalDate类中提供了一些非常方便的方法能够用于提取出年月日以及其他的日期属性。使用这些方法,你能够获取到不论什么你所须要的日期属性,而不再须要使用java.util.Calendar这种类了:
LocalDate today = LocalDate.now();
int year = today.getYear();
int month = today.getMonthValue();
int day = today.getDayOfMonth();
System.out.printf("Year : %d Month : %d day : %d \t %n", year, month, day);
Output
Today‘s Local date : 2014-01-14
Year : 2014 Month : 1 day : 14
能够看到。在Java 8中获取年月信息非常easy。仅仅需使用相应的getter方法就好了,无需记忆,非常直观。你能够拿它和Java中老的获取当前年月日的写法进行一下比較。
演示样例3 在Java 8中怎样获取某个特定的日期
在第一个样例中,我们看到通过静态方法now()来生成当天日期是非常easy的,只是通过另一个十分实用的工厂方法LocalDate.of(),则能够创建出随意一个日期,它接受年月日的參数。然后返回一个等价的LocalDate实例。
关于这种方法另一个好消息就是它没有再犯之前API中的错。比方说,年仅仅能从1900年開始。月必须从0開始,等等。这里的日期你写什么就是什么,比方说。以下这个样例中它代表的就是1月14日,没有什么隐藏逻辑。
LocalDate dateOfBirth = LocalDate.of(2010, 01, 14);
System.out.println("Your Date of birth is : " + dateOfBirth);
Output : Your Date of birth is : 2010-01-14
能够看出,创建出来的日期就是我们所写的那样。2014年1月14日。
演示样例4 在Java 8中怎样检查两个日期是否相等
假设说起现实中实际的处理时间及日期的任务,有一个常见的就是要检查两个日期是否相等。你可能经常会碰到要推断今天是不是某个特殊的日子,比方生日啊。周年纪念日啊,或者假期之类。有的时候,会给你一个日期,让你检查它是不是某个日子比方说假日。以下这个样例将会帮助你在Java 8中完毕这类任务。正如你所想的那样,LocalDate重写了equals方法来进行日期的比較。例如以下所看到的:
LocalDate date1 = LocalDate.of(2014, 01, 14); if(date1.equals(today)){
System.out.printf("Today %s and date1 %s are same date %n", today, date1);
}
Output
today 2014-01-14 and date1 2014-01-14 are same date
在本例中我们比較的两个日期是相等的。同一时候,假设在代码中你拿到了一个格式化好的日期串,你得先将它解析成日期然后才干比較。你能够将这个样例与Java之前比較日期的方式进行下比較,你会发现它真是爽多了。
演示样例5 在Java 8中怎样检查反复事件,比方说生日
在Java中另一个与时间日期相关的实际任务就是检查反复事件,比方说每月的帐单日,结婚纪念日。每月还款日或者是每年交保险费的日子。
假设你在一家电商公司工作的话。那么肯定会有这么一个模块,会去给用户发送生日祝福而且在每一个重要的假日给他们捎去问候,比方说圣诞节。感恩节,在印度则可能是万灯节(Deepawali)。
怎样在Java中推断是否是某个节日或者反复事件?使用MonthDay类。这个类由月日组合,不包括年信息。也就是说你能够用它来代表每年反复出现的一些日子。当然也有一些别的组合。比方说YearMonth类。
它和新的时间日期库中的其他类一样也都是不可变且线程安全的。而且它还是一个值类(value class)。我们通过一个样例来看下怎样使用MonthDay来检查某个反复的日期:
LocalDate dateOfBirth = LocalDate.of(2010, 01, 14);
MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());
MonthDay currentMonthDay = MonthDay.from(today);
if(currentMonthDay.equals(birthday)){
System.out.println("Many Many happy returns of the day !!");
}else{
System.out.println("Sorry, today is not your birthday");
}
Output: Many Many happy returns of the day !!
虽然年不同,但今天就是生日的那天,所以在输出那里你会看到一条生日祝福。你能够调整下系统的时间再执行下这个程序看看它能否提醒你下一个生日是什么时候。你还能够试着用你的下一个生日来编写一个JUnit单元測试看看代码能否正确执行。
演示样例6 怎样在Java 8中获取当前时间
这与第一个样例中获取当前日期非常相似。这次我们用的是一个叫LocalTime的类。它是没有日期的时间。与LocalDate是近亲。这里你也能够用静态工厂方法now()来获取当前时间。
默认的格式是hh:mm:ss:nnn,这里的nnn是纳秒。能够和Java 8曾经怎样获取当前时间做一下比較。
LocalTime time = LocalTime.now(); System.out.println("local time now : " + time);
Output
local time now : 16:33:33.369 // in hour, minutes, seconds, nano seconds
能够看到。当前时间是不包括日期的。由于LocalTime仅仅有时间。没有日期。
演示样例7 怎样添加时间里面的小时数
非常多时候我们须要添加小时,分或者秒来计算出将来的时间。
Java 8不仅提供了不可变且线程安全的类,它还提供了一些更方便的方法譬如plusHours()来替换原来的add()方法。顺便说一下,这些方法返回的是一个新的LocalTime实例的引用,由于LocalTime是不可变的,可别忘了存储好这个新的引用。
LocalTime time = LocalTime.now();
LocalTime newTime = time.plusHours(2); // adding two hours
System.out.println("Time after 2 hours : " + newTime);
Output :
Time after 2 hours : 18:33:33.369
能够看到当前时间2小时后是16:33:33.369。如今你能够将它和Java中添加或者降低小时的老的方式进行下比較。一看便知哪种方式更好。
演示样例8 怎样获取1周后的日期
这与前一个获取2小时后的时间的样例相似。这里我们将学会怎样获取到1周后的日期。LocalDate是用来表示无时间的日期的,它有一个plus()方法能够用来添加日,星期,或者月,ChronoUnit则用来表示这个时间单位。
由于LocalDate也是不可变的。因此不论什么改动操作都会返回一个新的实例,因此别忘了保存起来。
LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);
System.out.println("Today is : " + today);
System.out.println("Date after 1 week : " + nextWeek);
Output:
Today is : 2014-01-14
Date after 1 week : 2014-01-21
能够看到7天也就是一周后的日期是什么。你能够用这种方法来添加一个月,一年。一小时,一分钟。甚至是十年。查看下Java API中的ChronoUnit类来获取很多其他选项。
演示样例9 一年前后的日期
这是上个样例的续集。上例中,我们学习了怎样使用LocalDate的plus()方法来给日期添加日,周或者月。如今我们来学习下怎样用minus()方法来找出一年前的那天。
LocalDate previousYear = today.minus(1, ChronoUnit.YEARS);
System.out.println("Date before 1 year : " + previousYear);
LocalDate nextYear = today.plus(1, YEARS);
System.out.println("Date after 1 year : " + nextYear);
Output:
Date before 1 year : 2013-01-14
Date after 1 year : 2015-01-14
能够看到如今一共同拥有两年,一个是2013年,一个是2015年,各自是2014的前后那年。
演示样例10 在Java 8中使用时钟
Java 8中自带了一个Clock类,你能够用它来获取某个时区下当前的瞬时时间,日期或者时间。能够用Clock来替代System.currentTimeInMillis()与 TimeZone.getDefault()方法。
// Returns the current time based on your system clock and set to UTC.
Clock clock = Clock.systemUTC();
System.out.println("Clock : " + clock);
// Returns time based on system clock zone Clock defaultClock =
Clock.systemDefaultZone();
System.out.println("Clock : " + clock);
Output:
Clock : SystemClock[Z]
Clock : SystemClock[Z]
你能够用指定的日期来和这个时钟进行比較,比方以下这样:
public class MyClass {
private Clock clock; // dependency inject ...
public void process(LocalDate eventDate) {
if(eventDate.isBefore(LocalDate.now(clock)) {
...
}
}
}
假设你须要对不同一时候区的日期进行处理的话这是相当方便的。
演示样例11 在Java中怎样推断某个日期是在另一个日期的前面还是后面
这也是实际项目中常见的一个任务。你怎么推断某个日期是在另一个日期的前面还是后面,或者正好相等呢?在Java 8中,LocalDate类有一个isBefore()和isAfter()方法能够用来比較两个日期。假设调用方法的那个日期比给定的日期要早的话,isBefore()方法会返回true。
LocalDate tomorrow = LocalDate.of(2014, 1, 15); 、if(tommorow.isAfter(today)){
System.out.println("Tomorrow comes after today");
}
LocalDate yesterday = today.minus(1, DAYS);
if(yesterday.isBefore(today)){
System.out.println("Yesterday is day before today");
}
Output:
Tomorrow comes after today
Yesterday is day before today
能够看到在Java 8中进行日期比較非常easy。不须要再用像Calendar这种另一个类来完毕相似的任务了。
演示样例12 在Java 8中处理不同的时区
Java 8不仅将日期和时间进行了分离,同一时候还有时区。如今已经有好几组与时区相关的类了。比方ZonId代表的是某个特定的时区,而ZonedDateTime代表的是带时区的时间。
它等同于Java 8曾经的GregorianCalendar类。
使用这个类。你能够将本地时间转换成另一个时区中的相应时间。比方以下这个样例:
// Date and time with timezone in Java 8 ZoneId america = ZoneId.of("America/New_York");
LocalDateTime localtDateAndTime = LocalDateTime.now();
ZonedDateTime dateAndTimeInNewYork = ZonedDateTime.of(localtDateAndTime, america );
System.out.println("Current date and time in a particular timezone : " + dateAndTimeInNewYork);
Output :
Current date and time in a particular timezone : 2014-01-14T16:33:33.373-05:00[America/New_York]
能够拿它跟之前将本地时间转换成GMT时间的方式进行下比較。顺便说一下,正如Java 8曾经那样,相应时区的那个文本可别弄错了,否则你会碰到这么一个异常:
Exception in thread "main" java.time.zone.ZoneRulesException: Unknown time-zone ID: ASIA/Tokyo
at java.time.zone.ZoneRulesProvider.getProvider(ZoneRulesProvider.java:272)
at java.time.zone.ZoneRulesProvider.getRules(ZoneRulesProvider.java:227)
at java.time.ZoneRegion.ofId(ZoneRegion.java:120)
at java.time.ZoneId.of(ZoneId.java:403)
at java.time.ZoneId.of(ZoneId.java:351)
演示样例13 怎样表示固定的日期。比方信用卡过期时间
正如MonthDay表示的是某个反复出现的日子的。YearMonth又是另一个组合,它代表的是像信用卡还款日。定期存款到期日。options到期日这类的日期。你能够用这个类来找出那个月有多少天,lengthOfMonth()这种方法返回的是这个YearMonth实例有多少天。这对于检查2月究竟是28天还是29天但是非常实用的。
YearMonth currentYearMonth = YearMonth.now(); System.out.printf("Days in month year %s: %d%n", currentYearMonth, currentYearMonth.lengthOfMonth());
YearMonth creditCardExpiry = YearMonth.of(2018, Month.FEBRUARY);
System.out.printf("Your credit card expires on %s %n", creditCardExpiry);
Output:
Days in month year 2014-01: 31
Your credit card expires on 2018-02
演示样例14 怎样在Java 8中检查闰年
这并没什么复杂的,LocalDate类有一个isLeapYear()的方法能够返回当前LocalDate相应的那年是否是闰年。假设你还想反复造轮子的话,能够看下这段代码。这是纯用Java编写的推断某年是否是闰年的逻辑。
if(today.isLeapYear()){
System.out.println("This year is Leap year");
}else {
System.out.println("2014 is not a Leap year");
}
Output: 2014 is not a Leap year
你能够多检查几年看看结果是否正确。最好写一个单元測试来对正常年份和闰年进行下測试。
演示样例15 两个日期之间包括多少天。多少个月
另一个常见的任务就是计算两个给定的日期之间包括多少天,多少周或者多少年。
你能够用java.time.Period类来完毕这个功能。
在以下这个样例中,我们将计算当前日期与将来的一个日期之前一共隔着几个月。
LocalDate java8Release = LocalDate.of(2014, Month.MARCH, 14);
Period periodToNextJavaRelease =
Period.between(today, java8Release);
System.out.println("Months left between today and Java 8 release : " + periodToNextJavaRelease.getMonths() );
Output:
Months left between today and Java 8 release : 2
能够看到,本月是1月,而Java 8的公布日期是3月,因此中间隔着2个月。
演示样例16 带时区偏移量的日期与时间
在Java 8里面,你能够用ZoneOffset类来代表某个时区。比方印度是GMT或者UTC5:30。你能够使用它的静态方法ZoneOffset.of()方法来获取相应的时区。仅仅要获取到了这个偏移量,你就能够拿LocalDateTime和这个偏移量创建出一个OffsetDateTime。
LocalDateTime datetime = LocalDateTime.of(2014, Month.JANUARY, 14, 19, 30);
ZoneOffset offset = ZoneOffset.of("+05:30");
OffsetDateTime date = OffsetDateTime.of(datetime, offset);
System.out.println("Date and Time with timezone offset in Java : " + date);
Output :
Date and Time with timezone offset in Java : 2014-01-14T19:30+05:30
能够看到如今时间日期与时区是关联上了。另一点就是,OffSetDateTime主要是给机器来理解的。假设是给人看的。能够使用ZoneDateTime类。
演示样例17 在Java 8中怎样获取当前时间戳
假设你还记得在Java 8前是怎样获取当前时间戳的,那如今这简直就是小菜一碟了。Instant类有一个静态的工厂方法now()能够返回当前时间戳,例如以下:
Instant timestamp = Instant.now();
System.out.println("What is value of this instant " + timestamp);
Output :
What is value of this instant 2014-01-14T08:33:33.379Z
能够看出。当前时间戳是包括日期与时间的。与java.util.Date非常相似,其实Instant就是Java 8前的Date,你能够使用这两个类中的方法来在这两个类型之间进行转换。比方Date.from(Instant)是用来将Instant转换成java.util.Date的,而Date.toInstant()是将Date转换成Instant的。
演示样例18 怎样在Java 8中使用提前定义的格式器来对日期进行解析/格式化
在Java 8之前,时间日期的格式化但是个技术活。我们的好伙伴SimpleDateFormat并非线程安全的,而假设用作本地变量来格式化的话又显得有些笨重。
多亏了线程本地变量,这使得它在多线程环境下也算有了用武之地。但Java维持这一状态也有非常长一段时间了。这次它引入了一个全新的线程安全的日期与时间格式器。它还自带了一些提前定义好的格式器。包括了经常使用的日期格式。比方说,本例 中我们就用了提前定义的BASICISODATE格式,它会将2014年2月14日格式化成20140114。
String dayAfterTommorrow = "20140116";
LocalDate formatted = LocalDate.parse(dayAfterTommorrow,
DateTimeFormatter.BASIC_ISO_DATE);
System.out.printf("Date generated from String %s is %s %n", dayAfterTommorrow, formatted);
Output :
Date generated from String 20140116 is 2014-01-16
你能够看到生成的日期与指定字符串的值是匹配的。就是日期格式上略有不同。
演示样例19 怎样在Java中使用自己定义的格式器来解析日期
在上例中,我们使用了内建的时间日期格式器来解析日期字符串。
当然了,提前定义的格式器的确不错但有时候你可能还是须要使用自己定义的日期格式,这个时候你就得自己去创建一个自己定义的日期格式器实例了。
以下这个样例中的日期格式是”MMM dd yyyy”。你能够给DateTimeFormatter的ofPattern静态方法()传入不论什么的模式。它会返回一个实例,这个模式的字面量与前例中是同样的。比方说M还是代表月。而m仍是分。无效的模式会抛出DateTimeParseException异常,但假设是逻辑上的错误比方说该用M的时候用成m,这样就没办法了。
String goodFriday = "Apr 18 2014";
try {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("MMM dd yyyy");
LocalDate holiday = LocalDate.parse(goodFriday, formatter);
System.out.printf("Successfully parsed String %s, date is %s%n", goodFriday, holiday);
} catch (DateTimeParseException ex) {
System.out.printf("%s is not parsable!%n", goodFriday);
ex.printStackTrace();
}
Output :
Successfully parsed String Apr 18 2014, date is 2014-04-18
能够看到日期的值与传入的字符串的确是相符的,仅仅是格式不同。
演示样例20 怎样在Java 8中对日期进行格式化。转换成字符串
在上两个样例中。虽然我们用到了DateTimeFormatter类但我们主要是进行日期字符串的解析。
在这个样例中我们要做的事情正好相反。这里我们有一个LocalDateTime类的实例,我们要将它转换成一个格式化好的日期串。
这是眼下为止Java中将日期转换成字符串最简单便捷的方式了。
以下这个样例将会返回一个格式化好的字符串。与前例同样的是,我们仍需使用指定的模式串去创建一个DateTimeFormatter类的实例,但调用的并非LocalDate类的parse方法,而是它的format()方法。这种方法会返回一个代表当前日期的字符串。相应的模式就是传入的DateTimeFormatter实例中所定义好的。
LocalDateTime arrivalDate = LocalDateTime.now();
try {
DateTimeFormatter format = DateTimeFormatter.ofPattern("MMM dd yyyy hh:mm a");
String landing = arrivalDate.format(format);
System.out.printf("Arriving at : %s %n", landing);
} catch (DateTimeException ex) {
System.out.printf("%s can‘t be formatted!%n", arrivalDate);
ex.printStackTrace();
}
Output : Arriving at : Jan 14 2014 04:33 PM
能够看到,当前时间是用给定的”MMM dd yyyy hh:mm a”模式来表示的,它包括了三个字母表示的月份以及用AM及PM来表示的时间。
Java 8中日期与时间API的几个关键点
看完了这些样例后。我相信你已经对Java 8这套新的时间日期API有了一定的了解了。如今我们来回想下关于这个新的API的一些关键的要素。
- 它提供了javax.time.ZoneId用来处理时区。
- 它提供了LocalDate与LocalTime类
- Java 8中新的时间与日期API中的全部类都是不可变且线程安全的,这与之前的Date与Calendar API中的恰好相反。那里面像java.util.Date以及SimpleDateFormat这些关键的类都不是线程安全的。
- 新的时间与日期API中非常重要的一点是它定义清楚了主要的时间与日期的概念,比方说。瞬时时间,持续时间。日期,时间,时区以及时间段。它们都是基于ISO日历体系的。
- 每一个Java开发者都应该至少了解这套新的API中的这五个类:
- Instant 它代表的是时间戳,比方2014-01-14T02:20:13.592Z,这能够从java.time.Clock类中获取,像这样: Instant current = Clock.system(ZoneId.of(“Asia/Tokyo”)).instant();
- LocalDate 它表示的是不带时间的日期,比方2014-01-14。它能够用来存储生日,周年纪念日,入职日期等。
- LocalTime – 它表示的是不带日期的时间
- LocalDateTime – 它包括了时间与日期,只是没有带时区的偏移量
- ZonedDateTime – 这是一个带时区的完整时间,它依据UTC/格林威治时间来进行时区调整
- 这个库的主包是java.time。里面包括了代表日期。时间,瞬时以及持续时间的类。它有两个子package,一个是java.time.foramt,这个是什么用途就非常明显了,另一个是java.time.temporal,它能从更低层面对各个字段进行訪问。
- 时区指的是地球上共享同一标准时间的地区。
每一个时区都有一个唯一标识符。同一时候另一个地区/城市(Asia/Tokyo)的格式以及从格林威治时间開始的一个偏移时间。比方说。东京的偏移时间就是+09:00。
- OffsetDateTime类实际上包括了LocalDateTime与ZoneOffset。它用来表示一个包括格林威治时间偏移量(+/-小时:分。比方+06:00或者 -08:00)的完整的日期(年月日)及时间(时分秒。纳秒)。
- DateTimeFormatter类用于在Java中进行日期的格式化与解析。与SimpleDateFormat不同,它是不可变且线程安全的。假设须要的话,能够赋值给一个静态变量。DateTimeFormatter类提供了很多提前定义的格式器,你也能够自己定义自己想要的格式。当然了,依据约定。它另一个parse()方法是用于将字符串转换成日期的。假设转换期间出现不论什么错误,它会抛出DateTimeParseException异常。相似的,DateFormatter类也有一个用于格式化日期的format()方法。它出错的话则会抛出DateTimeException异常。
- 再说一句。“MMM d yyyy”与“MMm dd yyyy”这两个日期格式也略有不同,前者能识别出”Jan 2 2014″与”Jan 14 2014″这两个串,而后者假设传进来的是”Jan 2 2014″则会报错。由于它期望月份处传进来的是两个字符。
为了解决问题,在天为个位数的情况下,你得在前面补0,比方”Jan 2 2014″应该改为”Jan 02 2014″。
关于Java 8这个新的时间日期API就说到这了。这几个简短的演示样例 对于理解这套新的API中的一些新增类已经足够了。由于它是基于实际任务来解说的。因此后面再遇到Java中要对时间与日期进行处理的工作时。就不用再四处寻找了。
我们学习了怎样创建与改动日期实例。我们还了解了纯日期,日期加时间,日期加时区的差别,知道怎样比較两个日期。怎样找到某天到指定日期比方说下一个生日,周年纪念日或者保险日还有多少天。我们还学习了怎样在Java 8中用线程安全的方式对日期进行解析及格式化,而无需再使用线程本地变量或者第三方库这种取巧的方式。
新的API能胜任不论什么与时间日期相关的任务