Class DateTimeParserBucket
- java.lang.Object
-
- org.joda.time.format.DateTimeParserBucket
-
public class DateTimeParserBucket extends java.lang.Object
DateTimeParserBucket is an advanced class, intended mainly for parser implementations. It can also be used during normal parsing operations to capture more information about the parse.This class allows fields to be saved in any order, but be physically set in a consistent order. This is useful for parsing against formats that allow field values to contradict each other.
Field values are applied in an order where the "larger" fields are set first, making their value less likely to stick. A field is larger than another when it's range duration is longer. If both ranges are the same, then the larger field has the longer duration. If it cannot be determined which field is larger, then the fields are set in the order they were saved.
For example, these fields were saved in this order: dayOfWeek, monthOfYear, dayOfMonth, dayOfYear. When computeMillis is called, the fields are set in this order: monthOfYear, dayOfYear, dayOfMonth, dayOfWeek.
DateTimeParserBucket is mutable and not thread-safe.
- Since:
- 1.0
- Author:
- Brian S O'Neill, Fredrik Borgh
-
-
Constructor Summary
Constructors Constructor Description DateTimeParserBucket(long instantLocal, Chronology chrono, java.util.Locale locale)
Constucts a bucket.DateTimeParserBucket(long instantLocal, Chronology chrono, java.util.Locale locale, java.lang.Integer pivotYear)
Constucts a bucket, with the option of specifying the pivot year for two-digit year parsing.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description long
computeMillis()
Computes the parsed datetime by setting the saved fields.long
computeMillis(boolean resetFields)
Computes the parsed datetime by setting the saved fields.long
computeMillis(boolean resetFields, java.lang.String text)
Computes the parsed datetime by setting the saved fields.Chronology
getChronology()
Gets the chronology of the bucket, which will be a local (UTC) chronology.java.util.Locale
getLocale()
Returns the locale to be used during parsing.int
getOffset()
Returns the time zone offset in milliseconds used by computeMillis, unless getZone doesn't return null.java.lang.Integer
getPivotYear()
Returns the pivot year used for parsing two-digit years.DateTimeZone
getZone()
Returns the time zone used by computeMillis, or null if an offset is used instead.boolean
restoreState(java.lang.Object savedState)
Restores the state of this bucket from a previously saved state.void
saveField(DateTimeField field, int value)
Saves a datetime field value.void
saveField(DateTimeFieldType fieldType, int value)
Saves a datetime field value.void
saveField(DateTimeFieldType fieldType, java.lang.String text, java.util.Locale locale)
Saves a datetime field text value.java.lang.Object
saveState()
Saves the state of this bucket, returning it in an opaque object.void
setOffset(int offset)
Set a time zone offset to be used when computeMillis is called, which overrides the time zone.void
setPivotYear(java.lang.Integer pivotYear)
Sets the pivot year to use when parsing two digit years.void
setZone(DateTimeZone zone)
Set a time zone to be used when computeMillis is called, which overrides any set time zone offset.
-
-
-
Constructor Detail
-
DateTimeParserBucket
public DateTimeParserBucket(long instantLocal, Chronology chrono, java.util.Locale locale)
Constucts a bucket.- Parameters:
instantLocal
- the initial millis from 1970-01-01T00:00:00, local timechrono
- the chronology to uselocale
- the locale to use
-
DateTimeParserBucket
public DateTimeParserBucket(long instantLocal, Chronology chrono, java.util.Locale locale, java.lang.Integer pivotYear)
Constucts a bucket, with the option of specifying the pivot year for two-digit year parsing.- Parameters:
instantLocal
- the initial millis from 1970-01-01T00:00:00, local timechrono
- the chronology to uselocale
- the locale to usepivotYear
- the pivot year to use when parsing two-digit years- Since:
- 1.1
-
-
Method Detail
-
getChronology
public Chronology getChronology()
Gets the chronology of the bucket, which will be a local (UTC) chronology.
-
getLocale
public java.util.Locale getLocale()
Returns the locale to be used during parsing.- Returns:
- the locale to use
-
getZone
public DateTimeZone getZone()
Returns the time zone used by computeMillis, or null if an offset is used instead.
-
setZone
public void setZone(DateTimeZone zone)
Set a time zone to be used when computeMillis is called, which overrides any set time zone offset.- Parameters:
zone
- the date time zone to operate in, or null if UTC
-
getOffset
public int getOffset()
Returns the time zone offset in milliseconds used by computeMillis, unless getZone doesn't return null.
-
setOffset
public void setOffset(int offset)
Set a time zone offset to be used when computeMillis is called, which overrides the time zone.
-
getPivotYear
public java.lang.Integer getPivotYear()
Returns the pivot year used for parsing two-digit years.If null is returned, this indicates default behaviour
- Returns:
- Integer value of the pivot year, null if not set
- Since:
- 1.1
-
setPivotYear
public void setPivotYear(java.lang.Integer pivotYear)
Sets the pivot year to use when parsing two digit years.If the value is set to null, this will indicate that default behaviour should be used.
- Parameters:
pivotYear
- the pivot year to use- Since:
- 1.1
-
saveField
public void saveField(DateTimeField field, int value)
Saves a datetime field value.- Parameters:
field
- the field, whose chronology must match that of this bucketvalue
- the value
-
saveField
public void saveField(DateTimeFieldType fieldType, int value)
Saves a datetime field value.- Parameters:
fieldType
- the field typevalue
- the value
-
saveField
public void saveField(DateTimeFieldType fieldType, java.lang.String text, java.util.Locale locale)
Saves a datetime field text value.- Parameters:
fieldType
- the field typetext
- the text valuelocale
- the locale to use
-
saveState
public java.lang.Object saveState()
Saves the state of this bucket, returning it in an opaque object. Call restoreState to undo any changes that were made since the state was saved. Calls to saveState may be nested.- Returns:
- opaque saved state, which may be passed to restoreState
-
restoreState
public boolean restoreState(java.lang.Object savedState)
Restores the state of this bucket from a previously saved state. The state object passed into this method is not consumed, and it can be used later to restore to that state again.- Parameters:
savedState
- opaque saved state, returned from saveState- Returns:
- true state object is valid and state restored
-
computeMillis
public long computeMillis()
Computes the parsed datetime by setting the saved fields. This method is idempotent, but it is not thread-safe.- Returns:
- milliseconds since 1970-01-01T00:00:00Z
- Throws:
java.lang.IllegalArgumentException
- if any field is out of range
-
computeMillis
public long computeMillis(boolean resetFields)
Computes the parsed datetime by setting the saved fields. This method is idempotent, but it is not thread-safe.- Parameters:
resetFields
- false by default, but when true, unsaved field values are cleared- Returns:
- milliseconds since 1970-01-01T00:00:00Z
- Throws:
java.lang.IllegalArgumentException
- if any field is out of range
-
computeMillis
public long computeMillis(boolean resetFields, java.lang.String text)
Computes the parsed datetime by setting the saved fields. This method is idempotent, but it is not thread-safe.- Parameters:
resetFields
- false by default, but when true, unsaved field values are clearedtext
- optional text being parsed, to be included in any error message- Returns:
- milliseconds since 1970-01-01T00:00:00Z
- Throws:
java.lang.IllegalArgumentException
- if any field is out of range- Since:
- 1.3
-
-