Package com.thanlinardos.spring_enterprise_library.time.utils

Class DateUtils

java.lang.Object

com.thanlinardos.spring_enterprise_library.time.utils.DateUtils

public abstract class DateUtils
extends Object

Utility class for date operations.

Constructor Summary

Constructors

Constructor	Description
DateUtils()

Method Summary

Modifier and Type	Method	Description
static LocalDate	addDay(LocalDate date)	Adds one day to the given date.
static LocalDate	addDays(LocalDate date, int days)	Adds the specified number of days to the given date.
static ZonedDateTime	epochMilliToZonedDateTime(Long epochMilli)	Converts epoch milliseconds to ZonedDateTime in the system default time zone TimeFactory.getDefaultZoneId().
static long	getEpochMilliFromLocalDateTime(LocalDateTime localDateTime)	Converts LocalDateTime to epoch milliseconds in the system default time zone TimeFactory.getDefaultZoneId().
static LocalDate	getLastDayOfYear(Year year)	Gets the first day of the given year.
static LocalDate	getLocalDateFromEpochMilli(Long epochMilli)	Converts epoch milliseconds to LocalDate in the system default time zone TimeFactory.getDefaultZoneId().
static LocalDateTime	getLocalDateTimeFromEpochMilli(Long epochMilli)	Converts epoch milliseconds to LocalDateTime in the system default time zone TimeFactory.getDefaultZoneId().
static boolean	isAfterNullAsMax(LocalDate date1, LocalDate date2)	Checks if date1 is after date2, treating null as TimeFactory.getMaxDate().
static boolean	isAfterOrEqual(LocalDate date1, LocalDate date2)	Checks if date1 is after or equal to date2, treating null as TimeFactory.getMaxDate().
static boolean	isBeforeNullAsMin(LocalDate date1, LocalDate date2)	Checks if date1 is before date2, treating null as TimeFactory.getMinDate().
static boolean	isBeforeOrEqual(LocalDate date1, LocalDate date2)	Checks if date1 is before or equal to date2, treating null as TimeFactory.getMinDate().
static LocalDate	maxNullAsMax(LocalDate date1, LocalDate date2)	Returns the maximum of two LocalDate values, treating null as the maximum possible date.
static LocalDate	maxNullAsMin(LocalDate date1, LocalDate date2)	Returns the maximum of two LocalDate values, treating null as the minimum possible date.
static LocalDate	minNullAsMax(LocalDate date1, LocalDate date2)	Returns the minimum of two LocalDate values, treating null as the maximum possible date.
static LocalDate	minNullAsMin(LocalDate date1, LocalDate date2)	Returns the minimum of two LocalDate values, treating null as the minimum possible date.
static LocalDate	parseDate(String date, Function<String,LocalDate> parser)	Parses a date string using the provided parser function.
static LocalDate	parseLocalDate(String startDate)	Parses a date string into a LocalDate using the default parser from LocalDate.parse(CharSequence).
static LocalDate	subtractDay(LocalDate date)	Subtracts one day from the given date.

Methods inherited from class java.lang.Object

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

Constructor Details

DateUtils

public DateUtils()

Method Details

getLastDayOfYear

public static LocalDate getLastDayOfYear(Year year)

Gets the first day of the given year.

Parameters:

year - the year to get the first day of.

Returns:

the first day of the given year.

getLocalDateTimeFromEpochMilli

public static LocalDateTime getLocalDateTimeFromEpochMilli(Long epochMilli)

Converts epoch milliseconds to LocalDateTime in the system default time zone TimeFactory.getDefaultZoneId().

Parameters:

epochMilli - the epoch milliseconds to convert.

Returns:

the corresponding LocalDateTime.

getLocalDateFromEpochMilli

public static LocalDate getLocalDateFromEpochMilli(Long epochMilli)

Converts epoch milliseconds to LocalDate in the system default time zone TimeFactory.getDefaultZoneId().

Parameters:

epochMilli - the epoch milliseconds to convert.

Returns:

the corresponding LocalDate.

epochMilliToZonedDateTime

public static ZonedDateTime epochMilliToZonedDateTime(Long epochMilli)

Converts epoch milliseconds to ZonedDateTime in the system default time zone TimeFactory.getDefaultZoneId().

Parameters:

epochMilli - the epoch milliseconds to convert.

Returns:

the corresponding ZonedDateTime.

getEpochMilliFromLocalDateTime

public static long getEpochMilliFromLocalDateTime(@Nonnull
 LocalDateTime localDateTime)

Converts LocalDateTime to epoch milliseconds in the system default time zone TimeFactory.getDefaultZoneId().

