Understanding Unix Timestamps: Why Computers Count Time in Seconds

Open almost any API response, database row, or JWT payload and you'll run into a number like 1716239022 sitting where you'd expect a date. That's a Unix timestamp — and once you understand the one idea behind it, every one of those numbers becomes readable at a glance instead of gibberish.

The one idea: counting seconds from a fixed starting point

A Unix timestamp is simply the number of seconds that have elapsed since midnight UTC on January 1, 1970 — a moment programmers call "the epoch." No months, no leap years to think about, no timezone ambiguity baked into the number itself. Just one integer that keeps counting upward, forever.

That simplicity is exactly why it's everywhere: comparing two timestamps to see which came first is just comparing two numbers. Calculating a duration is just subtraction. No calendar logic required.

Seconds vs. milliseconds — the #1 source of confusion

Some systems (like Unix/Linux conventions and most databases) use seconds — a 10-digit number today. JavaScript's Date object, by contrast, uses milliseconds — a 13-digit number. Mixing the two up is one of the most common timestamp bugs: multiply or divide by 1000 in the wrong direction and you land on a date decades off from what you expected.

• 10 digits (e.g. 1716239022) → seconds
• 13 digits (e.g. 1716239022000) → milliseconds

Why this matters for JWTs specifically

JWT tokens use Unix timestamps in seconds for their exp (expiration) and iat (issued at) claims. When you're debugging why a token expired earlier than expected, converting that raw number to an actual date is usually the fastest way to spot the bug — a token issued with the wrong exp value looks completely normal until you see what date it actually decodes to.

Why not just store a readable date string?

You could — but a plain integer is faster to compare, sort, and do math on than parsing a string every time, takes less storage, and sidesteps timezone-formatting bugs entirely until the moment you actually need to display it to a human. The timestamp is the source of truth; the readable format is just a presentation layer applied at the last possible step.