de.ipcon.tools.date

Class DateTimeToolsNG

java.lang.Object

de.ipcon.tools.date.DateTimeToolsNG

public final class DateTimeToolsNG
extends java.lang.Object

Provides static utility methods for working with Date, Calendar, and related objects, with a focus on time zone handling.

Warning:
Some methods may rely on the client's time zone settings. Ensure consistency between the client's time zone and the data's time zone to avoid unexpected results.

Method Summary

Modifier and Type	Method and Description
static int	countDays(java.util.Date from, java.util.Date till) Counts the conceptual days between two dates, including the start and end dates, ignoring time.
static int	countDays(TimespanI ts) Counts the conceptual days covered by the given timespan, ignoring time.
static long	coveredTimespanInFullMinutes(java.util.Date from, java.util.Date till) Returns the timespan between two dates in full minutes, rounded down.
static long	coveredTimespanInMillis(java.util.Calendar from, java.util.Calendar till) Returns the timespan between two calendars in milliseconds.
static long	coveredTimespanInMillis(java.util.Date from, java.util.Date till) Returns the timespan between two dates in milliseconds.
static long	coveredTimespanToDays(java.util.Date from, java.util.Date till) Returns the timespan between two dates in abstract days, rounded up.
static long	coveredTimespanToDays(java.util.Date from, java.util.Date till, boolean roundUp) Returns the timespan between two dates in abstract days.
static long	coveredTimespanToDays(java.time.Duration duration) Returns the timespan between two dates in abstract days, rounded up.
static long	coveredTimespanToDays(java.time.Duration duration, boolean roundUp) Returns the timespan between two dates in abstract days.
static long	coveredTimespanToDays(TimespanI ts) Returns the timespan between the start and end dates in days, rounded up.
static long	coveredTimespanToDays(TimespanI ts, boolean roundUp) Returns the timespan between the start and end dates in days.
static java.time.Duration	createDuration(java.util.Calendar from, java.util.Calendar till) Calculates the duration between two Calendar objects.
static java.time.Duration	createDuration(java.util.Date from, java.util.Date till) Calculates the duration between two Date objects.
static java.time.LocalDate	createLocalDate(java.util.Calendar calendar) Converts a Calendar object to a LocalDate.
static java.time.LocalDate	createLocalDate(java.util.Date date) Converts a Date object to a LocalDate.
static java.time.LocalDateTime	createLocalDateTime(java.util.Calendar calendar) Converts a Calendar object to a LocalDateTime.
static java.time.Period	createPeriod(java.util.Calendar from, java.util.Calendar till) Calculates the period between two Calendar objects.
static java.time.Period	createPeriod(java.util.Date from, java.util.Date till) Calculates the period between two Date objects.
static java.lang.String	formatPeriod(java.time.Period period, boolean showDays)
static java.lang.String	formatPeriod(java.time.Period period, boolean showDays, boolean hideZeroes)
static int	getNumberOfMonths(java.util.Calendar from, java.util.Calendar till) Returns the number of conceptual months between two calendars, rounded up.
static int	getNumberOfMonths(java.util.Date from, java.util.Date till) Returns the number of conceptual months between two dates, rounded up.
static int	getNumberOfMonths(java.time.Period period) Returns the number of conceptual months covered by a period, rounded up.
static java.time.ZoneId	getZoneBerlin() Returns the ZoneId for Europe/Berlin.
static java.time.ZoneId	getZoneLuxembourg() Returns the ZoneId for Europe/Luxembourg.
static java.util.Date	toDate(java.time.LocalDateTime localDateTime, java.time.ZoneId zoneId) Converts a LocalDateTime to a Date in the specified time zone.
static java.util.Date	toDate(java.time.LocalDate localDate, java.time.ZoneId zoneId) Converts a LocalDate to a Date at the start of the day (midnight) in the specified time zone.
static java.util.Date	toDate(java.time.ZonedDateTime zonedDateTime) Converts a ZonedDateTime to a Date.
static java.util.Date	toDateOfSystem(java.time.LocalDate localDate) Converts a LocalDate to a Date at the start of the day (midnight) in the system's default time zone.
static java.util.Date	toDateOfSystem(java.time.LocalDateTime localDateTime) Converts a LocalDateTime to a Date in the system's default time zone.
static java.time.LocalDateTime	toLocalDateTime(java.util.Date date, java.time.ZoneId zoneId) Converts a Date object to a LocalDateTime at the given zone.
static java.time.LocalDateTime	toLocalDateTimeOfSystem(java.util.Date date) Converts a Date to a LocalDateTime at the default time zone of the system.
static java.time.ZoneOffset	toZoneOffset(java.time.ZoneId zoneId, java.util.Date atDate) Gets the ZoneOffset that was valid in the given ZoneId at the provided Date.
static java.time.ZoneOffset	toZoneOffset(java.time.ZoneId zoneId, java.time.Instant atInstant) Gets the ZoneOffset that was valid in the given ZoneId at the provided Instant.
static java.time.ZoneOffset	toZoneOffset(java.time.ZoneId zoneId, java.time.LocalDateTime atDateTime) Gets the ZoneOffset that was valid in the given ZoneId at the provided LocalDateTime.

