Summary: Methods | Inherited Methods | [Expand All]

public final class

UnsupportedDateTimeField

extends DateTimeField
implements Serializable

java.lang.Object
↳	org.joda.time.DateTimeField
	↳	org.joda.time.field.UnsupportedDateTimeField

Class Overview

A placeholder implementation to use when a datetime field is not supported.

UnsupportedDateTimeField is thread-safe and immutable.

Summary

Public Methods
int[]	add(ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd) Always throws UnsupportedOperationException
long	add(long instant, long value) Delegates to the duration field.
long	add(long instant, int value) Delegates to the duration field.
long	addWrapField(long instant, int value) Always throws UnsupportedOperationException
int[]	addWrapField(ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd) Always throws UnsupportedOperationException
int[]	addWrapPartial(ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd) Always throws UnsupportedOperationException
int	get(long instant) Always throws UnsupportedOperationException
String	getAsShortText(ReadablePartial partial, int fieldValue, Locale locale) Always throws UnsupportedOperationException
String	getAsShortText(int fieldValue, Locale locale) Always throws UnsupportedOperationException
String	getAsShortText(ReadablePartial partial, Locale locale) Always throws UnsupportedOperationException
String	getAsShortText(long instant) Always throws UnsupportedOperationException
String	getAsShortText(long instant, Locale locale) Always throws UnsupportedOperationException
String	getAsText(ReadablePartial partial, Locale locale) Always throws UnsupportedOperationException
String	getAsText(int fieldValue, Locale locale) Always throws UnsupportedOperationException
String	getAsText(long instant, Locale locale) Always throws UnsupportedOperationException
String	getAsText(long instant) Always throws UnsupportedOperationException
String	getAsText(ReadablePartial partial, int fieldValue, Locale locale) Always throws UnsupportedOperationException
int	getDifference(long minuendInstant, long subtrahendInstant) Delegates to the duration field.
long	getDifferenceAsLong(long minuendInstant, long subtrahendInstant) Delegates to the duration field.
DurationField	getDurationField() Even though this DateTimeField is unsupported, the duration field might be supported.
synchronized static UnsupportedDateTimeField	getInstance(DateTimeFieldType type, DurationField durationField) Gets an instance of UnsupportedDateTimeField for a specific named field.
int	getLeapAmount(long instant) Always throws UnsupportedOperationException
DurationField	getLeapDurationField() Always returns null.
int	getMaximumShortTextLength(Locale locale) Always throws UnsupportedOperationException
int	getMaximumTextLength(Locale locale) Always throws UnsupportedOperationException
int	getMaximumValue(long instant) Always throws UnsupportedOperationException
int	getMaximumValue(ReadablePartial instant) Always throws UnsupportedOperationException
int	getMaximumValue() Always throws UnsupportedOperationException
int	getMaximumValue(ReadablePartial instant, int[] values) Always throws UnsupportedOperationException
int	getMinimumValue(ReadablePartial instant) Always throws UnsupportedOperationException
int	getMinimumValue(ReadablePartial instant, int[] values) Always throws UnsupportedOperationException
int	getMinimumValue(long instant) Always throws UnsupportedOperationException
int	getMinimumValue() Always throws UnsupportedOperationException
String	getName() Get the name of the field.
DurationField	getRangeDurationField() Always returns null.
DateTimeFieldType	getType() Get the type of the field.
boolean	isLeap(long instant) Always throws UnsupportedOperationException
boolean	isLenient() This field is not lenient.
boolean	isSupported() This field is not supported.
long	remainder(long instant) Always throws UnsupportedOperationException
long	roundCeiling(long instant) Always throws UnsupportedOperationException
long	roundFloor(long instant) Always throws UnsupportedOperationException
long	roundHalfCeiling(long instant) Always throws UnsupportedOperationException
long	roundHalfEven(long instant) Always throws UnsupportedOperationException
long	roundHalfFloor(long instant) Always throws UnsupportedOperationException
long	set(long instant, String text, Locale locale) Always throws UnsupportedOperationException
int[]	set(ReadablePartial instant, int fieldIndex, int[] values, int newValue) Always throws UnsupportedOperationException
int[]	set(ReadablePartial instant, int fieldIndex, int[] values, String text, Locale locale) Always throws UnsupportedOperationException
long	set(long instant, int value) Always throws UnsupportedOperationException
long	set(long instant, String text) Always throws UnsupportedOperationException
String	toString() Get a suitable debug string.

[Expand]

Inherited Methods

