jfxtras.icalendarfx.utilities

Class DateTimeUtilities

java.lang.Object

jfxtras.icalendarfx.utilities.DateTimeUtilities

public final class DateTimeUtilities
extends java.lang.Object

Temporal date and date-time types supported by iCalendar. DATE DATE_WITH_LOCAL_TIME DATE_WITH_LOCAL_TIME_AND_TIME_ZONE DATE_WITH_UTC_TIME: see iCalendar RFC 5545, page 32-33

includes methods to format a Temporal representing a DateTimeType as a String

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DateTimeUtilities.DateTimeType

Field Summary

Fields

Modifier and Type	Field and Description
static DateTimeUtilities.DateTimeType	DEFAULT_DATE_TIME_TYPE Default DateTimeType to use when none is specified.
static java.time.format.DateTimeFormatter	LOCAL_DATE_FORMATTER
static java.time.format.DateTimeFormatter	LOCAL_DATE_TIME_FORMATTER
static java.util.Comparator<java.time.temporal.Temporal>	TEMPORAL_COMPARATOR Compares two temporals of the same type
static java.util.Comparator<java.time.temporal.Temporal>	TEMPORAL_COMPARATOR2 Compares two temporals of the LocalDate, LocalDateTime and ZonedDateTime Makes LocalDate at start of day.
static java.time.format.DateTimeFormatter	ZONED_DATE_TIME_FORMATTER
static java.time.format.DateTimeFormatter	ZONED_DATE_TIME_UTC_FORMATTER

Method Summary

Modifier and Type	Method and Description
static java.lang.String	checkScheduleConflict(VEvent vEvent, java.util.List<VEvent> vEvents) Check if schedule conflict exists for OPAQUE events using default check quantity
static java.lang.String	checkScheduleConflict(VEvent vEvent, java.util.List<VEvent> vEvents, int checkQuantity) Check if schedule conflict exists for OPAQUE events.
static java.lang.String	checkScheduleConflict2(VEvent vEvent, java.util.List<VEvent> vEvents, int checkQuantity) Check if schedule conflict exists for OPAQUE events.
static java.lang.String	dateTimePropertyTag(java.lang.String propertyName, java.time.temporal.Temporal temporal) Deprecated.
static java.time.DayOfWeek	dayOfWeekFromAbbreviation(java.lang.String dayOfWeekAbbreviation) Convert 2-character string to DayOfWeek following below convention: weekday = "SU" / "MO" / "TU" / "WE" / "TH" / "FR" / "SA" Corresponding to SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, and SATURDAY days of the week.
static java.lang.String	format(java.time.temporal.Temporal temporal) Deprecated.
static java.util.Comparator<java.time.temporal.Temporal>	getTemporalComparator(java.time.temporal.Temporal t) Returns correct comparator based on Temporal parameter
static boolean	isAfter(java.time.temporal.Temporal t1, java.time.temporal.Temporal t2) Determines if Temporal is after t2 Works for LocalDate, LocalDateTime and ZonedDateTime
static boolean	isBefore(java.time.temporal.Temporal t1, java.time.temporal.Temporal t2) Determines if Temporal is before t2 Works for LocalDate, LocalDateTime and ZonedDateTime
static java.time.temporal.Temporal	parse(java.lang.String temporalString, java.time.ZoneId zone)
static java.time.temporal.Temporal	parseOld(java.lang.String temporalString)
static java.time.temporal.TemporalAmount	temporalAmountBetween(java.time.temporal.Temporal startInclusive, java.time.temporal.Temporal endExclusive) Calculate TemporalAmount between two Temporals.
static java.time.temporal.Temporal	temporalFromString(java.lang.String string) Parse ISO.8601 string into LocalDate, LocalDateTime or ZonedDateTime Temporal object.
static java.lang.String	temporalToString(java.time.temporal.Temporal temporal) produced ISO.8601 date and date-time string for given Temporal of type LocalDate, LocalDateTime or ZonedDateTime
static java.time.LocalDateTime	toLocalDateTime(java.time.temporal.Temporal temporal) Deprecated.
static int	weekOrdinalInMonth(java.time.temporal.Temporal dateBasedTemporal) returns week of month.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_DATE_TIME_TYPE

public static final DateTimeUtilities.DateTimeType DEFAULT_DATE_TIME_TYPE

Default DateTimeType to use when none is specified. For example, when a date-only component is converted to a date-time one.

LOCAL_DATE_FORMATTER

public static final java.time.format.DateTimeFormatter LOCAL_DATE_FORMATTER

LOCAL_DATE_TIME_FORMATTER

public static final java.time.format.DateTimeFormatter LOCAL_DATE_TIME_FORMATTER

ZONED_DATE_TIME_UTC_FORMATTER

public static final java.time.format.DateTimeFormatter ZONED_DATE_TIME_UTC_FORMATTER

ZONED_DATE_TIME_FORMATTER

public static final java.time.format.DateTimeFormatter ZONED_DATE_TIME_FORMATTER

TEMPORAL_COMPARATOR

public static final java.util.Comparator<java.time.temporal.Temporal> TEMPORAL_COMPARATOR

Compares two temporals of the same type

TEMPORAL_COMPARATOR2

public static final java.util.Comparator<java.time.temporal.Temporal> TEMPORAL_COMPARATOR2

