SignedInterval (Falcon: A common library for Java 0.4.1 API)

java.lang.Object
- com.iofairy.falcon.time.SignedInterval

所有已实现的接口:

ChronoInterval, Serializable, Comparable<SignedInterval>, TemporalAmount

直接已知子类:

Interval
```
public class SignedInterval
extends Object
implements ChronoInterval, Comparable<SignedInterval>
```
SignedInterval

从以下版本开始:

0.1.0

另请参阅:

序列化表格

字段概要

字段
限定符和类型	字段	说明
`long`	`centuries`	世纪（100年）
`long`	`days`	日
`protected Temporal`	`endTime`
`long`	`hours`	时
`long`	`micros`	微秒
`long`	`millis`	毫秒
`long`	`minutes`	分
`long`	`months`	月
`long`	`nanos`	纳秒
`long`	`seconds`	秒
`private static long`	`serialVersionUID`
`protected Temporal`	`startTime`
`static List<Class<? extends Temporal>>`	`SUPPORTED_TEMPORAL`	`between(Temporal, Temporal)`支持的temporal类型
`protected static String`	`SUPPORTED_TEMPORAL_STRING`
`private static List<TemporalUnit>`	`SUPPORTED_UNITS`
`protected long`	`totalDays`
`protected long`	`totalHours`
`protected BigInteger`	`totalMicros`
`protected long`	`totalMillis`
`protected long`	`totalMinutes`
`protected long`	`totalMonths`
`protected BigInteger`	`totalNanos`
`protected long`	`totalSeconds`
`protected long`	`totalWeeks`
`protected long`	`totalYears`
`long`	`years`	年
`static SignedInterval`	`ZERO`

构造器概要

构造器
构造器	说明
`SignedInterval(long days, long hours, long minutes)`
`SignedInterval(long months, long days, long hours, long minutes)`
`SignedInterval(long years, long months, long days, long hours, long minutes)`
`SignedInterval(long years, long months, long days, long hours, long minutes, long seconds)`
`SignedInterval(long years, long months, long days, long hours, long minutes, long seconds, long millis)`
`SignedInterval(long centuries, long years, long months, long days, long hours, long minutes, long seconds, long millis)`
`SignedInterval(long centuries, long years, long months, long days, long hours, long minutes, long seconds, long millis, long micros, long nanos)`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法	说明
`Temporal`	`addTo(Temporal temporal)`
`static SignedInterval`	`between(DateTime<?> startDateTime, DateTime<?> endDateTime)`	Obtain two `DateTime` interval.
`static SignedInterval`	`between(Temporal startTemporal, Temporal endTemporal)`	Obtain two `Temporal` datetime interval.
`static SignedInterval`	`between(Calendar startCalendar, Calendar endCalendar)`	Obtain two `Calendar` datetime interval.
`static SignedInterval`	`between(Date startDate, Date endDate)`	Obtain two `Date` datetime interval.
`int`	`compareTo(SignedInterval other)`
`boolean`	`equals(Object baseInterval)`
`long`	`get(TemporalUnit unit)`
`Temporal`	`getEndTime()`
`Temporal`	`getStartTime()`
`List<TemporalUnit>`	`getUnits()`
`static boolean`	`isSupported(Temporal temporal)`	Checks if the specified temporal is supported.
`SignedInterval`	`minus(long amount, TemporalUnit unit)`
`SignedInterval`	`minus(SignedInterval signedInterval)`
`protected Temporal`	`minus(Temporal temporal, long amountToSubtract, TemporalUnit unit)`
`static SignedInterval`	`of(long days, long hours, long minutes)`
`static SignedInterval`	`of(long months, long days, long hours, long minutes)`
`static SignedInterval`	`of(long years, long months, long days, long hours, long minutes)`
`static SignedInterval`	`of(long years, long months, long days, long hours, long minutes, long seconds)`
`static SignedInterval`	`of(long years, long months, long days, long hours, long minutes, long seconds, long millis)`
`static SignedInterval`	`of(long centuries, long years, long months, long days, long hours, long minutes, long seconds, long millis)`
`static SignedInterval`	`of(long centuries, long years, long months, long days, long hours, long minutes, long seconds, long millis, long micros, long nanos)`
`static SignedInterval`	`of(long amount, TemporalUnit unit)`
`static SignedInterval`	`ofCenturies(long centuries)`
`static SignedInterval`	`ofDays(long days)`
`static SignedInterval`	`ofHours(long hours)`
`static SignedInterval`	`ofMicros(long micros)`
`static SignedInterval`	`ofMillis(long millis)`
`static SignedInterval`	`ofMinutes(long minutes)`
`static SignedInterval`	`ofMonths(long months)`
`static SignedInterval`	`ofNanos(long nanos)`
`static SignedInterval`	`ofSeconds(long seconds)`
`static SignedInterval`	`ofYears(long years)`
`SignedInterval`	`plus(long amount, TemporalUnit unit)`
`SignedInterval`	`plus(SignedInterval signedInterval)`
`protected Temporal`	`plus(Temporal temporal, long amountToAdd, TemporalUnit unit)`
`protected long[]`	`standardizingTime(BigInteger totalNanos)`	将总纳秒数转化成标准的时-分-秒-毫秒-微秒-纳秒
`Temporal`	`subtractFrom(Temporal temporal)`
`long`	`toDays()`
`String`	`toFullString()`
`long`	`toHours()`
`BigInteger`	`toMicros()`
`protected BigInteger`	`toMicros(long amount, ChronoUnit chronoUnit)`	将某个时间类型转为微秒
`long`	`toMillis()`
`long`	`toMinutes()`
`long`	`toMonths()`
`BigInteger`	`toNanos()`
`protected BigInteger`	`toNanos(long amount, ChronoUnit chronoUnit)`	将某个时间类型转为纳秒
`long`	`toSeconds()`
`String`	`toSimpleString()`
`String`	`toString()`
`long`	`toWeeks()`
`long`	`toYears()`

