Package de.scravy.bedrock

Class DateTimes

java.lang.Object

de.scravy.bedrock.DateTimes

public class DateTimes
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DateTimes.Interval

Constructor Summary

Constructors

Constructor	Description
DateTimes()

Method Summary

Modifier and Type	Method	Description
static LocalDateTime	parseDateTime(@NonNull String dateTime)	The network law dictates: Be liberal in what you accept, be conservative in what you emit.
static LocalDateTime	parseDateTime(@NonNull String dateTime, int numberOfComponents)	Like DateTimeUtilparseDateTime(String), but accepts an additional argument which specifies how many components of the timestamp will be taken into account.
Instant	parseInstant(String string)
DateTimes.Interval	parseInterval(String string)
DateTimes.Interval	parseInterval(String begin, String end)
LocalDate	toLocalDate(Instant instant)
LocalTime	toLocalTime(Instant instant)

Methods inherited from class java.lang.Object

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

Constructor Details

DateTimes

public DateTimes()

Method Details

parseInterval

@Nonnull public DateTimes.Interval parseInterval(String string)

parseInterval

@Nonnull public DateTimes.Interval parseInterval(String begin, String end)

parseInstant

@Nonnull public Instant parseInstant(String string) throws IllegalArgumentException

Throws:

IllegalArgumentException

toLocalDate

@Nonnull public LocalDate toLocalDate(Instant instant)

toLocalTime

@Nonnull public LocalTime toLocalTime(Instant instant)

parseDateTime

@Nonnull public static LocalDateTime parseDateTime(@NonNull @NonNull String dateTime) throws IllegalArgumentException

The network law dictates: Be liberal in what you accept, be conservative in what you emit.

The law of personal consistency prefers to voice your opinion, harshly, but friendly.

This function will accept timestamps formatted in a variety of formats, and ignores everything it does not understand. It will explode the given string and reduce it to groups of decimal digits. If any of these groups themselves look like a timestamp such as 20191231 it will attempt to make sense out of that. Otherwise it assumes from left to right year, month, day-of-month, hour, minute, second. If any of these components are missing (from right to left) it will default them to zero.

That way this function accepts timestamps such as:

• 20120101
• 2012-01-01-235959
• 20120101.235959
• 2012-05-30T23:59:59
• 2012-05-30 23:59:59
• 2012-05-30-23-59-59

Parameters:

dateTime - A timestamp given as a string.

Returns:

A local date time.

Throws:

IllegalArgumentException

parseDateTime

@Nonnull public static LocalDateTime parseDateTime(@NonNull @NonNull String dateTime, int numberOfComponents) throws IllegalArgumentException

Like DateTimeUtilparseDateTime(String), but accepts an additional argument which specifies how many components of the timestamp will be taken into account.

For instance an invocation with numberOfComponents=4 will ignore minute and second information, if at all provided.

Parameters:

dateTime - A timestamp given as a string.

numberOfComponents - How many components to take into account.

Returns:

A local date time.

Throws:

IllegalArgumentException