GeneralizedTime

java.lang.Object
- org.apache.directory.api.util.GeneralizedTime

All Implemented Interfaces:: java.lang.Comparable<GeneralizedTime>

public class GeneralizedTime
extends java.lang.Object
implements java.lang.Comparable<GeneralizedTime>

This class represents the generalized time syntax as defined in RFC 4517 section 3.3.13.

The date, time and time zone information is internally backed by an Calendar object

Leap seconds are not supported, as Calendar does not support leap seconds.

 3.3.13.  Generalized Time

  A value of the Generalized Time syntax is a character string
  representing a date and time.  The LDAP-specific encoding of a value
  of this syntax is a restriction of the format defined in [ISO8601],
  and is described by the following ABNF:

     GeneralizedTime = century year month day hour
                          [ minute [ second / leap-second ] ]
                          [ fraction ]
                          g-time-zone

     century = 2(%x30-39) ; "00" to "99"
     year    = 2(%x30-39) ; "00" to "99"
     month   =   ( %x30 %x31-39 ) ; "01" (January) to "09"
               / ( %x31 %x30-32 ) ; "10" to "12"
     day     =   ( %x30 %x31-39 )    ; "01" to "09"
               / ( %x31-32 %x30-39 ) ; "10" to "29"
               / ( %x33 %x30-31 )    ; "30" to "31"
     hour    = ( %x30-31 %x30-39 ) / ( %x32 %x30-33 ) ; "00" to "23"
     minute  = %x30-35 %x30-39                        ; "00" to "59"

     second      = ( %x30-35 %x30-39 ) ; "00" to "59"
     leap-second = ( %x36 %x30 )       ; "60"

     fraction        = ( DOT / COMMA ) 1*(%x30-39)
     g-time-zone     = %x5A  ; "Z"
                       / g-differential
     g-differential  = ( MINUS / PLUS ) hour [ minute ]
     MINUS           = %x2D  ; minus sign ("-")

  The , , and  rules are defined in [RFC4512].

  The above ABNF allows character strings that do not represent valid
  dates (in the Gregorian calendar) and/or valid times (e.g., February
  31, 1994).  Such character strings SHOULD be considered invalid for
  this syntax.

  The time value represents coordinated universal time (equivalent to
  Greenwich Mean Time) if the "Z" form of  is used;
  otherwise, the value represents a local time in the time zone
  indicated by .  In the latter case, coordinated
  universal time can be calculated by subtracting the differential from
  the local time.  The "Z" form of  SHOULD be used in
  preference to .

  If  is omitted, then  represents a fraction of an
  hour; otherwise, if  and  are omitted, then
   represents a fraction of a minute; otherwise, 
  represents a fraction of a second.

     Examples:
        199412161032Z
        199412160532-0500

  Both example values represent the same coordinated universal time:
  10:32 AM, December 16, 1994.

  The LDAP definition for the Generalized Time syntax is:

     ( 1.3.6.1.4.1.1466.115.121.1.24 DESC 'Generalized Time' )

  This syntax corresponds to the GeneralizedTime ASN.1 type from
  [ASN.1], with the constraint that local time without a differential
  SHALL NOT be used.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`GeneralizedTime.Format` The format of the generalized time.
`static class`	`GeneralizedTime.FractionDelimiter` The fraction delimiter of the generalized time.
`static class`	`GeneralizedTime.TimeZoneFormat` The time zone format of the generalized time.

Field Summary

Fields
Modifier and Type	Field and Description
`private java.util.Calendar`	`calendar` The calendar
`private GeneralizedTime.Format`	`upFormat` The user provided format
`private GeneralizedTime.FractionDelimiter`	`upFractionDelimiter` The user provided fraction delimiter
`private int`	`upFractionLength` the user provided fraction length
`private java.lang.String`	`upGeneralizedTime` The user provided value
`private GeneralizedTime.TimeZoneFormat`	`upTimeZoneFormat` The user provided time zone format

Constructor Summary

