Package oracle.rules.rl.extensions

Class Duration

java.lang.Object
oracle.rules.rl.extensions.Duration
Direct Known Subclasses:
OracleDuration
public class Duration extends Object
RL Duration supports xml schema yearMonthDuration or dayTimeDuration. You cannot mix yearMonthDuration and dayTimeDuration. Doing so may result in IllegalStateException RL Duration also supports static methods for getting the duration as numbers of hours, days, etc. between 2 calendars (avoiding Duration objects).

  • Constructor Details

    • Duration

      public Duration()

  • Method Details

    • yearsBetween

      public static int yearsBetween(XMLGregorianCalendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in years. The difference may be negative if date1 is later than date2. Any resulting fractional year is truncated. date1 and date2 are converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of years between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • yearsBetween

      public static int yearsBetween(Calendar date1, Calendar date2)
      Returns the difference between the two dates in years. The difference may be negative if date1 is later than date2. Any resulting fractional year is truncated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of years between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • yearsBetween

      public static int yearsBetween(XMLGregorianCalendar date1, Calendar date2)
      Returns the difference between the two dates in years. The difference may be negative if date1 is later than date2. Any resulting fractional year is truncated. date1 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of years between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • yearsBetween

      public static int yearsBetween(Calendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in years. The difference may be negative if date1 is later than date2. Any resulting fractional year is truncated. date2 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of years between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • monthsBetween

      public static int monthsBetween(XMLGregorianCalendar date1, Calendar date2)
      Returns the difference between the two dates in months. The difference may be negative if date1 is later than date2. Any resulting fractional month is truncated. date1 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of months between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • monthsBetween

      public static int monthsBetween(Calendar date1, Calendar date2)
      Returns the difference between the two dates in months. The difference may be negative if date1 is later than date2. Any resulting fractional month is truncated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of months between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • monthsBetween

      public static int monthsBetween(XMLGregorianCalendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in months. The difference may be negative if date1 is later than date2. Any resulting fractional month is truncated. date1 and date2 are converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of months between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • monthsBetween

      public static int monthsBetween(Calendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in months. The difference may be negative if date1 is later than date2. Any resulting fractional month is truncated. date2 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of months between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • weeksBetween

      public static int weeksBetween(XMLGregorianCalendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in weeks. The difference may be negative if date1 is later than date2. Any resulting fractional week is truncated. date1 and date2 are converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of weeks between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • weeksBetween

      public static int weeksBetween(Calendar date1, Calendar date2)
      Returns the difference between the two dates in weeks. The difference may be negative if date1 is later than date2. Any resulting fractional week is truncated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of weeks between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • weeksBetween

      public static int weeksBetween(XMLGregorianCalendar date1, Calendar date2)
      Returns the difference between the two dates in weeks. The difference may be negative if date1 is later than date2. Any resulting fractional week is truncated. date1 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of weeks between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • weeksBetween

      public static int weeksBetween(Calendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in weeks. The difference may be negative if date1 is later than date2. Any resulting fractional week is truncated. date2 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of weeks between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • daysBetween

      public static int daysBetween(Calendar date1, Calendar date2)

    • hoursBetween

      public static long hoursBetween(XMLGregorianCalendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in hours. The difference may be negative if date1 is later than date2. Any resulting fractional hour is truncated. date1 and date2 are converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of hours between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • hoursBetween

      public static long hoursBetween(Calendar date1, Calendar date2)
      Returns the difference between the two dates in hours. The difference may be negative if date1 is later than date2. Any resulting fractional hour is truncated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of hours between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • daysBetween

      public static int daysBetween(XMLGregorianCalendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in days. The difference may be negative if date1 is later than date2. Any resulting fractional day is truncated. date1 and date2 are converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of days between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • daysBetween

      public static int daysBetween(XMLGregorianCalendar date1, Calendar date2)
      Returns the difference between the two dates in days. The difference may be negative if date1 is later than date2. Any resulting fractional day is truncated. date1 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of days between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • daysBetween

      public static int daysBetween(Calendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in days. The difference may be negative if date1 is later than date2. Any resulting fractional day is truncated. date2 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of days between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • hoursBetween

      public static long hoursBetween(XMLGregorianCalendar date1, Calendar date2)
      Returns the difference between the two dates in hours. The difference may be negative if date1 is later than date2. Any resulting fractional hour is truncated. date1 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of hours between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • hoursBetween

      public static long hoursBetween(Calendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in hours. The difference may be negative if date1 is later than date2. Any resulting fractional hour is truncated. date2 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of hours between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • minutesBetween

      public static long minutesBetween(Calendar date1, Calendar date2)
      Returns the difference between the two dates in minutes. The difference may be negative if date1 is later than date2. Any resulting fractional minute is truncated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of minutes between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • minutesBetween

      public static long minutesBetween(XMLGregorianCalendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in minutes. The difference may be negative if date1 is later than date2. Any resulting fractional minute is truncated. date1 and date2 are converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of minutes between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • minutesBetween

      public static long minutesBetween(XMLGregorianCalendar date1, Calendar date2)
      Returns the difference between the two dates in minutes. The difference may be negative if date1 is later than date2. Any resulting fractional minute is truncated. date1 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of minutes between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • minutesBetween

      public static long minutesBetween(Calendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in minutes. The difference may be negative if date1 is later than date2. Any resulting fractional minute is truncated. date2 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of minutes between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • secondsBetween

      public static long secondsBetween(XMLGregorianCalendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in seconds. The difference may be negative if date1 is later than date2. Any resulting fractional second is truncated. date1 and date2 are converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of seconds between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • secondsBetween

      public static long secondsBetween(Calendar date1, Calendar date2)
      Returns the difference between the two dates in seconds. The difference may be negative if date1 is later than date2. Any resulting fractional second is truncated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of seconds between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • secondsBetween

      public static long secondsBetween(XMLGregorianCalendar date1, Calendar date2)
      Returns the difference between the two dates in seconds. The difference may be negative if date1 is later than date2. Any resulting fractional second is truncated. date1 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of seconds between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • secondsBetween

      public static long secondsBetween(Calendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in seconds. The difference may be negative if date1 is later than date2. Any resulting fractional second is truncated. date2 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of seconds between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • millisecondsBetween

      public static long millisecondsBetween(XMLGregorianCalendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in milliseconds. The difference may be negative if date1 is later than date2. date1 and date2 are converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of milliseconds between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • millisecondsBetween

      public static long millisecondsBetween(Calendar date1, Calendar date2)
      Returns the difference between the two dates in milliseconds. The difference may be negative if date1 is later than date2.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of milliseconds between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • millisecondsBetween

      public static long millisecondsBetween(XMLGregorianCalendar date1, Calendar date2)
      Returns the difference between the two dates in milliseconds. The difference may be negative if date1 is later than date2. date1 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of milliseconds between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • millisecondsBetween

      public static long millisecondsBetween(Calendar date1, XMLGregorianCalendar date2)
      Returns the difference between the two dates in milliseconds. The difference may be negative if date1 is later than date2. date2 is converted to GregorianCalendar before the difference is calculated.
      Parameters:
      date1 -
      date2 -
      Returns:
      the number of milliseconds between the date1 and date2.
      Throws:
      NullPointerException - if either date1 or date2 is null.

    • compare

      public static int compare(Calendar date1, Calendar date2)
      Compares two dates and returns an int value
      • of 0 if they are equal,
      • less than 0 if date1 represents a point in time before date2,
      • greater than 0 if date1 represents a point in time after date2.
      Parameters:
      date1 -
      date2 -
      Returns:
      the relative comparison result.

    • compare

      public static int compare(XMLGregorianCalendar date1, XMLGregorianCalendar date2)
      Compares two dates and returns an int value
      • of 0 if they are equal,
      • less than 0 if date1 represents a point in time before date2,
      • greater than 0 if date1 represents a point in time after date2.
      Parameters:
      date1 -
      date2 -
      Returns:
      the relative comparison result.

    • compare

      public static int compare(XMLGregorianCalendar date1, Calendar date2)
      Compares two dates and returns an int value
      • of 0 if they are equal,
      • less than 0 if date1 represents a point in time before date2,
      • greater than 0 if date1 represents a point in time after date2.
      Parameters:
      date1 -
      date2 -
      Returns:
      the relative comparison result.

    • compare

      public static int compare(Calendar date1, XMLGregorianCalendar date2)
      Compares two dates and returns an int value
      • of 0 if they are equal,
      • less than 0 if date1 represents a point in time before date2,
      • greater than 0 if date1 represents a point in time after date2.
      Parameters:
      date1 -
      date2 -
      Returns:
      the relative comparison result.

    • between

      public static Duration between(Calendar date1, Calendar date2)
      Compute XML dayTimeDuration between 2 dates. Result will be negative if date1 > date2.
      Parameters:
      date1 - first (earlier) date
      date2 - second (later) date
      Returns:
      XML Duration

    • between

      public static Duration between(XMLGregorianCalendar date1, Calendar date2)
      Compute XML dayTimeDuration between 2 dates. Result will be negative if date1 > date2.
      Parameters:
      date1 - first (earlier) date
      date2 - second (later) date
      Returns:
      XML Duration

    • between

      public static Duration between(Calendar date1, XMLGregorianCalendar date2)
      Compute XML dayTimeDuration between 2 dates. Result will be negative if date1 > date2.
      Parameters:
      date1 - first (earlier) date
      date2 - second (later) date
      Returns:
      XML Duration

    • between

      public static Duration between(XMLGregorianCalendar date1, XMLGregorianCalendar date2)
      Compute XML dayTimeDuration between 2 dates. Result will be negative if date1 > date2.
      Parameters:
      date1 - first (earlier) date
      date2 - second (later) date
      Returns:
      XML Duration

    • fromString

      public static Duration fromString(String lexicalRepresentation)
      create an XML Duration from its lexical representation, e.g. P7DT6H is 7 days 6 hours.
      Parameters:
      lexicalRepresentation -
      Returns:

    • compareDurations

      public static int compareDurations(Duration duration1, Duration duration2)
      compare 2 XML durations.
      Parameters:
      duration1 -
      duration2 -
      Returns:
      -1, 0, or +1 depending on whether duration1 is <, ==, or > duration2, respectively.
      Throws:
      IllegalStateException - if the durations are not comparable, e.g. one is a dayTimeDuration and the other is a yearMonthDuration.

    • isDayTimeDuration

      public static boolean isDayTimeDuration(Duration xmlDuration)
      is the xml duration a dayTimeDuration?
      Parameters:
      xmlDuration -
      Returns:
      boolean

    • isYearMonthDuration

      public static boolean isYearMonthDuration(Duration xmlDuration)
      is the xml duration a yearMonthDuration?
      Parameters:
      xmlDuration -
      Returns:
      boolean

    • getSeconds

      public static BigDecimal getSeconds(Duration xmlDuration)
      Get the seconds from the duration as a BigDecimal.
      Parameters:
      xmlDuration -
      Returns:
      seconds, including fractional part

    • ratio

      public static BigDecimal ratio(Duration xmlDuration1, Duration xmlDuration2)
      Divide the first duration by the second duration
      Parameters:
      xmlDuration1 -
      xmlDuration2 -
      Returns:
      BigDecimal quotient

    • divide

      public static Duration divide(Duration dividend, int divisor)
      Divide the given duration by a number
      Parameters:
      dividend -
      divisor -
      Returns:
      Duration

    • divide

      public static Duration divide(Duration dividend, double divisor)
      Divide the given duration by a number
      Parameters:
      dividend -
      divisor -
      Returns:
      Duration

    • multiply

      public static Duration multiply(Duration duration, int factor)
      Multiply the given duration by a number
      Parameters:
      duration -
      factor -
      Returns:
      Duration

    • multiply

      public static Duration multiply(Duration duration, BigDecimal factor)
      Multiply the given duration by a number
      Parameters:
      duration -
      factor -
      Returns:
      Duration