Module io.github.mmm.base

Package io.github.mmm.base.temporal

Class TemporalParser

java.lang.Object

io.github.mmm.base.temporal.TemporalParser

All Implemented Interfaces:

FromStringParser<Temporal>

public final class TemporalParser
extends Object
implements FromStringParser<Temporal>

Parser that can detect Strings representing a Temporal value via parse(String) but returns null if not a Temporal instead of throwing an exception.

Since:

1.0.0

See Also:

• parse(String)

Method Summary

Modifier and Type	Method	Description
static TemporalParser	get()
Temporal	parse(String value)	Parses the given String to the type handled by this parser but efficiently returns null if the syntax does not match.

Methods inherited from class java.lang.Object

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

Method Details

parse

public Temporal parse(String value)

Description copied from interface: FromStringParser

Parses the given String to the type handled by this parser but efficiently returns null if the syntax does not match. This allows to detect the format without wasting much performance.

Specified by:

parse in interface FromStringParser<Temporal>

Parameters:

value - the default string representation of a (potential) Temporal value. This can be Instant, LocalDate, LocalTime, LocalDateTime, OffsetTime, OffsetDateTime, ZonedDateTime, or YearMonth. Please note that ChronoLocalDate such as HijrahDate, JapaneseDate, MinguoDate, or ThaiBuddhistDate are not supported. Also Year is not supported as it can easily be confused with a regular integer and can also be detected easily with just two lines of code.

Returns:

the given value parsed as Temporal or null if not any of the supported Temporal types.

get

public static TemporalParser get()

Returns:

the singleton instance of this FromStringParser for Temporal.