Package org.bouncycastle.asn1

Class DERUTCTime

java.lang.Object
org.bouncycastle.asn1.ASN1Object
org.bouncycastle.asn1.ASN1Primitive
org.bouncycastle.asn1.DERUTCTime
All Implemented Interfaces:
ASN1Encodable
Direct Known Subclasses:
ASN1UTCTime
public class DERUTCTime
extends ASN1Primitive
UTC time object.

  • Constructor Details

    • DERUTCTime

      public DERUTCTime​(String time)
      The correct format for this is YYMMDDHHMMSSZ (it used to be that seconds were never encoded. When you're creating one of these objects from scratch, that's what you want to use, otherwise we'll try to deal with whatever gets read from the input stream... (this is why the input format is different from the getTime() method output).

      Parameters:
      time - the time string.

    • DERUTCTime

      public DERUTCTime​(Date time)
      base constructer from a java.util.date object

  • Method Details

    • getInstance

      public static ASN1UTCTime getInstance​(Object obj)
      return an UTC Time from the passed in object.
      Throws:
      IllegalArgumentException - if the object cannot be converted.

    • getInstance

      public static ASN1UTCTime getInstance​(ASN1TaggedObject obj, boolean explicit)
      return an UTC Time from a tagged object.
      Parameters:
      obj - the tagged object holding the object we want
      explicit - true if the object is meant to be explicitly tagged false otherwise.
      Throws:
      IllegalArgumentException - if the tagged object cannot be converted.

    • getDate

      public Date getDate() throws ParseException
      return the time as a date based on whatever a 2 digit year will return. For standardised processing use getAdjustedDate().
      Returns:
      the resulting date
      Throws:
      ParseException - if the date string cannot be parsed.

    • getAdjustedDate

      public Date getAdjustedDate() throws ParseException
      return the time as an adjusted date in the range of 1950 - 2049.
      Returns:
      a date in the range of 1950 to 2049.
      Throws:
      ParseException - if the date string cannot be parsed.

    • getTime

      public String getTime()
      return the time - always in the form of YYMMDDhhmmssGMT(+hh:mm|-hh:mm).

      Normally in a certificate we would expect "Z" rather than "GMT", however adding the "GMT" means we can just use: 

           dateF = new SimpleDateFormat("yyMMddHHmmssz");
      To read in the time and get a date which is compatible with our local time zone.

      Note: In some cases, due to the local date processing, this may lead to unexpected results. If you want to stick the normal convention of 1950 to 2049 use the getAdjustedTime() method.

    • getAdjustedTime

      public String getAdjustedTime()
      return a time string as an adjusted date with a 4 digit year. This goes in the range of 1950 - 2049.

    • hashCode

      public int hashCode()
      Description copied from class: Object
      Returns an integer hash code for this object. By contract, any two objects for which Object.equals(java.lang.Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

      Note that hash values must not change over time unless information used in equals comparisons also changes.

      See Writing a correct hashCode method if you intend implementing your own hashCode method.

      Specified by:
      hashCode in class ASN1Primitive
      Returns:
      this object's hash code.
      See Also:
      Object.equals(java.lang.Object)

    • toString

      public String toString()
      Description copied from class: Object
      Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression: 
         getClass().getName() + '@' + Integer.toHexString(hashCode())

      See Writing a useful toString method if you intend implementing your own toString method.

      Overrides:
      toString in class Object
      Returns:
      a printable representation of this object.