Module org.refcodes.time

Package org.refcodes.time

Class DateUtility

java.lang.Object

org.refcodes.time.DateUtility

public final class DateUtility
extends Object

The Class DateUtility.

Method Summary

Modifier and Type	Method	Description
static Date	toDate(String aDateString, DateTimeFormatter[] aDateTimeFormatters)	Parses a String to retrieve a Date from it, using the provided DateTimeFormatter instances.
static LocalDate	toLocalDate(String aDateString, DateTimeFormatter[] aDateTimeFormatters)	Parses a String to retrieve a LocalDate from it, using the provided DateTimeFormatter instances.
static LocalDateTime	toLocalDateTime(String aDateString, DateTimeFormatter[] aDateTimeFormatters)	Parses a String to retrieve a LocalDateTime from it, using the provided DateTimeFormatter instances.

Methods inherited from class java.lang.Object

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

Method Detail

toDate

public static Date toDate(String aDateString,
                          DateTimeFormatter[] aDateTimeFormatters)
                   throws DateTimeException

Parses a String to retrieve a Date from it, using the provided DateTimeFormatter instances. The first one being able to parse a Date from the String will be used and that Date is returned. If none DateTimeFormatter instances were able to parse the provided String, then the first (as being provided in the array) DateTimeFormatter's parse exception is thrown.

Parameters:

aDateString - The date String to be parsed.

aDateTimeFormatters - The DateTimeFormatter instances to be tried out, starting with the first one.

Returns:

A Date retrieved from the given String.

Throws:

DateTimeException - Thrown in case none of the provided DateTimeFormatter instances was able to parse the string. Then the first caught DateTimeException is thrown.

toLocalDate

public static LocalDate toLocalDate(String aDateString,
                                    DateTimeFormatter[] aDateTimeFormatters)
                             throws DateTimeException

Parses a String to retrieve a LocalDate from it, using the provided DateTimeFormatter instances. The first one being able to parse a LocalDate from the String will be used and that LocalDate is returned. If none DateTimeFormatter instances were able to parse the provided String, then the first (as being provided in the array) DateTimeFormatter's parse exception is thrown.

Parameters:

aDateString - The date String to be parsed.

aDateTimeFormatters - The DateTimeFormatter instances to be tried out, starting with the first one.

Returns:

A LocalDate retrieved from the given String.

Throws:

DateTimeException - Thrown in case none of the provided DateTimeFormatter instances was able to parse the string. Then the first caught DateTimeException is thrown.

toLocalDateTime

public static LocalDateTime toLocalDateTime(String aDateString,
                                            DateTimeFormatter[] aDateTimeFormatters)
                                     throws DateTimeException

Parses a String to retrieve a LocalDateTime from it, using the provided DateTimeFormatter instances. The first one being able to parse a LocalDateTime from the String will be used and that LocalDateTime is returned. If none DateTimeFormatter instances were able to parse the provided String, then the first (as being provided in the array) DateTimeFormatter's parse exception is thrown.

Parameters:

aDateString - The date String to be parsed.

aDateTimeFormatters - The DateTimeFormatter instances to be tried out, starting with the first one.

Returns:

A LocalDateTime retrieved from the given String.

Throws:

DateTimeException - Thrown in case none of the provided DateTimeFormatter instances was able to parse the string. Then the first caught DateTimeException is thrown.