From class org.joda.time.DateTimeField

abstract int[]	add(ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd) Adds a value (which may be negative) to the partial instant, throwing an exception if the maximum size of the instant is reached.
abstract long	add(long instant, long value) Adds a value (which may be negative) to the millis value, overflowing into larger fields if necessary.
abstract long	add(long instant, int value) Adds a value (which may be negative) to the millis value, overflowing into larger fields if necessary.
abstract long	addWrapField(long instant, int value) Adds a value (which may be negative) to the millis value, wrapping within this field.
abstract int[]	addWrapField(ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd) Adds a value (which may be negative) to the partial instant, wrapping within this field.
abstract int[]	addWrapPartial(ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd) Adds a value (which may be negative) to the partial instant, wrapping the whole partial if the maximum size of the partial is reached.
abstract int	get(long instant) Get the value of this field from the milliseconds.
abstract String	getAsShortText(ReadablePartial partial, int fieldValue, Locale locale) Get the human-readable, short text value of this field from a partial instant.
abstract String	getAsShortText(int fieldValue, Locale locale) Get the human-readable, short text value of this field from the field value.
abstract String	getAsShortText(ReadablePartial partial, Locale locale) Get the human-readable, short text value of this field from a partial instant.
abstract String	getAsShortText(long instant) Get the human-readable, short text value of this field from the milliseconds.
abstract String	getAsShortText(long instant, Locale locale) Get the human-readable, short text value of this field from the milliseconds.
abstract String	getAsText(ReadablePartial partial, Locale locale) Get the human-readable, text value of this field from a partial instant.
abstract String	getAsText(int fieldValue, Locale locale) Get the human-readable, text value of this field from the field value.
abstract String	getAsText(long instant, Locale locale) Get the human-readable, text value of this field from the milliseconds.
abstract String	getAsText(long instant) Get the human-readable, text value of this field from the milliseconds.
abstract String	getAsText(ReadablePartial partial, int fieldValue, Locale locale) Get the human-readable, text value of this field from a partial instant.
abstract int	getDifference(long minuendInstant, long subtrahendInstant) Computes the difference between two instants, as measured in the units of this field.
abstract long	getDifferenceAsLong(long minuendInstant, long subtrahendInstant) Computes the difference between two instants, as measured in the units of this field.
abstract DurationField	getDurationField() Returns the duration per unit value of this field.
abstract int	getLeapAmount(long instant) Gets the amount by which this field is 'leap' for the specified instant.
abstract DurationField	getLeapDurationField() If this field were to leap, then it would be in units described by the returned duration.
abstract int	getMaximumShortTextLength(Locale locale) Get the maximum short text value for this field.
abstract int	getMaximumTextLength(Locale locale) Get the maximum text value for this field.
abstract int	getMaximumValue(long instant) Get the maximum value for this field evaluated at the specified time.
abstract int	getMaximumValue(ReadablePartial instant) Get the maximum value for this field evaluated at the specified time.
abstract int	getMaximumValue() Get the maximum allowable value for this field.
abstract int	getMaximumValue(ReadablePartial instant, int[] values) Get the maximum value for this field using the partial instant and the specified values.
abstract int	getMinimumValue(ReadablePartial instant) Get the minimum value for this field evaluated at the specified time.
abstract int	getMinimumValue(ReadablePartial instant, int[] values) Get the minimum value for this field using the partial instant and the specified values.
abstract int	getMinimumValue(long instant) Get the minimum value for this field evaluated at the specified time.
abstract int	getMinimumValue() Get the minimum allowable value for this field.
abstract String	getName() Get the name of the field.
abstract DurationField	getRangeDurationField() Returns the range duration of this field.
abstract DateTimeFieldType	getType() Get the type of the field.
abstract boolean	isLeap(long instant) Returns whether this field is 'leap' for the specified instant.
abstract boolean	isLenient() Returns true if the set method is lenient.
abstract boolean	isSupported() Returns true if this field is supported.
abstract long	remainder(long instant) Returns the fractional duration milliseconds of this field.
abstract long	roundCeiling(long instant) Round to the highest whole unit of this field.
abstract long	roundFloor(long instant) Round to the lowest whole unit of this field.
abstract long	roundHalfCeiling(long instant) Round to the nearest whole unit of this field.
abstract long	roundHalfEven(long instant) Round to the nearest whole unit of this field.
abstract long	roundHalfFloor(long instant) Round to the nearest whole unit of this field.
abstract long	set(long instant, String text, Locale locale) Sets a value in the milliseconds supplied from a human-readable, text value.
abstract int[]	set(ReadablePartial instant, int fieldIndex, int[] values, int newValue) Sets a value using the specified partial instant.
abstract int[]	set(ReadablePartial instant, int fieldIndex, int[] values, String text, Locale locale) Sets a value in the milliseconds supplied from a human-readable, text value.
abstract long	set(long instant, int value) Sets a value in the milliseconds supplied.
abstract long	set(long instant, String text) Sets a value in the milliseconds supplied from a human-readable, text value.
abstract String	toString() Get a suitable debug string.

