org.joda.time.convert
Interface PartialConverter

All Superinterfaces:

Converter

public interface PartialConverter

extends Converter

PartialConverter defines how an object is converted to a ReadablePartial.

The two methods in this interface must be called in order, as the getPartialValues method relies on the result of the getChronology method being passed in.

Since:

1.0

Author:

Stephen Colebourne

Method Summary

Chronology	getChronology(Object object, Chronology chrono) Extracts the chronology from an object of this converter's type where the chronology is specified.
int[]	getPartialValues(ReadablePartial fieldSource, Object object, Chronology chrono) Extracts the values of the partial from an object of this converter's type.

Methods inherited from interface org.joda.time.convert.Converter

getSupportedType

Method Detail

getChronology

public Chronology getChronology(Object object,
                                Chronology chrono)

Extracts the chronology from an object of this converter's type where the chronology is specified.

Parameters:

object - the object to convert

chrono - the chronology to use, null usually means ISO

Returns:

the chronology, not converted to UTC/local time zone, must be non-null valid

Throws:

ClassCastException - if the object is invalid

getPartialValues

public int[] getPartialValues(ReadablePartial fieldSource,
                              Object object,
                              Chronology chrono)

Extracts the values of the partial from an object of this converter's type. The chrono parameter is a hint to the converter, should it require a chronology to aid in conversion.

Parameters:

fieldSource - a partial that provides access to the fields. This partial may be incomplete and only getFieldType(int) should be used

object - the object to convert

chrono - the chronology to use, which is the non-null result of getChronology()

Returns:

the array of field values that match the fieldSource, must be non-null valid

Throws:

ClassCastException - if the object is invalid