Package io.openems.common.utils

Class DateUtils

java.lang.Object

io.openems.common.utils.DateUtils

public class DateUtils
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static final DateTimeFormatter	DMY_FORMATTER	Day-Month-Year with dots separated DateTimeFormatter.
static final DateTimeFormatter	TIME_FORMATTER	DateTimeFormatter with inclusively 24:00 which is converted to 00:00.

Method Summary

Modifier and Type	Method	Description
static void	assertSameTimezone(ZonedDateTime date1, ZonedDateTime date2)	Asserts that both dates are in the same timezone.
static LocalDate	parseLocalDateOrError(String date)	Parses a string to an LocalDate or throws an error.
static LocalDate	parseLocalDateOrError(String date, DateTimeFormatter formatter)	Parses a string to an LocalDate or throws an error.
static LocalDate	parseLocalDateOrNull(String date)	Parses a string to an LocalDate or returns null.
static LocalDate	parseLocalDateOrNull(String date, DateTimeFormatter formatter)	Parses a string to an LocalDate or returns null.
static LocalDateTime	parseLocalDateTimeOrError(String dateTime)	Parses a string to an LocalDateTime or throws an error.
static LocalDateTime	parseLocalDateTimeOrError(String dateTime, DateTimeFormatter formatter)	Parses a string to an LocalDateTime or throws an error.
static LocalDateTime	parseLocalDateTimeOrNull(String dateTime)	Parses a string to an LocalDateTime or returns null.
static LocalDateTime	parseLocalDateTimeOrNull(String dateTime, DateTimeFormatter formatter)	Parses a string to an LocalDateTime or returns null.
static LocalTime	parseLocalTimeOrError(String time)	Parses a string to an LocalTime or throws an error.
static LocalTime	parseLocalTimeOrError(String time, DateTimeFormatter formatter)	Parses a string to an LocalTime or throws an error.
static LocalTime	parseLocalTimeOrNull(String time)	Parses a string to an LocalTime or returns null.
static LocalTime	parseLocalTimeOrNull(String time, DateTimeFormatter formatter)	Parses a string to an LocalTime or returns null.
static ZonedDateTime	parseZonedDateTimeOrError(String date)	Parses a string to an ZonedDateTime or throws an error.
static ZonedDateTime	parseZonedDateTimeOrError(String date, DateTimeFormatter formatter)	Parses a string to an ZonedDateTime or throws an error.
static ZonedDateTime	parseZonedDateTimeOrNull(String date)	Parses a string to an ZonedDateTime or returns null.
static ZonedDateTime	parseZonedDateTimeOrNull(String date, DateTimeFormatter formatter)	Parses a string to an ZonedDateTime or returns null.
static ZonedDateTime	roundDownToMinutes(ZonedDateTime d, int minutes)	Rounds a ZonedDateTime down to given minutes.
static ZonedDateTime	roundDownToQuarter(ZonedDateTime d)	Rounds a ZonedDateTime down to next quarter (15 minutes).

Methods inherited from class java.lang.Object

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

Field Details

DMY_FORMATTER

public static final DateTimeFormatter DMY_FORMATTER

Day-Month-Year with dots separated DateTimeFormatter.

TIME_FORMATTER

public static final DateTimeFormatter TIME_FORMATTER

DateTimeFormatter with inclusively 24:00 which is converted to 00:00.

Method Details

roundDownToMinutes

public static ZonedDateTime roundDownToMinutes(ZonedDateTime d,
 int minutes)

Rounds a ZonedDateTime down to given minutes.

Parameters:

d - the ZonedDateTime

minutes - the minutes to round down to; max 59

Returns:

the rounded result

roundDownToQuarter

public static ZonedDateTime roundDownToQuarter(ZonedDateTime d)

Rounds a ZonedDateTime down to next quarter (15 minutes).

Parameters:

d - the ZonedDateTime

Returns:

the rounded result

assertSameTimezone

public static void assertSameTimezone(ZonedDateTime date1,
 ZonedDateTime date2)
                               throws OpenemsException

Asserts that both dates are in the same timezone.

Parameters:

date1 - the first Date

date2 - the second Date

Throws:

OpenemsException - if dates are not in the same timezone

parseZonedDateTimeOrNull

public static ZonedDateTime parseZonedDateTimeOrNull(String date)

Parses a string to an ZonedDateTime or returns null.

See ZonedDateTime.parse(CharSequence)

Parameters:

date - the string value

Returns:

a ZonedDateTime or null

parseZonedDateTimeOrNull

public static ZonedDateTime parseZonedDateTimeOrNull(String date,
 DateTimeFormatter formatter)

Parses a string to an ZonedDateTime or returns null.

See ZonedDateTime.parse(CharSequence, DateTimeFormatter)

Parameters:

date - the string value

formatter - the formatter to use, not null

Returns:

a ZonedDateTime or null

