Skip to content
Latchkey

What Is a Deterministic Timestamp?

A deterministic timestamp is a fixed time value, usually derived from the source such as the latest commit date, that a build embeds in place of the current wall-clock time. Because the value depends only on inputs, two builds of the same source embed the same timestamp. This removes one of the most common sources of nonreproducible output.

Why it matters

Embedding the real current time makes every build differ even when nothing in the source changed, breaking reproducibility and cache hits. Pinning the timestamp to a source-derived value keeps artifacts identical across rebuilds. The conventional way to supply that value to tools is the SOURCE_DATE_EPOCH variable.

Related guides

Tired of flaky CI? Latchkey auto-heals failed jobs and retries them for you. Start free →