core/at.asitplus.awesn1/Asn1Time/SecondsCapped

SecondsCapped

class SecondsCapped(instant: Instant, formatOverride: Asn1Time.Format? = null) : Asn1Time(source)

An Asn1Time with no encoded fractional second (whole-second) — the canonical DER-minimal form, and the only way to construct a time from Kotlin.

A value being whole-second is equivalent to being a SecondsCapped. The converse is not true for Fractional: a Fractional whose value happens to land on a whole second (e.g. an all-zero fraction .000) is still a Fractional, because it encodes differently. Detect "no fraction" via is SecondsCapped, never via instant.

Parameters

instant

the timestamp to encode; any sub-second part is dropped

formatOverride

force either GENERALIZED TIME or UTC TIME

Constructors

SecondsCapped

constructor(instant: Instant, formatOverride: Asn1Time.Format? = null)

Properties

format

open override val format: Asn1Time.Format

Indicates whether this timestamp uses UTC TIME or GENERALIZED TIME.

instant

open override val instant: Instant

The timestamp value only, truncated to Instant's nanosecond resolution. For SecondsCapped this is whole-second; for Fractional it reflects the decoded fraction only up to nanoseconds.

Functions

encodeToDer

fun Asn1Encodable<*>.encodeToDer(): ByteArray

Convenience function to directly get the DER-encoded representation of the implementing object

fun Asn1Encodable<*>.encodeToDer(sink: Sink)

encodeToDerOrNull

fun Asn1Encodable<*>.encodeToDerOrNull(): ByteArray?

Exception-free version of encodeToDer

encodeToTlv

open override fun encodeToTlv(): Asn1Primitive

Encodes the implementing object into an A

encodeToTlvOrNull

fun <A : Asn1Element> Asn1Encodable<A>.encodeToTlvOrNull(): A?

Exception-free version of Asn1Encodable.encodeToTlv

equals

open operator override fun equals(other: Any?): Boolean

hashCode

open override fun hashCode(): Int

prettyPrintAsn1

open fun prettyPrintAsn1(): String

shorthand for Asn1Element.prettyPrint, hence, a call to this function encodes this encodable to an Asn1Element, holds it in memory, pretty prints it, and discards it. This characteristic may be relevant in memory-constrained environments.

secondsCapped

fun secondsCapped(): Asn1Time.SecondsCapped

Returns a fresh instance of a SecondsCapped version of this Asn1Time.

toDerHexString

fun Asn1Encodable<*>.toDerHexString(lineLen: Int? = null): String

toString

open override fun toString(): String

withImplicitTag

open infix fun withImplicitTag(tag: Asn1Element.Tag): Asn1Element

Creates a new implicitly tagged ASN.1 Element from this ASN.1 Element. NOTE: The TagClass of the provided tag will be used! If you want the result to have TagClass.CONTEXT_SPECIFIC, also invoke tag withClass TagClass.CONTEXT_SPECIFIC!. If a CONSTRUCTED Tag is applied to an ASN.1 Primitive, the CONSTRUCTED bit is overridden and set to zero

open infix fun withImplicitTag(template: Asn1Element.Tag.Template): Asn1Element

Creates a new implicitly tagged ASN.1 Element from this ASN.1 Structure. If the provided template's tagClass is not set, the class of the resulting structure defaults to TagClass.CONTEXT_SPECIFIC. If a CONSTRUCTED Tag is applied to an ASN.1 Primitive, the CONSTRUCTED bit is overridden and set to zero

open infix fun withImplicitTag(tagValue: ULong): Asn1Element

Creates a new implicitly tagged ASN.1 Element from this ASN.1 Element. Sets the class of the resulting structure to TagClass.CONTEXT_SPECIFIC