Bouncy Castle Provider (FIPS Distribution) 1.0.2.5 · org.bouncycastle.asn1.ASN1GeneralizedTime

Modifier and Type	Field and Description
protected byte[]	time

Access	Constructor and Description
public	ASN1GeneralizedTime(String the time 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.
public	ASN1GeneralizedTime(Date a date object representing the time of interest. time) Base constructor from a java.util.date object
public	ASN1GeneralizedTime(Date a date object representing the time of interest. time, Locale an appropriate Locale for producing an ASN.1 GeneralizedTime value. 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.
pack-priv	ASN1GeneralizedTime(byte[] bytes)

Method Summary

Modifier and Type	Method and Description
pack-priv boolean	asn1Equals(ASN1Primitive o) Implements abstract org.bouncycastle.asn1.ASN1Primitive.asn1Equals. Equality (similarity) comparison for two ASN1Primitive objects.
private String	calculateGMTOffset()
private String	convert(int time)
pack-priv void	encode(ASN1OutputStream out) Implements abstract org.bouncycastle.asn1.ASN1Primitive.encode.
pack-priv int	encodedLength() Implements abstract org.bouncycastle.asn1.ASN1Primitive.encodedLength. Return the length of the encoding this object will produce.
public Date	getDate()
public static ASN1GeneralizedTime	Returns: an ASN1GeneralizedTime instance, or null. getInstance(Object an ASN1GeneralizedTime or an object that can be converted into one. obj) return a generalized time from the passed in object
public static ASN1GeneralizedTime	Returns: an ASN1GeneralizedTime instance. getInstance(ASN1TaggedObject the tagged object holding the object we want obj, boolean true if the object is meant to be explicitly tagged false otherwise. explicit) return a Generalized Time object from a tagged object.
public String	Returns: a String representation of the time. getTime() return the time - always in the form of YYYYMMDDhhmmssGMT(+hh:mm\|-hh:mm).
public String	Returns: The time string as it appeared in the encoded object. getTimeString() Return the time.
protected boolean	hasFractionalSeconds()
public int	hashCode() Implements abstract org.bouncycastle.asn1.ASN1Primitive.hashCode. Returns a hash code value for this object.
protected boolean	hasMinutes()
protected boolean	hasSeconds()
pack-priv boolean	isConstructed() Implements abstract org.bouncycastle.asn1.ASN1Primitive.isConstructed. Return true if this objected is a CONSTRUCTED one, false otherwise.
private boolean	isDigit(int pos)
pack-priv ASN1Primitive	toDERObject() Overrides org.bouncycastle.asn1.ASN1Primitive.toDERObject. Return the current object as one which encodes using Distinguished Encoding Rules.

Inherited from org.bouncycastle.asn1.ASN1Primitive:: equals fromByteArray toASN1Primitive toDLObject

Field Detail

time	back to summary
protected byte[] time

Constructor Detail

ASN1GeneralizedTime	back to summary
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:String the time string. Exceptions IllegalArgumentException: if String is an illegal format.

ASN1GeneralizedTime

back to summary

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:String: the time string.

Exceptions

IllegalArgumentException:: if String is an illegal format.

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

ASN1GeneralizedTime

back to summary

public ASN1GeneralizedTime(Date time)

Base constructor from a java.util.date object

Parameters

time:Date: a date object representing the time of interest.

ASN1GeneralizedTime	back to summary
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:Date a date object representing the time of interest. locale:Locale an appropriate Locale for producing an ASN.1 GeneralizedTime value.

ASN1GeneralizedTime

back to summary

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:Date: a date object representing the time of interest.
locale:Locale: an appropriate Locale for producing an ASN.1 GeneralizedTime value.

ASN1GeneralizedTime	back to summary
pack-priv ASN1GeneralizedTime(byte[] bytes)

Method Detail

asn1Equals	back to summary
pack-priv boolean asn1Equals(ASN1Primitive o) Implements abstract org.bouncycastle.asn1.ASN1Primitive.asn1Equals. Doc from org.bouncycastle.asn1.ASN1Primitive.asn1Equals. Equality (similarity) comparison for two ASN1Primitive objects.

asn1Equals

back to summary

pack-priv boolean asn1Equals(ASN1Primitive o)

Implements abstract org.bouncycastle.asn1.ASN1Primitive.asn1Equals.

Doc from org.bouncycastle.asn1.ASN1Primitive.asn1Equals.

Equality (similarity) comparison for two ASN1Primitive objects.

calculateGMTOffset	back to summary
private String calculateGMTOffset()

convert	back to summary
private String convert(int time)

encode	back to summary
pack-priv void encode(ASN1OutputStream out) throws IOException Implements abstract org.bouncycastle.asn1.ASN1Primitive.encode.

encodedLength	back to summary
pack-priv int encodedLength() Implements abstract org.bouncycastle.asn1.ASN1Primitive.encodedLength. Doc from org.bouncycastle.asn1.ASN1Primitive.encodedLength. Return the length of the encoding this object will produce. Returns:int the length of the object's encoding.

encodedLength

back to summary

pack-priv int encodedLength()

Implements abstract org.bouncycastle.asn1.ASN1Primitive.encodedLength.

Doc from org.bouncycastle.asn1.ASN1Primitive.encodedLength.

Return the length of the encoding this object will produce.

Returns:int: the length of the object's encoding.

getDate	back to summary
public Date getDate() throws ParseException

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

getInstance

back to summary

public static ASN1GeneralizedTime getInstance(Object obj)

return a generalized time from the passed in object

Parameters

obj:Object: an ASN1GeneralizedTime or an object that can be converted into one.

Returns:ASN1GeneralizedTime

an ASN1GeneralizedTime instance, or null.

Exceptions

IllegalArgumentException:: if the object cannot be converted.

getInstance	back to summary
public static ASN1GeneralizedTime getInstance(ASN1TaggedObject obj, boolean explicit) return a Generalized Time object from a tagged object. Parameters obj:ASN1TaggedObject the tagged object holding the object we want explicit:boolean true if the object is meant to be explicitly tagged false otherwise. Returns:ASN1GeneralizedTime an ASN1GeneralizedTime instance. Exceptions IllegalArgumentException: if the tagged object cannot be converted.

getInstance

back to summary

public static ASN1GeneralizedTime getInstance(ASN1TaggedObject obj, boolean explicit)

return a Generalized Time object from a tagged object.

Parameters

obj:ASN1TaggedObject: the tagged object holding the object we want
explicit:boolean: true if the object is meant to be explicitly tagged false otherwise.

Returns:ASN1GeneralizedTime

an ASN1GeneralizedTime instance.

Exceptions

IllegalArgumentException:: if the tagged object cannot be converted.

getTime	back to summary
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. Returns:String a String representation of the time.

getTime

back to summary

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.

Returns:String: a String representation of the time.

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

getTimeString

back to summary

public String getTimeString()

Return the time.

Returns:String: The time string as it appeared in the encoded object.

hasFractionalSeconds	back to summary
protected boolean hasFractionalSeconds()

hashCode back to summary

hashCode	back to summary
public int hashCode() Implements abstract org.bouncycastle.asn1.ASN1Primitive.hashCode. Doc from java.lang.Object.hashCode. Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by `java.util.HashMap`. The general contract of `hashCode` is: Whenever it is invoked on the same object more than once during an execution of a Java application, the `hashCode` method must consistently return the same integer, provided no information used in `equals` comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. If two objects are equal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce the same integer result. It is not required that if two objects are unequal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. Returns:int a hash code value for this object

public int hashCode()

Implements abstract org.bouncycastle.asn1.ASN1Primitive.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Returns:int: a hash code value for this object

hasMinutes	back to summary
protected boolean hasMinutes()

hasSeconds	back to summary
protected boolean hasSeconds()

isConstructed	back to summary
pack-priv boolean isConstructed() Implements abstract org.bouncycastle.asn1.ASN1Primitive.isConstructed. Doc from org.bouncycastle.asn1.ASN1Primitive.isConstructed. Return true if this objected is a CONSTRUCTED one, false otherwise. Returns:boolean true if CONSTRUCTED bit set on object's tag, false otherwise.

isConstructed

back to summary

pack-priv boolean isConstructed()

Implements abstract org.bouncycastle.asn1.ASN1Primitive.isConstructed.

Doc from org.bouncycastle.asn1.ASN1Primitive.isConstructed.

Return true if this objected is a CONSTRUCTED one, false otherwise.

Returns:boolean: true if CONSTRUCTED bit set on object's tag, false otherwise.

isDigit	back to summary
private boolean isDigit(int pos)

toDERObject	back to summary
pack-priv ASN1Primitive toDERObject() Overrides org.bouncycastle.asn1.ASN1Primitive.toDERObject. Doc from org.bouncycastle.asn1.ASN1Primitive.toDERObject. Return the current object as one which encodes using Distinguished Encoding Rules. Returns:ASN1Primitive a DER version of this.

toDERObject

back to summary

pack-priv ASN1Primitive toDERObject()

Overrides org.bouncycastle.asn1.ASN1Primitive.toDERObject.

Doc from org.bouncycastle.asn1.ASN1Primitive.toDERObject.

Return the current object as one which encodes using Distinguished Encoding Rules.

Returns:ASN1Primitive: a DER version of this.

public Class ASN1GeneralizedTime

X.690

11: Restrictions on BER employed by both CER and DER

11.7 GeneralizedTime

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail