Package org.kiwiproject.time

Class KiwiDateTimeParsers

java.lang.Object

org.kiwiproject.time.KiwiDateTimeParsers

public class KiwiDateTimeParsers
extends Object

A collection of small utilities to parse strings into various types of Java date/time classes, both the legacy Date and the Java 8 date/time API classes in java.time.

Please make sure you actually read the method documentation so you know the format(s) that are expected or allowed.

While the JDK has decided to keep the formatting and parsing methods together in DateTimeFormatter, we decided to split them into separate utilities. So if you are looking for utilities to format date/time objects into strings, see KiwiDateTimeFormatters.

None of these are difficult to implement, but if you are constantly doing them, the time and code adds up over time.

All methods throw IllegalArgumentException if null or blank arguments are passed to them.

Constructor Summary

Constructors

Constructor	Description
KiwiDateTimeParsers()

Method Summary

Modifier and Type	Method	Description
static Date	parseAsDate(String dateTimeString)	Converts the given date/time string into a Date using DateTimeFormatter.ISO_ZONED_DATE_TIME as the formatter.
static LocalDate	parseAsLocalDate(String dateString)	Converts the given date string into a LocalDate using DateTimeFormatter.ISO_LOCAL_DATE as the formatter.
static LocalDate	parseAsLocalDate(String dateString, DateTimeFormatter formatter)	Converts the given date string into a LocalDate using the given formatter.
static LocalDateTime	parseAsLocalDateTime(String dateTimeString)	Converts the given date/time string into a LocalDateTime using DateTimeFormatter.ISO_LOCAL_DATE_TIME as the formatter.
static LocalDateTime	parseAsLocalDateTime(String dateTimeString, DateTimeFormatter formatter)	Converts the given date/time string into a LocalDateTime using the given formatter.
static ZonedDateTime	parseAsZonedDateTime(String dateTimeString)	Converts the given date/time string into a ZonedDateTime using DateTimeFormatter.ISO_ZONED_DATE_TIME as the formatter.
static ZonedDateTime	parseAsZonedDateTime(String dateTimeString, DateTimeFormatter formatter)	Converts the given date/time string into a ZonedDateTime using the specified DateTimeFormatter.

Methods inherited from class java.lang.Object

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

Constructor Detail

KiwiDateTimeParsers

public KiwiDateTimeParsers()

Method Detail

parseAsDate

public static Date parseAsDate(String dateTimeString)

Converts the given date/time string into a Date using DateTimeFormatter.ISO_ZONED_DATE_TIME as the formatter.

Parameters:

dateTimeString - the date/time string to parse

Returns:

the parsed Date

Implementation Note:

If you need to parse a string into a custom format, you'll need to use SimpleDateFormat (which is NOT thread safe, so make sure to use in a ThreadLocal or simply instantiate a new one each time you need to parse)

parseAsLocalDate

public static LocalDate parseAsLocalDate(String dateString)

Converts the given date string into a LocalDate using DateTimeFormatter.ISO_LOCAL_DATE as the formatter.

Parameters:

dateString - the date string to parse

Returns:

the parsed LocalDate

parseAsLocalDate

public static LocalDate parseAsLocalDate(String dateString,
                                         DateTimeFormatter formatter)

Converts the given date string into a LocalDate using the given formatter.

Parameters:

dateString - the date string to parse

formatter - the formatter to use

Returns:

the parsed LocalDate

See Also:

DateTimeFormatter.parse(CharSequence, TemporalQuery)

parseAsLocalDateTime

public static LocalDateTime parseAsLocalDateTime(String dateTimeString)

Converts the given date/time string into a LocalDateTime using DateTimeFormatter.ISO_LOCAL_DATE_TIME as the formatter.

Parameters:

dateTimeString - the date/time string to parse

Returns:

the parsed LocalDate

parseAsLocalDateTime

public static LocalDateTime parseAsLocalDateTime(String dateTimeString,
                                                 DateTimeFormatter formatter)

Converts the given date/time string into a LocalDateTime using the given formatter.

Parameters:

dateTimeString - the date/time string to parse

formatter - the formatter to use

Returns:

the parsed LocalDateTime

See Also:

DateTimeFormatter.parse(CharSequence, TemporalQuery)

parseAsZonedDateTime

public static ZonedDateTime parseAsZonedDateTime(String dateTimeString)

Converts the given date/time string into a ZonedDateTime using DateTimeFormatter.ISO_ZONED_DATE_TIME as the formatter.

Parameters:

dateTimeString - the date/time string to parse

Returns:

the parsed ZonedDateTime

parseAsZonedDateTime

public static ZonedDateTime parseAsZonedDateTime(String dateTimeString,
                                                 DateTimeFormatter formatter)

Converts the given date/time string into a ZonedDateTime using the specified DateTimeFormatter.

Parameters:

dateTimeString - the date/time string to parse

formatter - the formatter to use

Returns:

the parsed ZonedDateTime

See Also:

DateTimeFormatter.parse(CharSequence, TemporalQuery)