jidefx.utils.converter

Class DateConverter

java.lang.Object

javafx.util.StringConverter<T>

jidefx.utils.converter.DefaultObjectConverter<T>

jidefx.utils.converter.AbstractDateConverter<java.util.Date>

jidefx.utils.converter.DateConverter

All Implemented Interfaces:

ObjectConverter<java.util.Date>

public class DateConverter
extends AbstractDateConverter<java.util.Date>

ObjectConverter implementation for <code>Date</code>, <code>Calendar</code> or <code>Number</code>. All of aforementioned data types can be accepted by the toString method. For the fromString method, it will only return <code>Date</code>. Its subclasses might return Calendar or Number.

Field Summary

Fields inherited from class jidefx.utils.converter.AbstractDateConverter

CONTEXT_DATE, CONTEXT_DATETIME, CONTEXT_TIME, PROPERTY_DATE_FORMAT

Constructor Summary

Constructors

Constructor and Description
DateConverter() Creates a DateConverter.

Method Summary

Modifier and Type	Method and Description
java.util.Date	fromString(java.lang.String string, ConverterContext context) Converts from a String to a Calendar.
java.lang.String	toString(java.util.Date value, ConverterContext context) Converts the value to String.

Methods inherited from class jidefx.utils.converter.AbstractDateConverter

anyDateToString, fromStringToDate, getDefaultDateFormat, getDefaultDateTimeFormat, getDefaultTimeFormat, setDefaultDateFormat, setDefaultDateTimeFormat, setDefaultTimeFormat

Methods inherited from class jidefx.utils.converter.DefaultObjectConverter

fromString, getObjectConverterManager, toString, toStringConverter

Methods inherited from class java.lang.Object

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

Constructor Detail

DateConverter

public DateConverter()

Creates a DateConverter.

Method Detail

fromString

public java.util.Date fromString(java.lang.String string,
                                 ConverterContext context)

Converts from a String to a Calendar. It will use the DateFormat defined as AbstractDateConverter.PROPERTY_DATE_FORMAT if any. Otherwise it will try different default DateFormat according to the context (Date, Time or DateTime). At last it will try the following commonly used format patterns in order ("yyyy-mm-dd", "yy-mm-dd", "yyyymmdd", "yymmdd", "dd-MMM-yy", "dd-MMM-yyyy") until it finds a match. We do that so that users could type in other date formats and still could be recognized.

Specified by:

fromString in interface ObjectConverter<java.util.Date>

Overrides:

fromString in class DefaultObjectConverter<java.util.Date>

Parameters:

string - the string to be converted.

context - the context.

Returns:

the Calendar. If the string is null or empty, null will be returned. If the string cannot be parsed as a date, the string itself will be returned.

toString

public java.lang.String toString(java.util.Date value,
                                 ConverterContext context)

Description copied from class: DefaultObjectConverter

Converts the value to String. If the value is null, "" will be returned. Otherwise it will return value.toString().

Specified by:

toString in interface ObjectConverter<java.util.Date>

Overrides:

toString in class DefaultObjectConverter<java.util.Date>

Parameters:

value - the value to be concerted.

context - converter context to be used

Returns:

a String representation of the value.