DICE API Documentation/com.embabel.dice.temporal/TemporalMetadata

TemporalMetadata

data class TemporalMetadata constructor(val observedAt: Instant? = null, val validFrom: Instant? = null, val validTo: Instant? = null, val invalidatedAt: Instant? = null, val supersedes: List<String> = emptyList(), val contradicts: List<String> = emptyList())

Optional temporal metadata for a fact. Every field is optional — attach only what is known; a fact for which nothing temporal is tracked has no TemporalMetadata at all.

Observed / source time (observedAt): when the underlying source material was authored — e.g. the date of the email this fact came from. Distinct from Proposition.created (when DICE ingested it): a fact recorded today from a 45-day-old email has created = today and observedAt = 45 days ago. (See embabel/dice#26.)
Valid time (validFrom / validTo): the window during which the fact holds in the world. A non-null validFrom is what marks a fact as dated — a known validity window, which does not decay — as opposed to merely decaying. A null validTo means "still valid / open-ended".
Invalidation (invalidatedAt): when the fact was explicitly retracted, independent of its valid window.

Constructors

TemporalMetadata

constructor(observedAt: Instant? = null, validFrom: Instant? = null, validTo: Instant? = null, invalidatedAt: Instant? = null, supersedes: List<String> = emptyList(), contradicts: List<String> = emptyList())