Constructors
Constructor and Description
`GeneralizedTime(java.util.Calendar calendar)` Creates a new instance of GeneralizedTime, based on the given Calendar object.
`GeneralizedTime(java.util.Date date)` Creates a new instance of GeneralizedTime by setting the date to an instance of Calendar.
`GeneralizedTime(java.lang.String generalizedTime)` Creates a new instance of GeneralizedTime, based on the given generalized time string.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`compareTo(GeneralizedTime other)` Compares this GeneralizedTime object with the specified GeneralizedTime object.
`boolean`	`equals(java.lang.Object obj)`
`private java.lang.String`	`getAllDigits(int startIndex)`
`java.util.Calendar`	`getCalendar()` Gets the calendar.
`java.util.Date`	`getDate()`
`static java.util.Date`	`getDate(java.lang.String zuluTime)`
`int`	`getDay()`
`private GeneralizedTime.Format`	`getFormatWithoutFraction(GeneralizedTime.Format f)` Gets the corresponding format with fraction.
`int`	`getFraction()`
`private java.lang.String`	`getFraction(int startIndex)`
`int`	`getHour()`
`int`	`getMinutes()`
`int`	`getMonth()`
`int`	`getSeconds()`
`long`	`getTime()`
`int`	`getYear()`
`int`	`hashCode()`
`private void`	`parseDay()`
`private void`	`parseFractionDelmiter(int fractionDelimiterPos)`
`private void`	`parseFractionOfHour()`
`private void`	`parseFractionOfMinute()`
`private void`	`parseFractionOfSecond()`
`private void`	`parseHour()`
`private void`	`parseMinute()`
`private void`	`parseMonth()`
`private void`	`parseSecond()`
`private void`	`parseTimezone(int pos)`
`private void`	`parseYear()`
`private void`	`setUp(java.util.Calendar newCalendar)`
`java.lang.String`	`toGeneralizedTime()` Returns the string representation of this generalized time.
`java.lang.String`	`toGeneralizedTime(GeneralizedTime.Format format, GeneralizedTime.FractionDelimiter fractionDelimiter, int fractionLength, GeneralizedTime.TimeZoneFormat timeZoneFormat)` Returns the string representation of this generalized time.
`java.lang.String`	`toGeneralizedTimeWithoutFraction()` Returns the string representation of this generalized time.
`java.lang.String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - upGeneralizedTime
```
private java.lang.String upGeneralizedTime
```
    The user provided value
  - upFormat
```
private GeneralizedTime.Format upFormat
```
    The user provided format
  - upTimeZoneFormat
```
private GeneralizedTime.TimeZoneFormat upTimeZoneFormat
```
    The user provided time zone format
  - upFractionDelimiter
```
private GeneralizedTime.FractionDelimiter upFractionDelimiter
```
    The user provided fraction delimiter
  - upFractionLength
```
private int upFractionLength
```
    the user provided fraction length
  - calendar
```
private java.util.Calendar calendar
```
    The calendar
- Constructor Detail
  - GeneralizedTime
```
public GeneralizedTime(java.util.Date date)
```
    Creates a new instance of GeneralizedTime by setting the date to an instance of Calendar.
    
    Parameters:
    
    date - the date
    
    See Also:
    
    GeneralizedTime(Calendar)
  - GeneralizedTime
```
public GeneralizedTime(java.util.Calendar calendar)
```
    Creates a new instance of GeneralizedTime, based on the given Calendar object. Uses
```
Format.YEAR_MONTH_DAY_HOUR_MIN_SEC
```
    as default format and
```
TimeZoneFormat.Z
```
    as default time zone format.
    Parameters:
    
    calendar - the calendar containing the date, time and timezone information
  - GeneralizedTime
```
public GeneralizedTime(java.lang.String generalizedTime)
                throws java.text.ParseException
```
    Creates a new instance of GeneralizedTime, based on the given generalized time string.
    
    Parameters:
    
    generalizedTime - the generalized time
    
    Throws:
    
    java.text.ParseException - if the given generalized time can't be parsed.
- Method Detail
  - setUp
```
private void setUp(java.util.Calendar newCalendar)
```
  - parseTimezone
```
private void parseTimezone(int pos)
                    throws java.text.ParseException
```
    Throws:
    
    java.text.ParseException
  - parseFractionOfSecond
```
private void parseFractionOfSecond()
                            throws java.text.ParseException
```
    Throws:
    
    java.text.ParseException
  - parseFractionOfMinute
```
private void parseFractionOfMinute()
                            throws java.text.ParseException
```
    Throws:
    
    java.text.ParseException
  - parseFractionOfHour
```
private void parseFractionOfHour()
                          throws java.text.ParseException
```
    Throws:
    
    java.text.ParseException
  - parseFractionDelmiter
```
private void parseFractionDelmiter(int fractionDelimiterPos)
```
  - getFraction
```
private java.lang.String getFraction(int startIndex)
                              throws java.text.ParseException
