简介
Duration类通过
年月日时分秒
相结合来描述一个时间量,最高精度是纳秒
。时间量可以为正也可以为负,比如1天(86400秒0纳秒)、-1天(-86400秒0纳秒)、1年(31556952秒0纳秒)、1毫秒(0秒1000000纳秒)等。
Period类通过年月日
相结合来描述一个时间量,最高精度是天
。时间量可以为正也可以为负,例如2年(2年0个月0天)、3个月(0年3个月0天)、4天(0年0月4天)等。
这两个类是不可变的、线程安全的、最终类。都是JDK8新增
的。
Duration的使用
创建方法
通过时间单位创建
基于天、时、分、秒、纳秒创建。
ofDays(), ofHours(), ofMillis(), ofMinutes(), ofNanos(), ofSeconds()。例如:
Duration fromDays = Duration.ofDays(1);
// 获取一天的秒数
fromDays.getSeconds();
通过LocalDateTime或LocalTime
通过LocalDateTime或者LocalTime 类,然后使用between获取创建Duration。
LocalDateTime start = LocalDateTime.of(2022, 1, 1, 8, 0, 0);
LocalDateTime end = LocalDateTime.of(2022, 1, 2, 8, 30, 30);
Duration duration = Duration.between(start, end);
通过已有的Duration
Duration du1 = Duration.ofHours(10);
Duration duration = Duration.from(du1);
解析方法
用法示例
Duration fromChar1 = Duration.parse("P1DT1H10M10.5S");
Duration fromChar2 = Duration.parse("PT10M");
格式说明
采用ISO-8601时间格式。格式为:PnYnMnDTnHnMnS (n为个数)
例如:P1Y2M10DT2H30M15.03S
- P:开始标记
- 1Y:一年
- 2M:两个月
- 10D:十天
- T:日期和时间的分割标记
- 2H:两个小时
- 30M:三十分钟
- 15S:15.02秒
详解
1、"P", "D", "H", "M" 和 "S"可以是大写或者小写(建议大写)
2、可以用“-”表示负数
示例大全
"PT20.345S" -- parses as "20.345 seconds"
"PT15M" -- parses as "15 minutes" (where a minute is 60 seconds)
"PT10H" -- parses as "10 hours" (where an hour is 3600 seconds)
"P2D" -- parses as "2 days" (where a day is 24 hours or 86400 seconds)
"P2DT3H4M" -- parses as "2 days, 3 hours and 4 minutes"
"P-6H3M" -- parses as "-6 hours and +3 minutes"
"-P6H3M" -- parses as "-6 hours and -3 minutes"
"-P-6H+3M" -- parses as "+6 hours and -3 minutes"
比较方法
比较两个时间的差
Instant start = Instant.parse("2017-10-03T10:15:30.00Z");
Instant end = Instant.parse("2017-10-03T10:16:30.00Z");
// 使用这个也可以,需要支持 seconds 的时间类
LocalDateTime now = LocalDateTime.now()
// end - start
Duration duration = Duration.between(start, end);
// 任何一个时间单元为负数,则返回true。true:end早于start
duration.isNegative();
Duration.between(start, end).getSeconds();
Duration.between(start, end).getNano();
增减方法
plusX()、minusX()
X表示days, hours, millis, minutes, nanos 或 seconds
Duration duration = Duration.ofHours(2);
Duration newDuration = duration.plusSeconds(33);
plus()/minus()方法
带TemporalUnit 类型参数进行加减:
Duration duration = Duration.ofHours(2);
Duration newDuration = duration.plus(33, ChronoUnit.SECONDS);
转换单位
可以用toX来转换为其他单位,支持:toDays, toHours, toMinutes, toMillis, toNanos
Duration duration = Duration.ofHours(2);
duration.toDays(); // 0
duration.toHours(); // 2
duration.toMinutes(); // 120
duration.toMillis(); // 7200000
duration.toNanos(); // 7200000000000
取值方法
可以用getX来获得指定位置的值,因为Duration是由秒和纳秒组成,所以只能获得秒和纳秒:
Duration duration = Duration.ofHours(2);
duration.getSeconds(); //7200
duration.getNano(); //0
Period的使用
创建方法
通过时间单位创建
如果仅一个值表示,如使用ofDays()方法,那么其他值为0。
若仅用ofWeeks,则其天数为week数乘以7.
Period fromUnits = Period.of(3, 10, 10);
Period fromDays = Period.ofDays(50);
Period fromMonths = Period.ofMonths(5);
Period fromYears = Period.ofYears(10);
Period fromWeeks = Period.ofWeeks(40); //280天
通过LocalDate创建
LocalDate startDate = LocalDate.of(2015, 2, 20);
LocalDate endDate = LocalDate.of(2017, 1, 15);
// endDate减startDate
Period period = Period.between(startDate, endDate);
解析方法
格式1:“PnYnMnWnD”
- P:开始符,表示period(即:表示年月日);
- Y:year;
- M:month;
- W:week;
- D:day
P, Y, M, W, D都可以用大写或者小写。
Period period = Period.parse("P2Y"); //2年
Period period = Period.parse("P2Y3M5D"); //2年3月5天
Period period = Period.parse("P1Y2M3W4D"); // 1年2月3周4天。即:1年2月25天
获得年月日
period.getYears();
period.getMonths();
period.getDays();
比较方法
用between来比较日期。
LocalDate startDate = LocalDate.of(2015, 2, 20);
LocalDate endDate = LocalDate.of(2017, 1, 15);
// startDate减endDate
Period period = Period.between(startDate, endDate);
// 任何一个时间单元为负数,则返回true。true:endDate早于startDate
period.isNegative()
增减方法
Period period = Period.parse("P2Y3M5D");
period.plusDays(50);
period.minusMonths(2);
转换单位
Period period = Period.parse("P1Y2M3D");
period.toTotalMonths(); // 14
取值方法
Period period = Period.parse("P1Y2M3D");
period.getYears(); // 1
period.getMonths(); // 2
period.getDays(); // 3
原文章地址:
https://blog.csdn.net/feiying0canglang/article/details/124918218
https://knife.blog.csdn.net/article/details/122772818