从接口继承的方法 com.iofairy.falcon.time.ChronoInterval
addTo, addTo, addTo, minusFrom, plusTo, subtractFrom, subtractFrom, subtractFrom

从类继承的方法 java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细资料

serialVersionUID
```
private static final long serialVersionUID
```
另请参阅:

常量字段值

centuries
```
public final long centuries
```
世纪（100年）

另请参阅:

ChronoUnit.CENTURIES

years
```
public final long years
```
年

另请参阅:

ChronoUnit.YEARS

months
```
public final long months
```
月

另请参阅:

ChronoUnit.MONTHS

days
```
public final long days
```
日

另请参阅:

ChronoUnit.DAYS

hours
```
public final long hours
```
时

另请参阅:

ChronoUnit.HOURS

minutes
```
public final long minutes
```
分

另请参阅:

ChronoUnit.MINUTES

seconds
```
public final long seconds
```
秒

另请参阅:

ChronoUnit.SECONDS

millis
```
public final long millis
```
毫秒

另请参阅:

ChronoUnit.MILLIS

micros
```
public final long micros
```
微秒

另请参阅:

ChronoUnit.MICROS

nanos
```
public final long nanos
```
纳秒

另请参阅:

ChronoUnit.NANOS

totalYears
```
protected long totalYears
```

totalMonths
```
protected long totalMonths
```

totalWeeks
```
protected long totalWeeks
```

totalDays
```
protected long totalDays
```

totalHours
```
protected long totalHours
```

totalMinutes
```
protected long totalMinutes
```

totalSeconds
```
protected long totalSeconds
```

totalMillis
```
protected long totalMillis
```

totalMicros
```
protected BigInteger totalMicros
```

totalNanos
```
protected BigInteger totalNanos
```

startTime
```
protected Temporal startTime
```

endTime
```
protected Temporal endTime
```

ZERO

public static final SignedInterval ZERO

SUPPORTED_UNITS

private static final List<TemporalUnit> SUPPORTED_UNITS

SUPPORTED_TEMPORAL

public static final List<Class<? extends Temporal>> SUPPORTED_TEMPORAL

between(Temporal, Temporal)支持的temporal类型

SUPPORTED_TEMPORAL_STRING

protected static final String SUPPORTED_TEMPORAL_STRING

构造器详细资料

SignedInterval

public SignedInterval(long centuries,
                      long years,
                      long months,
                      long days,
                      long hours,
                      long minutes,
                      long seconds,
                      long millis,
                      long micros,
                      long nanos)

SignedInterval

public SignedInterval(long centuries,
                      long years,
                      long months,
                      long days,
                      long hours,
                      long minutes,
                      long seconds,
                      long millis)

SignedInterval

public SignedInterval(long years,
                      long months,
                      long days,
                      long hours,
                      long minutes,
                      long seconds,
                      long millis)

SignedInterval

public SignedInterval(long years,
                      long months,
                      long days,
                      long hours,
                      long minutes,
                      long seconds)

SignedInterval

public SignedInterval(long years,
                      long months,
                      long days,
                      long hours,
                      long minutes)

SignedInterval

public SignedInterval(long months,
                      long days,
                      long hours,
                      long minutes)

SignedInterval

public SignedInterval(long days,
                      long hours,
                      long minutes)

方法详细资料

of

public static SignedInterval of(long centuries,
                                long years,
                                long months,
                                long days,
                                long hours,
                                long minutes,
                                long seconds,
                                long millis,
                                long micros,
                                long nanos)

of

public static SignedInterval of(long centuries,
                                long years,
                                long months,
                                long days,
                                long hours,
                                long minutes,
                                long seconds,
                                long millis)

of

public static SignedInterval of(long years,
                                long months,
                                long days,
                                long hours,
                                long minutes,
                                long seconds,
                                long millis)

of

public static SignedInterval of(long years,
                                long months,
                                long days,
                                long hours,
                                long minutes,
                                long seconds)

of

public static SignedInterval of(long years,
                                long months,
                                long days,
                                long hours,
                                long minutes)

of

public static SignedInterval of(long months,
                                long days,
                                long hours,
                                long minutes)

of

public static SignedInterval of(long days,
                                long hours,
                                long minutes)

of

public static SignedInterval of(long amount,
                                TemporalUnit unit)

ofCenturies

public static SignedInterval ofCenturies(long centuries)

ofYears

public static SignedInterval ofYears(long years)

ofMonths

public static SignedInterval ofMonths(long months)

ofDays

public static SignedInterval ofDays(long days)

ofHours

public static SignedInterval ofHours(long hours)

ofMinutes

public static SignedInterval ofMinutes(long minutes)

ofSeconds

public static SignedInterval ofSeconds(long seconds)

ofMillis

public static SignedInterval ofMillis(long millis)

ofMicros

public static SignedInterval ofMicros(long micros)

ofNanos

public static SignedInterval ofNanos(long nanos)

plus

public SignedInterval plus(SignedInterval signedInterval)

plus

public SignedInterval plus(long amount,
                           TemporalUnit unit)

minus

public SignedInterval minus(SignedInterval signedInterval)

minus

public SignedInterval minus(long amount,
                            TemporalUnit unit)

between
```
public static SignedInterval between(Temporal startTemporal,
                                     Temporal endTemporal)
```
Obtain two Temporal datetime interval. It is recommended to call isSupported(Temporal) to check if the specified temporal is supported first.
获取两个Temporal的时间间隔。建议在调用此方法之前先确认是否支持该时间类型 isSupported(Temporal)。

参数:

startTemporal - start Temporal. If startTemporal is instance of Instant, it will convert to ZonedDateTime with TZ.DEFAULT_ZONE

endTemporal - end Temporal. If endTemporal is instance of Instant, it will convert to ZonedDateTime with TZ.DEFAULT_ZONE

返回:

SignedInterval

between

public static SignedInterval between(Date startDate,
                                     Date endDate)

Obtain two Date datetime interval.
获取两个Date的时间间隔。

参数:: startDate - start Date; endDate - end Date
返回:: SignedInterval

between

public static SignedInterval between(Calendar startCalendar,
                                     Calendar endCalendar)

Obtain two Calendar datetime interval.
获取两个Calendar的时间间隔。

参数:: startCalendar - start Calendar; endCalendar - end Calendar
返回:: SignedInterval

between
```
public static SignedInterval between(DateTime<?> startDateTime,
                                     DateTime<?> endDateTime)
```
Obtain two DateTime interval.
获取两个DateTime的时间间隔。

参数:

startDateTime - start DateTime

endDateTime - end DateTime

返回:

SignedInterval

从以下版本开始:

0.3.0

isSupported
```
public static boolean isSupported(Temporal temporal)
```
Checks if the specified temporal is supported.

参数:

temporal - temporal

返回:

true if the temporal can be added/subtracted, false if not

get

public long get(TemporalUnit unit)

指定者:: get 在接口中 TemporalAmount

getUnits
```
public List<TemporalUnit> getUnits()
```
指定者:

getUnits 在接口中 TemporalAmount

addTo

public Temporal addTo(Temporal temporal)

指定者:: addTo 在接口中 TemporalAmount

plus

protected Temporal plus(Temporal temporal,
                        long amountToAdd,
                        TemporalUnit unit)

subtractFrom
```
public Temporal subtractFrom(Temporal temporal)
```
指定者:

subtractFrom 在接口中 TemporalAmount

minus

protected Temporal minus(Temporal temporal,
                         long amountToSubtract,
                         TemporalUnit unit)

toYears
```
public long toYears()
```

toMonths
```
public long toMonths()
```

toWeeks
```
public long toWeeks()
```

toDays
```
public long toDays()
```

toHours
```
public long toHours()
```

toMinutes
```
public long toMinutes()
```

toSeconds
```
public long toSeconds()
```

toMillis
```
public long toMillis()
```

toMicros
```
public BigInteger toMicros()
```

toNanos
```
public BigInteger toNanos()
```

getStartTime
```
public Temporal getStartTime()
```

getEndTime
```
public Temporal getEndTime()
```

equals

public boolean equals(Object baseInterval)

覆盖:: equals 在类中 Object

compareTo
```
public int compareTo(SignedInterval other)
```
指定者:

compareTo 在接口中 Comparable<SignedInterval>

toFullString
```
public String toFullString()
```

toString
```
public String toString()
```
覆盖:

toString 在类中 Object

toSimpleString
```
public String toSimpleString()
```

standardizingTime
```
protected long[] standardizingTime(BigInteger totalNanos)
```
将总纳秒数转化成标准的 时-分-秒-毫秒-微秒-纳秒

参数:

totalNanos - 总纳秒数

返回:

时-分-秒-毫秒-微秒-纳秒

从以下版本开始:

0.3.0

toMicros

protected BigInteger toMicros(long amount,
                              ChronoUnit chronoUnit)

将某个时间类型转为微秒

参数:: amount - 时间量; chronoUnit - 时间单位
返回:: 总微秒数
从以下版本开始:: 0.3.0

toNanos

protected BigInteger toNanos(long amount,
                             ChronoUnit chronoUnit)

将某个时间类型转为纳秒

参数:: amount - 时间量; chronoUnit - 时间单位
返回:: 总纳秒数
从以下版本开始:: 0.3.0

类 SignedInterval

字段概要

构造器概要

方法概要

从接口继承的方法 com.iofairy.falcon.time.ChronoInterval

从类继承的方法 java.lang.Object

字段详细资料

serialVersionUID

centuries

years

months

days

hours

minutes

seconds

millis

micros

nanos

totalYears

totalMonths

totalWeeks

totalDays

totalHours

totalMinutes

totalSeconds

totalMillis

totalMicros

totalNanos

startTime

endTime

ZERO

SUPPORTED_UNITS

SUPPORTED_TEMPORAL

SUPPORTED_TEMPORAL_STRING

构造器详细资料

SignedInterval

SignedInterval

SignedInterval

SignedInterval

SignedInterval

SignedInterval

SignedInterval

方法详细资料

of

of

of

of

of

of

of

of

ofCenturies

ofYears

ofMonths

ofDays

ofHours

ofMinutes

ofSeconds

ofMillis

ofMicros

ofNanos

plus

plus

minus

minus

between

between

between

between

isSupported

get

getUnits

addTo

plus

subtractFrom

minus

toYears

toMonths

toWeeks

toDays