parseZonedDateTimeOrError

public static ZonedDateTime parseZonedDateTimeOrError(String date)
                                               throws OpenemsException

Parses a string to an ZonedDateTime or throws an error.

See ZonedDateTime.parse(CharSequence)

Parameters:

date - the string value

Returns:

a ZonedDateTime

Throws:

OpenemsException - on error

parseZonedDateTimeOrError

public static ZonedDateTime parseZonedDateTimeOrError(String date,
 DateTimeFormatter formatter)
                                               throws OpenemsException

Parses a string to an ZonedDateTime or throws an error.

See ZonedDateTime.parse(CharSequence, DateTimeFormatter)

Parameters:

date - the string value

formatter - the formatter to use, not null

Returns:

a ZonedDateTime

Throws:

OpenemsException - on error

parseLocalDateOrNull

public static LocalDate parseLocalDateOrNull(String date)

Parses a string to an LocalDate or returns null.

See LocalDate.parse(CharSequence)

Parameters:

date - the string value

Returns:

a LocalDate or null

parseLocalDateOrNull

public static LocalDate parseLocalDateOrNull(String date,
 DateTimeFormatter formatter)

Parses a string to an LocalDate or returns null.

See LocalDate.parse(CharSequence, DateTimeFormatter)

Parameters:

date - the string value

formatter - the formatter to use, not null

Returns:

a LocalDate or null

parseLocalDateOrError

public static LocalDate parseLocalDateOrError(String date)
                                       throws OpenemsException

Parses a string to an LocalDate or throws an error.

See LocalDate.parse(CharSequence)

Parameters:

date - the string value

Returns:

a LocalDate

Throws:

OpenemsException - on error

parseLocalDateOrError

public static LocalDate parseLocalDateOrError(String date,
 DateTimeFormatter formatter)
                                       throws OpenemsException

Parses a string to an LocalDate or throws an error.

See LocalDate.parse(CharSequence, DateTimeFormatter)

Parameters:

date - the string value

formatter - the formatter to use, not null

Returns:

a LocalDate

Throws:

OpenemsException - on error

parseLocalDateTimeOrNull

public static LocalDateTime parseLocalDateTimeOrNull(String dateTime)

Parses a string to an LocalDateTime or returns null.

See LocalDateTime.parse(CharSequence)

Parameters:

dateTime - date the string value

Returns:

a LocalDateTime or null

parseLocalDateTimeOrNull

public static LocalDateTime parseLocalDateTimeOrNull(String dateTime,
 DateTimeFormatter formatter)

Parses a string to an LocalDateTime or returns null.

See LocalDateTime.parse(CharSequence, DateTimeFormatter)

Parameters:

dateTime - date the string value

formatter - the formatter to use, not null

Returns:

a LocalDateTime or null

parseLocalDateTimeOrError

public static LocalDateTime parseLocalDateTimeOrError(String dateTime)
                                               throws OpenemsException

Parses a string to an LocalDateTime or throws an error.

See LocalDateTime.parse(CharSequence)

Parameters:

dateTime - date the string value

Returns:

a LocalDateTime

Throws:

OpenemsException - on error

parseLocalDateTimeOrError

public static LocalDateTime parseLocalDateTimeOrError(String dateTime,
 DateTimeFormatter formatter)
                                               throws OpenemsException

Parses a string to an LocalDateTime or throws an error.

See LocalDateTime.parse(CharSequence, DateTimeFormatter)

Parameters:

dateTime - date the string value

formatter - the formatter to use, not null

Returns:

a LocalDateTime

Throws:

OpenemsException - on error

parseLocalTimeOrNull

public static LocalTime parseLocalTimeOrNull(String time)

Parses a string to an LocalTime or returns null.

See LocalTime.parse(CharSequence)

Parameters:

time - the string value

Returns:

a LocalTime or null

parseLocalTimeOrNull

public static LocalTime parseLocalTimeOrNull(String time,
 DateTimeFormatter formatter)

Parses a string to an LocalTime or returns null.

See LocalTime.parse(CharSequence, DateTimeFormatter)

Parameters:

time - the string value

formatter - the formatter to use, not null

Returns:

a LocalTime or null

parseLocalTimeOrError

public static LocalTime parseLocalTimeOrError(String time)
                                       throws OpenemsException

Parses a string to an LocalTime or throws an error.

See LocalTime.parse(CharSequence)

Parameters:

time - the string value

Returns:

a LocalTime

Throws:

OpenemsException - on error

parseLocalTimeOrError

public static LocalTime parseLocalTimeOrError(String time,
 DateTimeFormatter formatter)
                                       throws OpenemsException

Parses a string to an LocalTime or throws an error.

See LocalTime.parse(CharSequence, DateTimeFormatter)

Parameters:

time - the string value

formatter - the formatter to use, not null

Returns:

a LocalTime

Throws:

OpenemsException - on error