Methods inherited from class java.lang.Object

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

Method Detail

getZoneBerlin

public static java.time.ZoneId getZoneBerlin()

Returns the ZoneId for Europe/Berlin.

Returns:

the ZoneId for Europe/Berlin

getZoneLuxembourg

public static java.time.ZoneId getZoneLuxembourg()

Returns the ZoneId for Europe/Luxembourg.

Returns:

the ZoneId for Europe/Luxembourg

toZoneOffset

public static java.time.ZoneOffset toZoneOffset(java.time.ZoneId zoneId,
                                                java.time.LocalDateTime atDateTime)

Gets the ZoneOffset that was valid in the given ZoneId at the provided LocalDateTime.

It is generally recommended to use toZoneOffset(ZoneId, Instant) instead, as the lookup with an Instant is guaranteed to be unique.

Parameters:

zoneId - the ZoneId to check

atDateTime - the LocalDateTime at which the offset is requested

Returns:

the ZoneOffset valid at the given LocalDateTime in the given zone, or null if either parameter is null.

See Also:

for rules regarding the interpretation of non-unique or non-existing {@code LocalDateTime}s (e.g., during DST transitions)

toZoneOffset

public static java.time.ZoneOffset toZoneOffset(java.time.ZoneId zoneId,
                                                java.time.Instant atInstant)

Gets the ZoneOffset that was valid in the given ZoneId at the provided Instant.

Parameters:

zoneId - the ZoneId to check

atInstant - the Instant to check (e.g., via Date.toInstant())

Returns:

the ZoneOffset that was in effect at the given Instant in the given zone, or null if either parameter is null.

toZoneOffset

public static java.time.ZoneOffset toZoneOffset(java.time.ZoneId zoneId,
                                                java.util.Date atDate)

Gets the ZoneOffset that was valid in the given ZoneId at the provided Date.

This method converts the Date to an Instant and delegates to toZoneOffset(ZoneId, Instant).

Parameters:

zoneId - the ZoneId to check

atDate - the Date to check

Returns:

the ZoneOffset that was in effect at the given Date in the given zone, or null if either parameter is null.

See Also:

toZoneOffset(ZoneId, Instant)

toLocalDateTime

public static java.time.LocalDateTime toLocalDateTime(java.util.Date date,
                                                      java.time.ZoneId zoneId)

Converts a Date object to a LocalDateTime at the given zone.

Parameters:

date - the date to convert

zoneId - the ZoneId at which the date will be interpreted

Returns:

the corresponding LocalDateTime, or null if either parameter is null.

toLocalDateTimeOfSystem

public static java.time.LocalDateTime toLocalDateTimeOfSystem(java.util.Date date)

Converts a Date to a LocalDateTime at the default time zone of the system.

Parameters:

date - the date to convert

Returns:

the corresponding LocalDateTime, or null if the date is null.

toDateOfSystem

public static java.util.Date toDateOfSystem(java.time.LocalDate localDate)

Converts a LocalDate to a Date at the start of the day (midnight) in the system's default time zone.

This method is a temporary workaround for persisting LocalDate values as Date objects in the database. It may be removed once the backend is updated to handle java.time types natively.

Parameters:

localDate - the LocalDate to convert, may be null

Returns:

the corresponding Date, or null if the input LocalDate is null

toDateOfSystem

public static java.util.Date toDateOfSystem(java.time.LocalDateTime localDateTime)

