Package org.forgerock.opendj.ldap

Class GeneralizedTime

java.lang.Object
org.forgerock.opendj.ldap.GeneralizedTime
All Implemented Interfaces:
Comparable<GeneralizedTime>
public final class GeneralizedTime extends Object implements Comparable<GeneralizedTime>
An LDAP generalized time as defined in RFC 4517. This class facilitates parsing of generalized time values to and from Date and Calendar classes.

The following are examples of generalized time values: 

 199412161032Z
 199412160532-0500
See Also:

  • Field Details

    • MIN_GENERALIZED_TIME

      public static final GeneralizedTime MIN_GENERALIZED_TIME
      The smallest time representable using the generalized time syntax.

    • MIN_GENERALIZED_TIME_MS

      public static final long MIN_GENERALIZED_TIME_MS
      The smallest time in milli-seconds representable using the generalized time syntax.

  • Method Details

    • currentTime

      public static GeneralizedTime currentTime()
      Returns a generalized time whose value is the current time, using the default time zone and locale.
      Returns:
      A generalized time whose value is the current time.

    • valueOf

      public static GeneralizedTime valueOf(Calendar calendar)
      Returns a generalized time representing the provided Calendar.
      Parameters:
      calendar - The calendar to be converted to a generalized time.
      Returns:
      A generalized time representing the provided Calendar.

    • valueOf

      public static GeneralizedTime valueOf(Date date)
      Returns a generalized time representing the provided Date.
      Parameters:
      date - The date to be converted to a generalized time.
      Returns:
      A generalized time representing the provided Date.

    • valueOf

      public static GeneralizedTime valueOf(long timeMS)
      Returns a generalized time representing the provided time in milliseconds since the epoch.
      Parameters:
      timeMS - The time to be converted to a generalized time.
      Returns:
      A generalized time representing the provided time in milliseconds since the epoch.

    • valueOf

      public static GeneralizedTime valueOf(Instant instant)
      Returns a generalized time representing the provided instant in milliseconds since the epoch.
      Parameters:
      instant - The instant to be converted to a generalized time.
      Returns:
      A generalized time representing the provided instant in milliseconds since the epoch.

    • valueOf

      public static GeneralizedTime valueOf(String time)
      Parses the provided string as an LDAP generalized time.
      Parameters:
      time - The generalized time value to be parsed.
      Returns:
      The parsed generalized time.
      Throws:
      LocalizedIllegalArgumentException - If time cannot be parsed as a valid generalized time string.
      NullPointerException - If time was null.

    • valueOf

      public static GeneralizedTime valueOf(OffsetDateTime offsetDateTime)
      Returns a generalized time representing the provided OffsetDateTime.
      Parameters:
      offsetDateTime - The OffsetDateTime to be converted to a generalized time.
      Returns:
      A generalized time representing the provided OffsetDateTime.
      See Also:

    • getTimeInMillis

      public long getTimeInMillis()
      Returns the value of this generalized time in milliseconds since the epoch.
      Returns:
      The value of this generalized time in milliseconds since the epoch.

    • toOffsetDateTime

      public OffsetDateTime toOffsetDateTime()
      Returns a OffsetDateTime representation of this generalized time.
      Returns:
      A OffsetDateTime representation of this generalized time.
      See Also:

    • toCalendar

      public Calendar toCalendar()
      Returns a Calendar representation of this generalized time.

      Subsequent modifications to the returned calendar will not alter the internal state of this generalized time.

      Returns:
      A Calendar representation of this generalized time.

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • compareTo

      public int compareTo(GeneralizedTime o)
      Specified by:
      compareTo in interface Comparable<GeneralizedTime>

    • toString

      public String toString()
      Overrides:
      toString in class Object