From class java.lang.Object

Public Methods

public int[] add (ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd)

Always throws UnsupportedOperationException

Parameters

instant	the partial instant
fieldIndex	the index of this field in the instant
values	the values of the partial instant which should be updated
valueToAdd	the value to add, in the units of the field

Returns

the passed in values

Throws

UnsupportedOperationException

public long add (long instant, long value)

Delegates to the duration field.

Parameters

instant	the milliseconds from 1970-01-01T00:00:00Z to add to
value	the long value to add, in the units of the field

Returns

the updated milliseconds

Throws

UnsupportedOperationException	if the duration is unsupported

public long add (long instant, int value)

Delegates to the duration field.

Parameters

instant	the milliseconds from 1970-01-01T00:00:00Z to add to
value	the value to add, in the units of the field

Returns

the updated milliseconds

Throws

UnsupportedOperationException	if the duration is unsupported

public long addWrapField (long instant, int value)

Always throws UnsupportedOperationException

Parameters

instant	the milliseconds from 1970-01-01T00:00:00Z to add to
value	the value to add, in the units of the field

Returns

the updated milliseconds

Throws

UnsupportedOperationException

public int[] addWrapField (ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd)

Always throws UnsupportedOperationException

Parameters

instant	the partial instant
fieldIndex	the index of this field in the instant
values	the values of the partial instant which should be updated
valueToAdd	the value to add, in the units of the field

Returns

the passed in values

Throws

UnsupportedOperationException

public int[] addWrapPartial (ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd)

Always throws UnsupportedOperationException

Parameters

instant	the partial instant
fieldIndex	the index of this field in the partial
values	the values of the partial instant which should be updated
valueToAdd	the value to add, in the units of the field

Returns

the passed in values

Throws

UnsupportedOperationException

public int get (long instant)

Always throws UnsupportedOperationException

Parameters

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

Returns

the value of the field, in the units of the field

Throws

UnsupportedOperationException

public String getAsShortText (ReadablePartial partial, int fieldValue, Locale locale)

Always throws UnsupportedOperationException

Parameters

partial	the partial instant to query
fieldValue	the field value of this field, provided for performance
locale	the locale to use for selecting a text symbol, null for default

Returns

the text value of the field

Throws

UnsupportedOperationException

public String getAsShortText (int fieldValue, Locale locale)

Always throws UnsupportedOperationException

Parameters

fieldValue	the numeric value to convert to text
locale	the locale to use for selecting a text symbol, null for default

Returns

the text value of the field

Throws

UnsupportedOperationException

public String getAsShortText (ReadablePartial partial, Locale locale)

Always throws UnsupportedOperationException

Parameters

partial	the partial instant to query
locale	the locale to use for selecting a text symbol, null for default

Returns

the text value of the field

Throws

UnsupportedOperationException

public String getAsShortText (long instant)

Always throws UnsupportedOperationException

Parameters

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

Returns

the short text value of the field

Throws

UnsupportedOperationException

public String getAsShortText (long instant, Locale locale)

Always throws UnsupportedOperationException

Parameters

instant	the milliseconds from 1970-01-01T00:00:00Z to query
locale	the locale to use for selecting a text symbol, null for default

Returns

the short text value of the field

Throws

UnsupportedOperationException

public String getAsText (ReadablePartial partial, Locale locale)

Always throws UnsupportedOperationException

Parameters

partial	the partial instant to query
locale	the locale to use for selecting a text symbol, null for default

Returns

the text value of the field

Throws

UnsupportedOperationException

public String getAsText (int fieldValue, Locale locale)

Always throws UnsupportedOperationException

Parameters

fieldValue	the numeric value to convert to text
locale	the locale to use for selecting a text symbol, null for default

Returns

the text value of the field

Throws

UnsupportedOperationException

public String getAsText (long instant, Locale locale)

Always throws UnsupportedOperationException

Parameters

instant	the milliseconds from 1970-01-01T00:00:00Z to query
locale	the locale to use for selecting a text symbol, null for default

Returns

the text value of the field

Throws

UnsupportedOperationException

public String getAsText (long instant)

Always throws UnsupportedOperationException

Parameters

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

Returns

the text value of the field

Throws

UnsupportedOperationException

public String getAsText (ReadablePartial partial, int fieldValue, Locale locale)

Always throws UnsupportedOperationException

Parameters

partial	the partial instant to query
fieldValue	the field value of this field, provided for performance
locale	the locale to use for selecting a text symbol, null for default

Returns

the text value of the field

Throws

UnsupportedOperationException

public int getDifference (long minuendInstant, long subtrahendInstant)

Delegates to the duration field.

Parameters

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

Returns

the difference in the units of this field

Throws

UnsupportedOperationException	if the duration is unsupported

public long getDifferenceAsLong (long minuendInstant, long subtrahendInstant)

Delegates to the duration field.

Parameters

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

Returns

the difference in the units of this field

Throws

UnsupportedOperationException	if the duration is unsupported

public DurationField getDurationField ()

Even though this DateTimeField is unsupported, the duration field might be supported.

Returns

a possibly supported DurationField

public static synchronized UnsupportedDateTimeField getInstance (DateTimeFieldType type, DurationField durationField)

Gets an instance of UnsupportedDateTimeField for a specific named field. Names should be of standard format, such as 'monthOfYear' or 'hourOfDay'. The returned instance is cached.

Parameters

type	the type to obtain

Returns

the instance

Throws

IllegalArgumentException	if durationField is null

public int getLeapAmount (long instant)

Always throws UnsupportedOperationException

Parameters

instant	the instant to check for leap status

Returns

the amount, in units of the leap duration field, that the field is leap

Throws

UnsupportedOperationException

public DurationField getLeapDurationField ()

Always returns null.

Returns

null always

public int getMaximumShortTextLength (Locale locale)

Always throws UnsupportedOperationException

Parameters

locale	the locale to use for selecting a text symbol

Returns

the maximum short text length

Throws

UnsupportedOperationException

public int getMaximumTextLength (Locale locale)

Always throws UnsupportedOperationException

Parameters

locale	the locale to use for selecting a text symbol

Returns

the maximum text length

Throws

UnsupportedOperationException

public int getMaximumValue (long instant)

Always throws UnsupportedOperationException

Parameters

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

Returns

the maximum value for this field, in the units of the field

Throws

UnsupportedOperationException

public int getMaximumValue (ReadablePartial instant)

Always throws UnsupportedOperationException

Parameters

instant	the partial instant to query

Returns

the maximum value for this field, in the units of the field

Throws

UnsupportedOperationException

public int getMaximumValue ()

Always throws UnsupportedOperationException

Returns

the maximum valid value for this field, in the units of the field

Throws

UnsupportedOperationException

public int getMaximumValue (ReadablePartial instant, int[] values)

Always throws UnsupportedOperationException

Parameters

instant	the partial instant to query
values	the values to use

Returns

the maximum value for this field, in the units of the field

Throws

UnsupportedOperationException

public int getMinimumValue (ReadablePartial instant)

Always throws UnsupportedOperationException

Parameters

instant	the partial instant to query

Returns

the minimum value for this field, in the units of the field

Throws

UnsupportedOperationException

public int getMinimumValue (ReadablePartial instant, int[] values)

Always throws UnsupportedOperationException

Parameters

instant	the partial instant to query
values	the values to use

Returns

the minimum value for this field, in the units of the field

Throws

UnsupportedOperationException

public int getMinimumValue (long instant)

Always throws UnsupportedOperationException

Parameters

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

Returns

the minimum value for this field, in the units of the field

Throws

UnsupportedOperationException

public int getMinimumValue ()

Always throws UnsupportedOperationException

Returns

the minimum valid value for this field, in the units of the field

Throws

UnsupportedOperationException

public String getName ()

Get the name of the field.

By convention, names follow a pattern of "dddOfRrr", where "ddd" represents the (singular) duration unit field name and "Rrr" represents the (singular) duration range field name. If the range field is not applicable, then the name of the field is simply the (singular) duration field name.

Returns

field name

public DurationField getRangeDurationField ()

Always returns null.

Returns

null always

public DateTimeFieldType getType ()

Get the type of the field.

Returns

field type

public boolean isLeap (long instant)

Always throws UnsupportedOperationException

Parameters

instant	the instant to check for leap status

Returns

true if the field is 'leap'

Throws

UnsupportedOperationException

public boolean isLenient ()

This field is not lenient.

Returns

false always

public boolean isSupported ()

This field is not supported.

Returns

false always

public long remainder (long instant)

Always throws UnsupportedOperationException

Parameters

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

Returns

remainder duration, in milliseconds

Throws

UnsupportedOperationException

public long roundCeiling (long instant)

Always throws UnsupportedOperationException

Parameters

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

Returns

rounded milliseconds

Throws

UnsupportedOperationException

public long roundFloor (long instant)

Always throws UnsupportedOperationException

Parameters

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

Returns

rounded milliseconds

Throws

UnsupportedOperationException

public long roundHalfCeiling (long instant)

Always throws UnsupportedOperationException

Parameters

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

Returns

rounded milliseconds

Throws

UnsupportedOperationException

public long roundHalfEven (long instant)

Always throws UnsupportedOperationException

Parameters

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

Returns

rounded milliseconds

Throws

UnsupportedOperationException

public long roundHalfFloor (long instant)

Always throws UnsupportedOperationException

Parameters

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

Returns

rounded milliseconds

Throws

UnsupportedOperationException

public long set (long instant, String text, Locale locale)

Always throws UnsupportedOperationException

Parameters

instant	the milliseconds from 1970-01-01T00:00:00Z to set in
text	the text value to set
locale	the locale to use for selecting a text symbol, null for default

Returns

the updated milliseconds

Throws

UnsupportedOperationException

public int[] set (ReadablePartial instant, int fieldIndex, int[] values, int newValue)

Always throws UnsupportedOperationException

Parameters

instant	the partial instant
fieldIndex	the index of this field in the instant
values	the values of the partial instant which should be updated
newValue	the value to set, in the units of the field

Returns

the passed in values

Throws

UnsupportedOperationException

public int[] set (ReadablePartial instant, int fieldIndex, int[] values, String text, Locale locale)

Always throws UnsupportedOperationException

Parameters

instant	the partial instant
fieldIndex	the index of this field in the instant
values	the values of the partial instant which should be updated
text	the text value to set
locale	the locale to use for selecting a text symbol, null for default

Returns

the passed in values

Throws

UnsupportedOperationException

public long set (long instant, int value)

Always throws UnsupportedOperationException

Parameters

instant	the milliseconds from 1970-01-01T00:00:00Z to set in
value	the value to set, in the units of the field

Returns

the updated milliseconds

Throws

UnsupportedOperationException

public long set (long instant, String text)

Always throws UnsupportedOperationException

Parameters

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

Returns

the updated milliseconds

Throws

UnsupportedOperationException

public String toString ()

Get a suitable debug string.

Returns

debug string

Classes

UnsupportedDateTimeField

Class Overview

Summary

Public Methods

public int[] add (ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd)

Parameters

Returns

Throws

public long add (long instant, long value)

Parameters

Returns

Throws

public long add (long instant, int value)

Parameters

Returns

Throws

public long addWrapField (long instant, int value)

Parameters

Returns

Throws

public int[] addWrapField (ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd)

Parameters

Returns

Throws

public int[] addWrapPartial (ReadablePartial instant, int fieldIndex, int[] values, int valueToAdd)

Parameters

Returns

Throws

public int get (long instant)

Parameters

Returns

Throws

public String getAsShortText (ReadablePartial partial, int fieldValue, Locale locale)

Parameters

Returns

Throws

public String getAsShortText (int fieldValue, Locale locale)

Parameters

Returns

Throws

public String getAsShortText (ReadablePartial partial, Locale locale)

Parameters

Returns

Throws

public String getAsShortText (long instant)

Parameters

Returns

Throws

public String getAsShortText (long instant, Locale locale)

Parameters

Returns

Throws

public String getAsText (ReadablePartial partial, Locale locale)

Parameters

Returns

Throws

public String getAsText (int fieldValue, Locale locale)

Parameters

Returns

Throws

public String getAsText (long instant, Locale locale)

Parameters

Returns

Throws

public String getAsText (long instant)

Parameters

Returns

Throws

public String getAsText (ReadablePartial partial, int fieldValue, Locale locale)

Parameters

Returns

Throws

public int getDifference (long minuendInstant, long subtrahendInstant)

Parameters

Returns

Throws

public long getDifferenceAsLong (long minuendInstant, long subtrahendInstant)

Parameters

Returns