Converts a LocalDateTime to a Date in the system's default time zone.

This method is a temporary workaround for persisting LocalDateTime values as Date objects in the database. It may be removed once the backend is updated to handle java.time types natively.

Parameters:

localDateTime - the LocalDateTime to convert, may be null

Returns:

the corresponding Date, or null if the input LocalDateTime is null

toDate

public static java.util.Date toDate(java.time.LocalDate localDate,
                                    java.time.ZoneId zoneId)

Converts a LocalDate to a Date at the start of the day (midnight) in the specified time zone.

This method is a temporary workaround for persisting LocalDate values as Date objects in the database. It may be removed once the backend is updated to handle java.time types natively.

Parameters:

localDate - the LocalDate to convert, may be null

zoneId - the ZoneId to use for the conversion

Returns:

the corresponding Date, or null if the input LocalDate is null

toDate

public static java.util.Date toDate(java.time.LocalDateTime localDateTime,
                                    java.time.ZoneId zoneId)

Converts a LocalDateTime to a Date in the specified time zone.

This method is a temporary workaround for persisting LocalDateTime values as Date objects in the database. It may be removed once the backend is updated to handle java.time types natively.

Parameters:

localDateTime - the LocalDateTime to convert, may be null

zoneId - the ZoneId to use for the conversion

Returns:

the corresponding Date, or null if the input LocalDateTime is null

toDate

public static java.util.Date toDate(java.time.ZonedDateTime zonedDateTime)

Converts a ZonedDateTime to a Date.

This method is a temporary workaround for persisting ZonedDateTime values as Date objects in the database. It may be removed once the backend is updated to handle java.time types natively.

Parameters:

zonedDateTime - the ZonedDateTime to convert, may be null

Returns:

the corresponding Date, or null if the input ZonedDateTime is null

createLocalDateTime

public static java.time.LocalDateTime createLocalDateTime(java.util.Calendar calendar)

Converts a Calendar object to a LocalDateTime.

Parameters:

calendar - the calendar to convert

Returns:

the corresponding LocalDateTime, or null if the input calendar is null

createDuration

public static java.time.Duration createDuration(java.util.Date from,
                                                java.util.Date till)

Calculates the duration between two Date objects.

Parameters:

from - the start date

till - the end date

Returns:

the duration between the two dates

Throws:

java.lang.IllegalArgumentException - if either date is null

createDuration

public static java.time.Duration createDuration(java.util.Calendar from,
                                                java.util.Calendar till)

Calculates the duration between two Calendar objects.

Parameters:

from - the start calendar

till - the end calendar

Returns:

the duration between the two calendars

Throws:

java.lang.IllegalArgumentException - if either calendar is null

createLocalDate

public static java.time.LocalDate createLocalDate(java.util.Date date)

Converts a Date object to a LocalDate.

Parameters:

date - the date to convert

Returns:

the corresponding LocalDate, or null if the input date is null

createLocalDate

public static java.time.LocalDate createLocalDate(java.util.Calendar calendar)

Converts a Calendar object to a LocalDate.

Parameters:

calendar - the calendar to convert

Returns:

the corresponding LocalDate, or null if the input calendar is null

createPeriod

public static java.time.Period createPeriod(java.util.Date from,
                                            java.util.Date till)

Calculates the period between two Date objects.

Parameters:

from - the start date

till - the end date

Returns:

the period between the two dates

Throws:

java.lang.IllegalArgumentException - if either date is null

createPeriod

public static java.time.Period createPeriod(java.util.Calendar from,
                                            java.util.Calendar till)

Calculates the period between two Calendar objects.

Parameters:

from - the start calendar

till - the end calendar

Returns:

the period between the two calendars

Throws:

java.lang.IllegalArgumentException - if either calendar is null

coveredTimespanToDays

public static long coveredTimespanToDays(TimespanI ts)

Returns the timespan between the start and end dates in days, rounded up.

Parameters:

ts - the timespan to count the days in

Returns:

the timespan in days, rounded up

Throws:

java.lang.IllegalArgumentException - if the timespan is null

coveredTimespanToDays

public static long coveredTimespanToDays(TimespanI ts,
                                         boolean roundUp)

Returns the timespan between the start and end dates in days.

Parameters:

ts - the timespan to count the days in

roundUp - if true, the number of days is rounded up

Returns:

the timespan in days

Throws:

java.lang.IllegalArgumentException - if the timespan is null

coveredTimespanToDays

public static long coveredTimespanToDays(java.util.Date from,
                                         java.util.Date till)

Returns the timespan between two dates in abstract days, rounded up.

Parameters:

from - the start date

till - the end date

Returns:

the timespan in days, rounded up

Throws:

java.lang.IllegalArgumentException - if either date is null

coveredTimespanToDays

public static long coveredTimespanToDays(java.util.Date from,
                                         java.util.Date till,
                                         boolean roundUp)

Returns the timespan between two dates in abstract days.

Parameters:

from - the start date

till - the end date

roundUp - if true, the number of days is rounded up

Returns:

the timespan in days

Throws:

java.lang.IllegalArgumentException - if either date is null

coveredTimespanToDays

public static long coveredTimespanToDays(java.time.Duration duration)

Returns the timespan between two dates in abstract days, rounded up.

Parameters:

duration - the duration to convert to days

Returns:

the timespan in days, rounded up

coveredTimespanToDays

public static long coveredTimespanToDays(java.time.Duration duration,
                                         boolean roundUp)

Returns the timespan between two dates in abstract days.

Parameters:

duration - the duration to convert to days

roundUp - if true, the number of days is rounded up if the remainder is at least one hour.

Returns:

the timespan in days

countDays

public static int countDays(TimespanI ts)

Counts the conceptual days covered by the given timespan, ignoring time.

Parameters:

ts - the timespan to count the days in

Returns:

the number of conceptual days covered by the timespan

Throws:

java.lang.IllegalArgumentException - if the timespan is null

countDays

public static int countDays(java.util.Date from,
                            java.util.Date till)

Counts the conceptual days between two dates, including the start and end dates, ignoring time.

Parameters:

from - the start date

till - the end date

Returns:

the number of conceptual days between the dates

Throws:

java.lang.IllegalArgumentException - if either date is null

coveredTimespanInFullMinutes

public static long coveredTimespanInFullMinutes(java.util.Date from,
                                                java.util.Date till)

Returns the timespan between two dates in full minutes, rounded down.

Parameters:

from - the start date

till - the end date

Returns:

the timespan in full minutes

Throws:

java.lang.IllegalArgumentException - if either date is null

coveredTimespanInMillis

public static long coveredTimespanInMillis(java.util.Date from,
                                           java.util.Date till)

Returns the timespan between two dates in milliseconds.

Parameters:

from - the start date

till - the end date

Returns:

the timespan in milliseconds

Throws:

java.lang.IllegalArgumentException - if either date is null

coveredTimespanInMillis

public static long coveredTimespanInMillis(java.util.Calendar from,
                                           java.util.Calendar till)

Returns the timespan between two calendars in milliseconds.

Parameters:

from - the start calendar

till - the end calendar

Returns:

the timespan in milliseconds

Throws:

java.lang.IllegalArgumentException - if either calendar is null

getNumberOfMonths

public static int getNumberOfMonths(java.util.Date from,
                                    java.util.Date till)

Returns the number of conceptual months between two dates, rounded up.

Parameters:

from - the start date

till - the end date

Returns:

the number of conceptual months between the dates, rounded up

Throws:

java.lang.IllegalArgumentException - if either date is null

getNumberOfMonths

public static int getNumberOfMonths(java.util.Calendar from,
                                    java.util.Calendar till)

Returns the number of conceptual months between two calendars, rounded up.

Parameters:

from - the start calendar

till - the end calendar

Returns:

the number of conceptual months between the calendars, rounded up

Throws:

java.lang.IllegalArgumentException - if either calendar is null

getNumberOfMonths

public static int getNumberOfMonths(java.time.Period period)

Returns the number of conceptual months covered by a period, rounded up.

Parameters:

period - the period to inspect

Returns:

the number of conceptual months covered by the period, rounded up

Throws:

java.lang.IllegalArgumentException - if the period is null

formatPeriod

public static java.lang.String formatPeriod(java.time.Period period,
                                            boolean showDays)

formatPeriod

public static java.lang.String formatPeriod(java.time.Period period,
                                            boolean showDays,
                                            boolean hideZeroes)