Parameters:

localDateTime - the LocalDateTime to convert.

Returns:

the corresponding epoch milliseconds.

isBeforeNullAsMin

public static boolean isBeforeNullAsMin(@Nullable
 LocalDate date1,
 @Nullable
 LocalDate date2)

Checks if date1 is before date2, treating null as TimeFactory.getMinDate().

Parameters:

date1 - The first date to compare.

date2 - The second date to compare.

Returns:

true if date1 is before date2, false otherwise.

isAfterNullAsMax

public static boolean isAfterNullAsMax(@Nullable
 LocalDate date1,
 @Nullable
 LocalDate date2)

Checks if date1 is after date2, treating null as TimeFactory.getMaxDate().

Parameters:

date1 - The first date to compare.

date2 - The second date to compare.

Returns:

true if date1 is after date2, false otherwise.

isBeforeOrEqual

public static boolean isBeforeOrEqual(@Nullable
 LocalDate date1,
 @Nullable
 LocalDate date2)

Checks if date1 is before or equal to date2, treating null as TimeFactory.getMinDate().

Parameters:

date1 - The first date to compare.

date2 - The second date to compare.

Returns:

true if date1 is before or equal to date2, false otherwise.

isAfterOrEqual

public static boolean isAfterOrEqual(@Nullable
 LocalDate date1,
 @Nullable
 LocalDate date2)

Checks if date1 is after or equal to date2, treating null as TimeFactory.getMaxDate().

Parameters:

date1 - The first date to compare.

date2 - The second date to compare.

Returns:

true if date1 is after or equal to date2, false otherwise.

maxNullAsMax

public static LocalDate maxNullAsMax(@Nullable
 LocalDate date1,
 @Nullable
 LocalDate date2)

Returns the maximum of two LocalDate values, treating null as the maximum possible date.

Parameters:

date1 - The first LocalDate value, which may be null.

date2 - The second LocalDate value, which may be null.

Returns:

The maximum of the two LocalDate values, or null if both are null.

minNullAsMin

public static LocalDate minNullAsMin(@Nullable
 LocalDate date1,
 @Nullable
 LocalDate date2)

Returns the minimum of two LocalDate values, treating null as the minimum possible date.

Parameters:

date1 - The first LocalDate value, which may be null.

date2 - The second LocalDate value, which may be null.

Returns:

The minimum of the two LocalDate values, or null if both are null.

maxNullAsMin

public static LocalDate maxNullAsMin(@Nullable
 LocalDate date1,
 @Nullable
 LocalDate date2)

Returns the maximum of two LocalDate values, treating null as the minimum possible date.

Parameters:

date1 - The first LocalDate value, which may be null.

date2 - The second LocalDate value, which may be null.

Returns:

The maximum of the two LocalDate values, or null if both are null.

minNullAsMax

public static LocalDate minNullAsMax(@Nullable
 LocalDate date1,
 @Nullable
 LocalDate date2)

Returns the minimum of two LocalDate values, treating null as the maximum possible date.

Parameters:

date1 - The first LocalDate value, which may be null.

date2 - The second LocalDate value, which may be null.

Returns:

The minimum of the two LocalDate values, or null if both are null.

addDays

@Nullable
public static LocalDate addDays(@Nullable
 LocalDate date,
 int days)

Adds the specified number of days to the given date.

Parameters:

date - the date to add days to, may be null.

days - the number of days to add, may be negative to subtract days.

Returns:

the new date with the added days, or null if the input date was null.

addDay

@Nullable
public static LocalDate addDay(@Nullable
 LocalDate date)

Adds one day to the given date.

Parameters:

date - the date to add a day to, may be null.

Returns:

the new date with one day added, or null if the input date was null.

subtractDay

@Nullable
public static LocalDate subtractDay(@Nullable
 LocalDate date)

Subtracts one day from the given date.

Parameters:

date - the date to subtract a day from, may be null.

Returns:

the new date with one day subtracted, or null if the input date was null.

parseLocalDate

public static LocalDate parseLocalDate(String startDate)

Parses a date string into a LocalDate using the default parser from LocalDate.parse(CharSequence).

Parameters:

startDate - the date string to parse.

Returns:

the parsed LocalDate, or null if the input string is empty.

parseDate

public static LocalDate parseDate(@Nullable
 String date,
 Function<String,LocalDate> parser)

Parses a date string using the provided parser function.

Parameters:

date - the date string to parse.

parser - the function to parse the date.

Returns:

the parsed LocalDate, or null if the input string is empty.