Module org.tquadrat.foundation.util

Package org.tquadrat.foundation.util.stringconverter

Class DateLongStringConverter

java.lang.Object

org.tquadrat.foundation.util.stringconverter.DateLongStringConverter

All Implemented Interfaces:

Serializable, StringConverter<Date>

@ClassVersion(sourceVersion="$Id: DateLongStringConverter.java 1060 2023-09-24 19:21:40Z tquadrat $")
@API(status=STABLE,
     since="0.1.0")
public class DateLongStringConverter
extends Object
implements StringConverter<Date>

An implementation for the interface StringConverter for Date.

This converter translates an instance of Date into a String containing an number that represents the milliseconds since the begin of the epoch (1970-01-01T00:00:00 UTC); conversely it expects such a String to convert it to an instance of Date. This approach circumvents the issues that exists with the numerous String formats that otherwise exists for Date, especially when it comes to parsing based on different locales.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: DateLongStringConverter.java 1060 2023-09-24 19:21:40Z tquadrat $

Since:

0.0.1

See Also:

• Date(long)
• Date.getTime()
• Serialized Form

UML Diagram

⁠

UML Diagram for "org.tquadrat.foundation.util.stringconverter.DateLongStringConverter"

⁠

Field Summary

Fields

Modifier and Type	Field	Description
static final DateLongStringConverter	INSTANCE	An instance of this class.

Fields inherited from interface org.tquadrat.foundation.lang.StringConverter

METHOD_NAME_GetSubjectClass, METHOD_NAME_Provider

Constructor Summary

Constructors

Constructor	Description
DateLongStringConverter()	Creates a new instance of DateLongStringConverter.

Method Summary

Modifier and Type	Method	Description
final Date	fromString(CharSequence source)
final Collection<Class<?>>	getSubjectClass()	Provides the subject class for this converter.
final String	toString(Date source)

Methods inherited from class java.lang.Object

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

Field Details

INSTANCE

public static final DateLongStringConverter INSTANCE

An instance of this class.

Constructor Details

DateLongStringConverter

public DateLongStringConverter()

Creates a new instance of DateLongStringConverter.

Method Details

fromString

public final Date fromString(CharSequence source)
                      throws IllegalArgumentException

Specified by:

fromString in interface StringConverter<Date>

Throws:

IllegalArgumentException

getSubjectClass

public final Collection<Class<?>> getSubjectClass()

Provides the subject class for this converter.

Returns:

The subject class.

toString

public final String toString(Date source)

Specified by:

toString in interface StringConverter<Date>