Java 8 Date-Time API概览

根据网上资料整理

java 8增加了新的Date-Time API (JSR 310),增强对日期与时间的处理。它在很大程度上受到Joda-Time的影响。之前写过一篇关于Joda-Time的文章,还没写完,现在直接写这个java 8的新Date-Time API。

Date-Time API都在java.time包下。

一、设计理念

Date-Time API使用如下几个设计理念开发而成。

清晰

API里的方法定义良好,它们的行为是明确可预测的。例如,调用一个Date-Time方法并传递一个null参数必定会触发NullPointerException异常。

流式

Date-Time API 提供一个流式接口,使代码更容易被阅读。因为大多数方法不允许null参数,也不会返回null,方法调用可以被连在一起,使代码更快被理解。例如:

LocalDate today = LocalDate.now();
LocalDate payday = today.with(TemporalAdjusters.lastDayOfMonth()).minusDays(2);

不可变

Date-Time API中的大多数类创建的对象都是不可变的,当它被创建后不能被修改。对不可变对象进行的一些操作会返回一个新对象。这意味这Date-Time API是线程安全的。例如,创建一个date或者time对象使用of, from, 或者 with前缀,而不是一个构造器,并且也没有set方法。

LocalDate dateOfBirth = LocalDate.of(2012, Month.MAY, 14);
LocalDate firstBirthday = dateOfBirth.plusYears(1);

可扩展

Date-Time API可以是可扩展的。你可以定义你自己的时间调节器和查询,或者构建你自己的calendar 系统。

二、概览

java.time包里有许多可以代表时间和日期的类。这是一个非常丰富的API。下面列出几个关键的类:

  • Instant类,提供了一个机器视角的时间线。
  • LocalDate, LocalTimeLocalDateTime类提供了人类视角的日期和时间,不涉及到时区。
  • ZoneId, ZoneRulesZoneOffset类描述了时区,时区偏移量和时区规则。
  • ZonedDateTime类,代表了与时区关联的时间和日期。OffsetDateTimeOffsetTime分别代表了日期和时间和时间。这些类描述了时区偏移。
  • Duration类在秒和毫秒尺度丈量一段时间。
  • Period类在年、月和日尺度上丈量一段时间。

其他不是ISO日历系统的可以使用java.time.chrono包中的类。这里不介绍啦。

三、实例

3.1 获取当前日期和时间

LocalDate可以表示当前日期。它只包含日期不包含时分秒。

LocalTime可以表示当前时间。它不包含日期。

LocalDate date = LocalDate.now();
System.out.println(date);

LocalTime time = LocalTime.now();

System.out.println(time);

// 输出
2017-03-07
23:16:45.433

由此可见它输出的日期是格式化后的。

3.2 获取当前年月日

LocalDate now = LocalDate.now();  
int year = now.getYear();  
int month = now.getMonthValue();  
int day = now.getDayOfMonth();

System.out.println(year);
System.out.println(month);
System.out.println(day);

// 输出
2017
3
7

不用考虑用java.util.Calendar月份从0开始的问题。

3.3 获取指定日期**

LocalDate date = LocalDate.of(2017, 2, 14);

System.out.println(date);

// 输出
2017-02-14

根据月日判断日期是否相等

MonthDay不包含年份信息。可以用来代表每年重复出现的日期。

LocalDate now = LocalDate.now();

System.out.println(MonthDay.from(now));

System.out.println(MonthDay.of(6,1));

System.out.println(MonthDay.from(now).equals(MonthDay.of(6,1)));

// 输出
--03-07
--06-01
false

可以看到年份被-代替了。

3.4 日期格式化与解析

// 将字符串解析为日期对象
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
LocalDate date = LocalDate.parse("2017-06-01",formatter);
System.out.println(date);

// 将日期重新格式化输出
DateTimeFormatter formatter2 = DateTimeFormatter.ofPattern("yyyy:MM:dd");
System.out.println(date.format(formatter2));


// 输出
2017-06-01
2017:06:01

3.5 增加(减少)固定的时间

LocalDateTime dateTime = LocalDateTime.now();
System.out.println(dateTime);

// 增加1小时
dateTime = dateTime.plusHours(1);
System.out.println(dateTime);

// 增加1天
dateTime = dateTime.plusDays(1);
System.out.println(dateTime);

// 输出
2017-03-08T13:56:00.728
2017-03-08T14:56:00.728
2017-03-09T14:56:00.728

都是.plusXXX,如果想减少,传入负数即可。

3.6 增加(减少)固定的时间第二种方式

LocalDate date = LocalDate.now();
System.out.println(date);

LocalDate nextWeek = date.plus(1, ChronoUnit.WEEKS);

System.out.println(nextWeek);

// 输出
2017-03-08
2017-03-15

ChronoUnit类有许多常用单位,意思也很容易明白。

3.7 比较日期前后顺序

LocalDate today = LocalDate.now();

LocalDate childrensDay = LocalDate.of(2017,6,1);

System.out.println(today.isAfter(childrensDay));
System.out.println(childrensDay.isAfter(today));

// 输出
false
true

3.8 判断是否是闰年

LocalDate today = LocalDate.now();

System.out.println(today.isLeapYear());

// 输出
false

3.9 计算两日期间的天数等

LocalDateTime today = LocalDateTime.now();
LocalDateTime childrensDay = LocalDateTime.of(2017,6,1,0,0,0);
Duration duration = Duration.between(today,childrensDay);

System.out.println(duration.toDays());
System.out.println(duration.toHours());

LocalDate today2 = LocalDate.now();
LocalDate childrensDay2 = LocalDate.of(2017,6,1);
Period period = Period.between(today2,childrensDay2);

System.out.println(period.getMonths());
System.out.println(period.getYears());

// 输出
84
2017
2
0

3.10 新旧Date转换

Date d = new Date();
Instant i = d.toInstant();

// 转换成北京时间
LocalDate date = i.atOffset(ZoneOffset.ofHours(8)).toLocalDate();

Instant timestamp = Instant.now();
Date d = Date.from(timestamp);

3.11 获取当前毫秒

Clock clock = Clock.systemUTC();

System.out.println(clock.millis());

// 输出
1488984534369

3.12 获取两个日期间相差天数

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
LocalDate date = LocalDate.parse("2017-12-01",formatter);
LocalDate today = LocalDate.now();

System.out.println(ChronoUnit.DAYS.between(date,today));

// 输出
5

以后有什么好的例子再补充

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,445评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,889评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,047评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,760评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,745评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,638评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,011评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,669评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,923评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,655评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,740评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,406评论 4 320
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,995评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,961评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,023评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,483评论 2 342

推荐阅读更多精彩内容