Javatime 简明教程

java.time.Period Class

Introduction

java.time.Period 类基于年、月和日对一段时间的数量或长度进行建模。

Class declaration

以下是 java.time.Period 类的声明 -

public final class Period
   extends Object
      implements ChronoPeriod, Serializable

Field

下面是 Java.time.Period 类的字段 −

  1. static Period ZERO - 零持续时间常量。

Class methods

Sr.No.

Method & Description

1

Temporal addTo(Temporal temporal) 将这一时期添加到指定的时间对象中。

2

static Period between(LocalDate startInclusive, LocalDate endExclusive) 获取由两个日期之间的年、月和日组成的时期。

3

boolean equals(Object otherPeriod) 检查这一时期是否等于指定的时期。

4

static Duratio from(TemporalAmount amount) 从时间数量获取 Period 的实例。

5

long get(TemporalUnit unit) 获取请求单元的值。

6

IsoChronology getChronology() 获取此期间的年表,即 ISO 日历系统。

7

int getDays() 获取此期间的天数。

8

int getMonths() 获取此时间段的月数。

9

List<TemporalUnit> getUnits() 获取此时间段支持的单元集。

10

int hashCode() 此时间段的哈希代码。

11

boolean isNegative() 检查此时间段是否为负,不包括零。

12

boolean isZero() 检查此时间段长度是否为零。

13

Period minus(TemporalAmount amountToSubtract) 返回一个用指定时间段减去当前时间段的副本。

14

Period minusDays(long daysToSubtract) 返回一个用指定天数减去当前时间段的副本。

15

Period minusMonths(long months) 返回一个用指定月数减去当前时间段的副本。

16

Period minusYears(long years) 返回一个用指定年数减去当前时间段的副本。

17

Period multipliedBy(long multiplicand) 返回一个乘以标量的当前时间段副本。

18

Period negated() 返回一个长度取反的当前时间段副本。

19

Period normalized() 返回一个年数和月数经过标准化的当前时间段副本。

20

static Period of(int years, int months, int days) 获取表示特定年月日的时间段。

21

static Period ofDays(int days) 获取表示特定天数的时间段。

22

static Period ofMonths(int months) 获取表示特定月数的时间段。

23

static Period ofWeeks(int weeks) 获取表示特定周数的时间段。

24

static Period ofYears(int years) 获取表示特定周数的时间段。

25

static Period parse(CharSequence text) 从 PnYnMnD 这样的文本串中获取时间段。

26

Period plus(TemporalAmount amountToAdd) 返回一个用指定时间段加上当前时间段的副本。

27

Period plusDays(long daysToAdd) 返回已添加指定日期的此周期副本。

28

Period plusMonths(long monthsToAdd) 返回已添加指定月份的此周期副本。

29

Period plusYears(long yearsToAdd) 返回已添加指定年份的此周期副本。

30

Temporal subtractFrom(Temporal temporal) 从此指定的临时间隔对象中减去此周期。

31

String toString() 此周期的字符串表示形式,采用基于 ISO-8601 秒的表示形式,如 PT8H6M12.345S。

32

long toTotalMonths() 获取此周期中的月份总数。

33

Period withDays(int days) 返回此周期的副本,带有指定数量的天。

34

Period withMonths(int months) 返回此周期的副本,带有指定数量的月。

35

Period withYears(int years) 返回此周期的副本,带有指定数量的年。

Methods inherited

此类从以下类中继承方法:

  1. Java.lang.Object