Constructor Detail

• ASN1UTCTime

  public ASN1UTCTime​(java.lang.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.

• ASN1UTCTime

  public ASN1UTCTime​(java.util.Date time)

  Base constructor from a java.util.date object

  Parameters:

  time - the Date to build the time from.

• ASN1UTCTime

  public ASN1UTCTime​(java.util.Date time,
                     java.util.Locale locale)

  Base constructor from a java.util.date and Locale - you may need to use this if the default locale doesn't use a Gregorian calender so that the GeneralizedTime produced is compatible with other ASN.1 implementations.

  Parameters:

  time - a date object representing the time of interest.

  locale - an appropriate Locale for producing an ASN.1 UTCTime value.

Method Detail

• getInstance

  public static ASN1UTCTime getInstance​(java.lang.Object obj)

  Return an UTC Time from the passed in object.

  Parameters:

  obj - an ASN1UTCTime or an object that can be converted into one.

  Returns:

  an ASN1UTCTime instance, or null.

  Throws:

  java.lang.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.

  Returns:

  an ASN1UTCTime instance, or null.

  Throws:

  java.lang.IllegalArgumentException - if the tagged object cannot be converted.

• getDate

  public java.util.Date getDate()
                         throws java.text.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:

  java.text.ParseException - if the date string cannot be parsed.

• getAdjustedDate

  public java.util.Date getAdjustedDate()
                                 throws java.text.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:

  java.text.ParseException - if the date string cannot be parsed.

• getTime

  public java.lang.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 java.lang.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()

  Specified by:

  hashCode in class ASN1Primitive

• toString

  public java.lang.String toString()

  Overrides:

  toString in class java.lang.Object