Compares two temporals of the LocalDate, LocalDateTime and ZonedDateTime Makes LocalDate at start of day. Add system default ZoneId to LocalDate and LocalDateTime

Method Detail

getTemporalComparator

public static final java.util.Comparator<java.time.temporal.Temporal> getTemporalComparator(java.time.temporal.Temporal t)

Returns correct comparator based on Temporal parameter

isBefore

public static boolean isBefore(java.time.temporal.Temporal t1,
                               java.time.temporal.Temporal t2)

Determines if Temporal is before t2 Works for LocalDate, LocalDateTime and ZonedDateTime

Parameters:

t1 - first Temporal

t2 - second Temporal (to compare with t1)

Returns:

true if t1 is before t2, false otherwise

isAfter

public static boolean isAfter(java.time.temporal.Temporal t1,
                              java.time.temporal.Temporal t2)

Determines if Temporal is after t2 Works for LocalDate, LocalDateTime and ZonedDateTime

Parameters:

t1 - first Temporal

t2 - second Temporal (to compare with t1)

Returns:

true if t1 is after t2, false otherwise

checkScheduleConflict

public static java.lang.String checkScheduleConflict(VEvent vEvent,
                                                     java.util.List<VEvent> vEvents)

Check if schedule conflict exists for OPAQUE events using default check quantity

Parameters:

vEvent - event to test

vEvents - existing events

Returns:

UID and start of recurrence of conflicting event, null otherwise

checkScheduleConflict

public static java.lang.String checkScheduleConflict(VEvent vEvent,
                                                     java.util.List<VEvent> vEvents,
                                                     int checkQuantity)

Check if schedule conflict exists for OPAQUE events.

Parameters:

vEvent - event to test

vEvents - existing events

checkQuantity - amount of recurrences to be tested

Returns:

UID and start of recurrence of conflicting event, null otherwise

checkScheduleConflict2

public static java.lang.String checkScheduleConflict2(VEvent vEvent,
                                                      java.util.List<VEvent> vEvents,
                                                      int checkQuantity)

Check if schedule conflict exists for OPAQUE events. Finds conflict faster, but not necessarily the first conflict that occurs

Parameters:

vEvent - event to test

vEvents - existing events

checkQuantity - amount of recurrences to be tested

Returns:

UID and start of recurrence of conflicting event, null otherwise

weekOrdinalInMonth

public static int weekOrdinalInMonth(java.time.temporal.Temporal dateBasedTemporal)

returns week of month. For example, a LocalDate representing March 10, 2016 returns 2, for the 2nd Thursday.

Parameters:

dateBasedTemporal - - date based Temporal, such as LocalDate

Returns:

temporalAmountBetween

public static java.time.temporal.TemporalAmount temporalAmountBetween(java.time.temporal.Temporal startInclusive,
                                                                      java.time.temporal.Temporal endExclusive)

Calculate TemporalAmount between two Temporals. Both temporals must be the same type and representations of a DateTimeType.

Parameters:

startInclusive - - the start temporal, not null

endExclusive - - the end temporal, not null

Returns:

parse

public static java.time.temporal.Temporal parse(java.lang.String temporalString,
                                                java.time.ZoneId zone)

parseOld

public static java.time.temporal.Temporal parseOld(java.lang.String temporalString)

temporalToString

public static java.lang.String temporalToString(java.time.temporal.Temporal temporal)

produced ISO.8601 date and date-time string for given Temporal of type LocalDate, LocalDateTime or ZonedDateTime

Parameters:

temporal -

Returns:

temporalFromString

public static java.time.temporal.Temporal temporalFromString(java.lang.String string)

Parse ISO.8601 string into LocalDate, LocalDateTime or ZonedDateTime Temporal object.

dayOfWeekFromAbbreviation

public static java.time.DayOfWeek dayOfWeekFromAbbreviation(java.lang.String dayOfWeekAbbreviation)

Convert 2-character string to DayOfWeek following below convention: weekday = "SU" / "MO" / "TU" / "WE" / "TH" / "FR" / "SA" Corresponding to SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, and SATURDAY days of the week.

Parameters:

dayOfWeekAbbreviation - - 2 character abbreviation representing day of the week

Returns:

toLocalDateTime

@Deprecated
public static java.time.LocalDateTime toLocalDateTime(java.time.temporal.Temporal temporal)

Deprecated.

Returns LocalDateTime from Temporal that is an instance of either LocalDate, LocalDateTime or ZonedDateTime If the parameter is type LocalDate the returned LocalDateTime is atStartofDay. If the parameter is type ZonedDateTime the zoneID is changed to ZoneId.systemDefault() before taking the LocalDateTime.

format

@Deprecated
public static java.lang.String format(java.time.temporal.Temporal temporal)

Deprecated.

produced ISO.8601 date and date-time string for given Temporal of type LocalDate, LocalDateTime or ZonedDateTime

Parameters:

temporal -

Returns:

dateTimePropertyTag

@Deprecated
public static java.lang.String dateTimePropertyTag(java.lang.String propertyName,
                                                                java.time.temporal.Temporal temporal)

Deprecated.

Produces property name and attribute, if necessary. For example: LocalDate : DTSTART;VALUE=DATE: LocalDateTime : DTSTART: ZonedDateTime (UTC) : DTSTART: ZonedDateTime : DTEND;TZID=America/New_York:

Parameters:

propertyName -

temporal - - temporal of LocalDate, LocalDateTime or ZonedDateTime

Returns: