Module org.tquadrat.foundation.util

Package org.tquadrat.foundation.util.stringconverter

Class ZonedDateTimeStringConverter

java.lang.Object

org.tquadrat.foundation.util.stringconverter.TimeDateStringConverter<ZonedDateTime>

org.tquadrat.foundation.util.stringconverter.ZonedDateTimeStringConverter

All Implemented Interfaces:

Serializable, StringConverter<ZonedDateTime>

@ClassVersion(sourceVersion="$Id: ZonedDateTimeStringConverter.java 1130 2024-05-05 16:16:09Z tquadrat $")
@API(status=STABLE,
     since="0.0.6")
public class ZonedDateTimeStringConverter
extends TimeDateStringConverter<ZonedDateTime>

The implementation of TimeDateStringConverter for java.time.ZonedDateTime.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: ZonedDateTimeStringConverter.java 1130 2024-05-05 16:16:09Z tquadrat $

Since:

0.0.6

See Also:

• Serialized Form

UML Diagram

⁠

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

⁠

Field Summary

Fields

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

Fields inherited from class org.tquadrat.foundation.util.stringconverter.TimeDateStringConverter

MSG_InvalidDateTimeFormat

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

METHOD_NAME_GetSubjectClass, METHOD_NAME_Provider

Constructor Summary

Constructors

Constructor	Description
ZonedDateTimeStringConverter()	Creates a new ZonedDateTimeStringConverter instance that uses DateTimeFormatter.ISO_ZONED_DATE_TIME to format/parse the date.
ZonedDateTimeStringConverter(DateTimeFormatter formatter)	Creates a new ZonedDateTimeStringConverter instance.

Method Summary

Modifier and Type	Method	Description
protected final ZonedDateTime	parseDateTime(CharSequence source, Optional<DateTimeFormatter> formatter)	Parses the given String to an instance of Temporal.
static final ZonedDateTimeStringConverter	provider()	This method is used by the ServiceLoader to obtain the instance for this StringConverter implementation.

Methods inherited from class org.tquadrat.foundation.util.stringconverter.TimeDateStringConverter

fromString, getSubjectClass, toString

Methods inherited from class java.lang.Object

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

Field Details

INSTANCE

public static final ZonedDateTimeStringConverter INSTANCE

An instance of this class.

Constructor Details

ZonedDateTimeStringConverter

public ZonedDateTimeStringConverter()

Creates a new ZonedDateTimeStringConverter instance that uses DateTimeFormatter.ISO_ZONED_DATE_TIME to format/parse the date.

ZonedDateTimeStringConverter

public ZonedDateTimeStringConverter(DateTimeFormatter formatter)

Creates a new ZonedDateTimeStringConverter instance.

Note:

• The formatter may not drop any part of the zoned date time, otherwise fromString() may fail. This means that the formatter is only allowed to re-order the temporal fields.

Parameters:

formatter - The formatter for the temporal accessor.

Method Details

parseDateTime

protected final ZonedDateTime parseDateTime(CharSequence source,
 Optional<DateTimeFormatter> formatter)
                                     throws DateTimeParseException

Parses the given String to an instance of Temporal. The caller ensures that source is not null, not the empty String and does not contain only whitespace.

Specified by:

parseDateTime in class TimeDateStringConverter<ZonedDateTime>

Parameters:

source - The String to parse.

formatter - The formatter for parsing the String

Returns:

The time/date value.

Throws:

DateTimeParseException - The given value cannot be parsed to a Temporal.

provider

public static final ZonedDateTimeStringConverter provider()

This method is used by the ServiceLoader to obtain the instance for this StringConverter implementation.

Returns:

The instance for this StringConverter implementation.