```
    Throws:
    
    java.text.ParseException
  - getAllDigits
```
private java.lang.String getAllDigits(int startIndex)
```
  - parseSecond
```
private void parseSecond()
                  throws java.text.ParseException
```
    Throws:
    
    java.text.ParseException
  - parseMinute
```
private void parseMinute()
                  throws java.text.ParseException
```
    Throws:
    
    java.text.ParseException
  - parseHour
```
private void parseHour()
                throws java.text.ParseException
```
    Throws:
    
    java.text.ParseException
  - parseDay
```
private void parseDay()
               throws java.text.ParseException
```
    Throws:
    
    java.text.ParseException
  - parseMonth
```
private void parseMonth()
                 throws java.text.ParseException
```
    Throws:
    
    java.text.ParseException
  - parseYear
```
private void parseYear()
                throws java.text.ParseException
```
    Throws:
    
    java.text.ParseException
  - toGeneralizedTime
```
public java.lang.String toGeneralizedTime()
```
    Returns the string representation of this generalized time. This method uses the same format as the user provided format.
    
    Returns:
    
    the string representation of this generalized time
  - toGeneralizedTimeWithoutFraction
```
public java.lang.String toGeneralizedTimeWithoutFraction()
```
    Returns the string representation of this generalized time. This method uses the same format as the user provided format.
    
    Returns:
    
    the string representation of this generalized time
  - getFormatWithoutFraction
```
private GeneralizedTime.Format getFormatWithoutFraction(GeneralizedTime.Format f)
```
    Gets the corresponding format with fraction.
    
    Parameters:
    
    f - the format
    
    Returns:
    
    the corresponding format without fraction
  - toGeneralizedTime
```
public java.lang.String toGeneralizedTime(GeneralizedTime.Format format,
                                          GeneralizedTime.FractionDelimiter fractionDelimiter,
                                          int fractionLength,
                                          GeneralizedTime.TimeZoneFormat timeZoneFormat)
```
    Returns the string representation of this generalized time.
    
    Parameters:
    
    format - the target format
    
    fractionDelimiter - the target fraction delimiter, may be null
    
    fractionLength - the fraction length
    
    timeZoneFormat - the target time zone format
    
    Returns:
    
    the string
  - getCalendar
```
public java.util.Calendar getCalendar()
```
    Gets the calendar. It could be used to manipulate this GeneralizedTime settings.
    
    Returns:
    
    the calendar
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Overrides:
    
    equals in class java.lang.Object
  - compareTo
```
public int compareTo(GeneralizedTime other)
```
    Compares this GeneralizedTime object with the specified GeneralizedTime object.
    
    Specified by:
    
    compareTo in interface java.lang.Comparable<GeneralizedTime>
    
    Parameters:
    
    other - the other GeneralizedTime object
    
    Returns:
    
    a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified object.
    
    See Also:
    
    Comparable.compareTo(java.lang.Object)
  - getTime
```
public long getTime()
```
  - getDate
```
public java.util.Date getDate()
```
  - getYear
```
public int getYear()
```
  - getMonth
```
public int getMonth()
```
  - getDay
```
public int getDay()
```
  - getHour
```
public int getHour()
```
  - getMinutes
```
public int getMinutes()
```
  - getSeconds
```
public int getSeconds()
```
  - getFraction
```
public int getFraction()
```
  - getDate
```
public static java.util.Date getDate(java.lang.String zuluTime)
                              throws java.text.ParseException
```
    Parameters:
    
    zuluTime -
    
    Returns:
    
    Throws:
    
    java.text.ParseException

Class GeneralizedTime

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

upGeneralizedTime

upFormat

upTimeZoneFormat

upFractionDelimiter

upFractionLength

calendar

Constructor Detail

GeneralizedTime

GeneralizedTime

GeneralizedTime

Method Detail

setUp

parseTimezone

parseFractionOfSecond

parseFractionOfMinute

parseFractionOfHour

parseFractionDelmiter

getFraction

getAllDigits

parseSecond

parseMinute

parseHour

parseDay

parseMonth

parseYear

toGeneralizedTime

toGeneralizedTimeWithoutFraction

getFormatWithoutFraction

toGeneralizedTime

getCalendar

toString

hashCode

equals

compareTo

getTime

getDate

getYear

getMonth

getDay

getHour

getMinutes

getSeconds

getFraction

getDate