Conversion<java.lang.String,T>
, FormattedConversion<java.text.SimpleDateFormat>
public class DateConversion extends ObjectConversion<java.util.Date> implements FormattedConversion<java.text.SimpleDateFormat>
Date
and vice versa.
This class supports multiple date formats. For example, you can define conversions from dates represented by different Strings such as "2001/05/02 and Dec/2013".
The reverse conversion from a Date to String (in revert(Date)
will return a formatted String using the date pattern provided in this class constructor
The date patterns must follows the pattern rules of SimpleDateFormat
SimpleDateFormat
Constructor | Description |
---|---|
DateConversion(java.lang.String... dateFormats) |
Defines a conversion from String to
Date using a sequence of acceptable date patterns. |
DateConversion(java.util.Date valueIfStringIsNull,
java.lang.String valueIfObjectIsNull,
java.lang.String... dateFormats) |
Defines a conversion from String to
Date using a sequence of acceptable date patterns. |
Modifier and Type | Method | Description |
---|---|---|
protected java.util.Date |
fromString(java.lang.String input) |
Converts a formatted date String to an instance of Date.
|
java.text.SimpleDateFormat[] |
getFormatterObjects() |
Returns the formatter objects
|
java.lang.String |
revert(java.util.Date input) |
Converts Date to a formatted date String.
|
getValueOnNullInput, getValueOnNullOutput, setValueOnNullInput, setValueOnNullOutput
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
execute, fromInput, getValueIfObjectIsNull, getValueIfStringIsNull, setValueIfObjectIsNull, setValueIfStringIsNull, undo
public DateConversion(java.util.Date valueIfStringIsNull, java.lang.String valueIfObjectIsNull, java.lang.String... dateFormats)
Date
using a sequence of acceptable date patterns.
This constructor assumes the output of a conversion should be null when input is nullvalueIfStringIsNull
- default Date value to be returned when the input String is null. Used when ObjectConversion.execute(String)
is invoked.valueIfObjectIsNull
- default String value to be returned when a Date input is null. Used when revert(Date)
is invoked.dateFormats
- list of acceptable date patterns The first pattern in this sequence will be used to convert a Date into a String in revert(Date)
.public DateConversion(java.lang.String... dateFormats)
Date
using a sequence of acceptable date patterns.
This constructor assumes the output of a conversion should be null when input is nulldateFormats
- list of acceptable date patterns The first pattern in this sequence will be used to convert a Date into a String in revert(Date)
.public java.lang.String revert(java.util.Date input)
The pattern used to generate the formatted date is the first date pattern provided in the constructor of this class
revert
in interface Conversion<java.lang.String,T>
revert
in class ObjectConversion<java.util.Date>
input
- the Date to be converted to a StringvalueIfObjectIsNull
if the Date parameter is null.protected java.util.Date fromString(java.lang.String input)
The pattern in the formatted date must match one of the date patterns provided in the constructor of this class.
fromString
in class ObjectConversion<java.util.Date>
input
- the String containing a formatted date which must be converted to a DatevalueIfObjectIsNull
if the String input is null.public java.text.SimpleDateFormat[] getFormatterObjects()
FormattedConversion
getFormatterObjects
in interface FormattedConversion<java.text.SimpleDateFormat>