Package org.bouncycastle.asn1

Class ASN1GeneralizedTime

  • All Implemented Interfaces:
    ASN1Encodable, Encodable
    Direct Known Subclasses:
    DERGeneralizedTime
    public class ASN1GeneralizedTime
extends ASN1Primitive
    Base class representing the ASN.1 GeneralizedTime type.

    The main difference between these and UTC time is a 4 digit year.

    • Constructor Detail

      • ASN1GeneralizedTime

        public ASN1GeneralizedTime​(String time)
        The correct format for this is YYYYMMDDHHMMSS[.f]Z, or without the Z for local time, or Z+-HHMM on the end, for difference between local time and UTC time. The fractional second amount f must consist of at least one number with trailing zeroes removed.
        Parameters:
        time - the time string.
        Throws:
        IllegalArgumentException - if String is an illegal format.

      • ASN1GeneralizedTime

        public ASN1GeneralizedTime​(Date time)
        Base constructor from a java.util.date object
        Parameters:
        time - a date object representing the time of interest.

      • ASN1GeneralizedTime

        public ASN1GeneralizedTime​(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 GeneralizedTime value.

    • Method Detail

      • getInstance

        public static ASN1GeneralizedTime getInstance​(Object obj)
        return a generalized time from the passed in object
        Parameters:
        obj - an ASN1GeneralizedTime or an object that can be converted into one.
        Returns:
        an ASN1GeneralizedTime instance, or null.
        Throws:
        IllegalArgumentException - if the object cannot be converted.

      • getInstance

        public static ASN1GeneralizedTime getInstance​(ASN1TaggedObject obj,
                                              boolean explicit)
        return a Generalized Time object 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 ASN1GeneralizedTime instance.
        Throws:
        IllegalArgumentException - if the tagged object cannot be converted.

      • getTimeString

        public String getTimeString()
        Return the time.
        Returns:
        The time string as it appeared in the encoded object.

      • getTime

        public String getTime()
        return the time - always in the form of YYYYMMDDhhmmssGMT(+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("yyyyMMddHHmmssz");
        To read in the time and get a date which is compatible with our local time zone.

      • 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)