com.jn.langx.util.jodatime.field

类 PreciseDateTimeField

java.lang.Object

com.jn.langx.util.jodatime.DateTimeField

com.jn.langx.util.jodatime.field.BaseDateTimeField

com.jn.langx.util.jodatime.field.PreciseDurationDateTimeField

com.jn.langx.util.jodatime.field.PreciseDateTimeField

public class PreciseDateTimeField
extends PreciseDurationDateTimeField

Precise datetime field, composed of two precise duration fields.

This DateTimeField is useful for defining DateTimeFields that are composed of precise durations, like time of day fields. If either duration field is imprecise, then an ImpreciseDateTimeField may be used instead.

PreciseDateTimeField is thread-safe and immutable.

从以下版本开始:

1.0

作者:

Brian S O'Neill, Stephen Colebourne

另请参阅:

ImpreciseDateTimeField

构造器概要

构造器

构造器和说明
PreciseDateTimeField(DateTimeFieldType type, DurationField unit, DurationField range) Constructor.

方法概要

限定符和类型	方法和说明
long	addWrapField(long instant, int amount) Add to the component of the specified time instant, wrapping around within that component if necessary.
int	get(long instant) Get the amount of fractional units from the specified time instant.
int	getMaximumValue() Get the maximum value for the field.
int	getRange() Returns the range of the field in the field's units.
DurationField	getRangeDurationField() Returns the range duration of this field.
long	set(long instant, int value) Set the specified amount of units to the specified time instant.

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

getDurationField, getMaximumValueForSet, getMinimumValue, getUnitMillis, isLenient, remainder, roundCeiling, roundFloor

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

add, add, add, addWrapField, addWrapPartial, convertText, getAsShortText, getAsShortText, getAsShortText, getAsShortText, getAsShortText, getAsText, getAsText, getAsText, getAsText, getAsText, getDifference, getDifferenceAsLong, getLeapAmount, getLeapDurationField, getMaximumShortTextLength, getMaximumTextLength, getMaximumValue, getMaximumValue, getMaximumValue, getMinimumValue, getMinimumValue, getMinimumValue, getName, getType, isLeap, isSupported, roundHalfCeiling, roundHalfEven, roundHalfFloor, set, set, set, set, toString

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

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

构造器详细资料

PreciseDateTimeField

public PreciseDateTimeField(DateTimeFieldType type,
                            DurationField unit,
                            DurationField range)

Constructor.

参数:

type - the field type this field uses

unit - precise unit duration, like "seconds()".

range - precise range duration, preferably a multiple of the unit, like "minutes()".

抛出:

IllegalArgumentException - if either duration field is imprecise

IllegalArgumentException - if unit milliseconds is less than one or effective value range is less than two.

方法详细资料

get

public int get(long instant)

Get the amount of fractional units from the specified time instant.

指定者:

get 在类中 BaseDateTimeField

参数:

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

返回:

the amount of fractional units extracted from the input.

addWrapField

public long addWrapField(long instant,
                         int amount)

Add to the component of the specified time instant, wrapping around within that component if necessary.

覆盖:

addWrapField 在类中 BaseDateTimeField

参数:

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

amount - the amount of units to add (can be negative).

返回:

the updated time instant.

set

public long set(long instant,
                int value)

Set the specified amount of units to the specified time instant.

覆盖:

set 在类中 PreciseDurationDateTimeField

参数:

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

value - value of units to set.

返回:

the updated time instant.

抛出:

IllegalArgumentException - if value is too large or too small.

getRangeDurationField

public DurationField getRangeDurationField()

Returns the range duration of this field. For example, if this field represents "minute of hour", then the range duration field is an hours.

指定者:

getRangeDurationField 在类中 BaseDateTimeField

返回:

the range duration of this field, or null if field has no range

getMaximumValue

public int getMaximumValue()

Get the maximum value for the field.

指定者:

getMaximumValue 在类中 BaseDateTimeField

返回:

the maximum value

getRange

public int getRange()

Returns the range of the field in the field's units.

For example, 60 for seconds per minute. The field is allowed values from 0 to range - 1.

返回:

unit range