Class ASN1UTCTime

  • All Implemented Interfaces:
    io.anyline.nfc.bouncycastle.asn1.ASN1Encodable , io.anyline.nfc.bouncycastle.util.Encodable

    
    public class ASN1UTCTime
    extends ASN1Primitive
                        

    - * UTC time object. Internal facade of ASN1UTCTime.

    This datatype is valid only from 1950-01-01 00:00:00 UTC until 2049-12-31 23:59:59 UTC.

    X.690

    11: Restrictions on BER employed by both CER and DER

    11.8 UTCTime

    11.8.1 The encoding shall terminate with "Z", as described in the ITU-T X.680 | ISO/IEC 8824-1 clause on UTCTime.

    11.8.2 The seconds element shall always be present.

    11.8.3 Midnight (GMT) shall be represented in the form:

    "YYMMDD000000Z" where "YYMMDD" represents the day following the midnight in question.
    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
    • Field Summary

      Fields 
      Modifier and Type Field Description
    • Constructor Summary

      Constructors 
      Constructor Description
      ASN1UTCTime(String time) The correct format for this is YYMMDDHHMMSSZ (it used to be that seconds were never encoded.
      ASN1UTCTime(Date time) Base constructor from a java.util.
      ASN1UTCTime(Date time, 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.
    • Enum Constant Summary

      Enum Constants 
      Enum Constant Description
    • Method Summary

      Modifier and Type Method Description
      static ASN1UTCTime getInstance(Object obj) Return an UTC Time from the passed in object.
      static ASN1UTCTime getInstance(ASN1TaggedObject taggedObject, boolean explicit) Return an UTC Time from a tagged object.
      Date getDate() Return the time as a date based on whatever a 2 digit year will return.
      Date getAdjustedDate() Return the time as an adjusted date in the range of 1950 - 2049.
      String getTime() Return the time - always in the form of YYMMDDhhmmssGMT(+hh:mm|-hh:mm).
      String getAdjustedTime() Return a time string as an adjusted date with a 4 digit year.
      int hashCode()
      String toString()
      • Methods inherited from class io.anyline.nfc.bouncycastle.asn1.ASN1Primitive

        encodeTo, encodeTo, equals, equals, equals, fromByteArray, toASN1Primitive
      • Methods inherited from class io.anyline.nfc.bouncycastle.asn1.ASN1Object

        equals, getEncoded, getEncoded
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • ASN1UTCTime

        ASN1UTCTime(String time)
        The correct format for this is YYMMDDHHMMSSZ (it used to be that seconds were never encoded.
        Parameters:
        time - the time string.
      • ASN1UTCTime

        ASN1UTCTime(Date time)
        Base constructor from a java.util.
        Parameters:
        time - the Date to build the time from.
      • ASN1UTCTime

        ASN1UTCTime(Date time, 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

         static ASN1UTCTime getInstance(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.

      • getInstance

         static ASN1UTCTime getInstance(ASN1TaggedObject taggedObject, boolean explicit)

        Return an UTC Time from a tagged object.

        Parameters:
        taggedObject - 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.

      • getDate

         Date getDate()

        Return the time as a date based on whatever a 2 digit year will return. For standardised processing use getAdjustedDate().

        Returns:

        the resulting date

      • getAdjustedDate

         Date getAdjustedDate()

        Return the time as an adjusted date in the range of 1950 - 2049.

        Returns:

        a date in the range of 1950 to 2049.

      • getTime

         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

         String getAdjustedTime()

        Return a time string as an adjusted date with a 4 digit year. This goes in the range of 1950 - 2049.