Temporal

An absolute point on the time-line. E.g. 2021/07/04.

Time offset from the base in ISO-8601 durations format.

Examples:

• P1H for one hour later.
• -P20D or P-20D for 20 days before. Can be null (zero), e.g. if one period starts right after another period ends.

Base of this temporal.

Temporals which are based on this temporal.

Lower bounds of a temporal. E.g. exact time of some temporal might not be known at a moment, but it might be known that it should not be before than some other temporal - a lower bound. Lower bounds are used in validations and before/after computations.

Upper bounds of a temporal. E.g. exact time of some temporal might not be known at a moment, but it might be known that it should not be after some other temporal - an upper bound. Upper bounds are used in validations and before/after computations.

Tests if this temporal is after the specified temporal. Returns null if unknown, i.e. two unrelated points in time.

Tests if this temporal is before the specified temporal. Returns null if unknown, i.e. two unrelated points in time.

Tests if this temporal occurs at the same point on the time-line as the specified temporal. Returns null if unknown, i.e. two unrelated points in time.

Returns a deep copy of self with bounds copied. Other containment references are not set.

Returns duration difference between this temporal and the argument temporal - how much this temporal is after the argument on the time-line, if difference can be computed, i.e. both this temporal and the argument temporal are instant or trace to the same base temporal. Returns null otherwise.

Returns a temporal based on this one offset by negation of the argument duration. Null duration is treated as zero and set as-is (not negated).

Returns a normalized instance of this temporal not contained in the model. Normalization walks through the temporal chain from a temporal to its base to the root temporal. If that root temporal is instant/absolute then the normalized instance would be instant/absolute. Otherwise the normalized instance would contain the root temporal as its base and the offset would be the sum of all offsets.

Returns a temporal based on this one offset by the argument duration. Duration can be null - in this case it is treated as zero.