com.jn.langx.util.jodatime.field

类 DecoratedDurationField

java.lang.Object

com.jn.langx.util.jodatime.DurationField

com.jn.langx.util.jodatime.field.BaseDurationField

com.jn.langx.util.jodatime.field.DecoratedDurationField

所有已实现的接口:

Serializable, Comparable<DurationField>

直接已知子类:

ScaledDurationField

public class DecoratedDurationField
extends BaseDurationField

DecoratedDurationField extends BaseDurationField, implementing only the minimum required set of methods. These implemented methods delegate to a wrapped field.

This design allows new DurationField types to be defined that piggyback on top of another, inheriting all the safe method implementations from BaseDurationField. Should any method require pure delegation to the wrapped field, simply override and use the provided getWrappedField method.

DecoratedDurationField is thread-safe and immutable, and its subclasses must be as well.

从以下版本开始:

1.0

作者:

Brian S O'Neill

另请参阅:

DelegatedDurationField, 序列化表格

构造器概要

构造器

构造器和说明
DecoratedDurationField(DurationField field, DurationFieldType type) Constructor.

方法概要

限定符和类型	方法和说明
long	add(long instant, int value) Adds a duration value (which may be negative) to the instant.
long	add(long instant, long value) Adds a duration value (which may be negative) to the instant.
long	getDifferenceAsLong(long minuendInstant, long subtrahendInstant) Computes the difference between two instants, as measured in the units of this field.
long	getMillis(int value, long instant) Get the millisecond duration of this field from its value relative to an instant.
long	getMillis(long value, long instant) Get the millisecond duration of this field from its value relative to an instant.
long	getUnitMillis() Returns the amount of milliseconds per unit value of this field.
long	getValueAsLong(long duration, long instant) Get the value of this field from the milliseconds relative to an instant.
DurationField	getWrappedField() Gets the wrapped duration field.
boolean	isPrecise() Is this field precise.

从类继承的方法 com.jn.langx.util.jodatime.field.BaseDurationField

compareTo, getDifference, getMillis, getMillis, getName, getType, getValue, getValue, getValueAsLong, isSupported, toString

从类继承的方法 com.jn.langx.util.jodatime.DurationField

subtract, subtract

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造器详细资料

DecoratedDurationField

public DecoratedDurationField(DurationField field,
                              DurationFieldType type)

Constructor.

参数:

field - the base field

type - the type to actually use

方法详细资料

getWrappedField

public final DurationField getWrappedField()

Gets the wrapped duration field.

返回:

the wrapped DurationField

isPrecise

public boolean isPrecise()

从类复制的说明: DurationField

Is this field precise. A precise field can calculate its value from milliseconds without needing a reference date. Put another way, a precise field's unit size is not variable.

指定者:

isPrecise 在类中 DurationField

返回:

true if precise

另请参阅:

DurationField.getUnitMillis()

getValueAsLong

public long getValueAsLong(long duration,
                           long instant)

从类复制的说明: DurationField

Get the value of this field from the milliseconds relative to an instant. For precise fields this method produces the same result as for the single argument get method.

If the millisecond duration is positive, then the instant is treated as a "start instant". If negative, the instant is treated as an "end instant".

指定者:

getValueAsLong 在类中 DurationField

参数:

duration - the milliseconds to query, which may be negative

instant - the start instant to calculate relative to

返回:

the value of the field, in the units of the field, which may be negative

getMillis

public long getMillis(int value,
                      long instant)

从类复制的说明: DurationField

Get the millisecond duration of this field from its value relative to an instant. For precise fields this method produces the same result as for the single argument getMillis method.

If the value is positive, then the instant is treated as a "start instant". If negative, the instant is treated as an "end instant".

指定者:

getMillis 在类中 DurationField

参数:

value - the value of the field, which may be negative

instant - the instant to calculate relative to

返回:

the millisecond duration that the field represents, which may be negative

getMillis

public long getMillis(long value,
                      long instant)

从类复制的说明: DurationField

Get the millisecond duration of this field from its value relative to an instant. For precise fields this method produces the same result as for the single argument getMillis method.

If the value is positive, then the instant is treated as a "start instant". If negative, the instant is treated as an "end instant".

指定者:

getMillis 在类中 DurationField

参数:

value - the value of the field, which may be negative

instant - the instant to calculate relative to

返回:

the millisecond duration that the field represents, which may be negative

add

public long add(long instant,
                int value)

从类复制的说明: DurationField

Adds a duration value (which may be negative) to the instant.

指定者:

add 在类中 DurationField

参数:

instant - the milliseconds from 1970-01-01T00:00:00Z to add to

value - the value to add, in the units of the field

返回:

the updated milliseconds

add

public long add(long instant,
                long value)

从类复制的说明: DurationField

Adds a duration value (which may be negative) to the instant.

指定者:

add 在类中 DurationField

参数:

instant - the milliseconds from 1970-01-01T00:00:00Z to add to

value - the value to add, in the units of the field

返回:

the updated milliseconds

getDifferenceAsLong

public long getDifferenceAsLong(long minuendInstant,
                                long subtrahendInstant)

从类复制的说明: DurationField

Computes the difference between two instants, as measured in the units of this field. Any fractional units are dropped from the result. Calling getDifference reverses the effect of calling add. In the following code:

 long instant = ...
 long v = ...
 long age = getDifferenceAsLong(add(instant, v), instant);
 

The value 'age' is the same as the value 'v'.

指定者:

getDifferenceAsLong 在类中 DurationField

参数:

minuendInstant - the milliseconds from 1970-01-01T00:00:00Z to subtract from

subtrahendInstant - the milliseconds from 1970-01-01T00:00:00Z to subtract off the minuend

返回:

the difference in the units of this field

getUnitMillis

public long getUnitMillis()

从类复制的说明: DurationField

Returns the amount of milliseconds per unit value of this field. For example, if this field represents "seconds", then this returns the milliseconds in one second.

For imprecise fields, the unit size is variable, and so this method returns a suitable average value.

指定者:

getUnitMillis 在类中 DurationField

返回:

the unit size of this field, in milliseconds

另请参阅:

DurationField.isPrecise()