Timestamp & Epoch Converter (Epoch Lens)

Publisher: Wood Between Studio

Hover any Unix timestamp or ISO 8601 date to see what it means. Then convert it in place, insert the current timestamp, or show dates inline next to every epoch in a log or JSON file. Everything runs locally, with no network calls.

"created_at": 1700000000        →  2023-11-14T22:13:20.000Z · 2023-11-14T16:13:20-06:00 · 3 years ago
"expires":    1700000060123     →  milliseconds detected automatically
2023-11-14T22:13:20Z            →  1700000000

Free (complete)

All of the following are included in the free extension and stay free:

Hover a Unix timestamp in seconds, milliseconds, microseconds, or nanoseconds, or an ISO 8601 / RFC 3339 date. The hover shows ISO UTC, ISO local with its offset, Unix seconds and milliseconds, the RFC 2822 / HTTP date, and relative time ("3 hours ago").
Convert Timestamp ⇄ Date (Selection): epoch → ISO date, or date → epoch, in place. Works with multiple cursors, and with the cursor on a value and nothing selected. Shortcut: Ctrl+Alt+E (Cmd+Alt+E on macOS). It is also in the editor right-click menu.
Convert a Timestamp or Date…: paste any value, see every representation, and pick one to copy.
Insert Current Timestamp…: as epoch seconds or milliseconds, ISO UTC, ISO local, or RFC 2822.
Copy Current Unix Timestamp to the clipboard.
Switch Epoch Seconds ⇄ Milliseconds.
Toggle Inline Dates for Epochs: shows the readable date after every epoch in the editor, which helps a lot with logs, JSON API responses, and database dumps.
The unit is detected from the digit count: 9–10 digits are seconds, 12–13 milliseconds, 15–16 microseconds, and 18–19 nanoseconds. Hover and inline dates skip numbers outside a year window (default 1990–2100), so IDs and phone numbers aren't mistaken for dates.
Parses ISO 8601 with Z or offsets, YYYY-MM-DD HH:mm:ss, and RFC 2822 / HTTP dates.

Open the Command Palette and type Epoch Lens.

Pro extras

Every core feature listed above is free. Pro only adds extras, for $5:

Convert All Timestamps in File: batch-convert every epoch to a date, or every date to an epoch, in the whole file or the selection.
Export Timestamp Report (Markdown/CSV): lists every timestamp in a file with its line, ISO UTC, local time, Unix seconds, relative time, the delta from the previous timestamp, and the total span. Good for reading logs.
Extra time zones: add IANA zones (for example America/New_York, Europe/London, Asia/Tokyo) to the hover, convert, and insert lists.
Custom format presets: your own output patterns, such as YYYY-MM-DD HH:mm:ss.SSS Z, for insert and convert.

Pro is sold at https://woodbetweenstudio.gumroad.com/l/epoch-lens-pro for $5. After you buy, paste the Gumroad license key from your receipt into epochLens.proLicense. The key is stored locally. The extension checks the key format on your machine and does not contact Gumroad or any other server.

After your first successful conversion, the extension may show a one-time, dismissible note about Pro. Core features always stay free and are never blocked.

Commands

Command	Free/Pro
Epoch Lens: Convert Timestamp ⇄ Date (Selection)	Free
Epoch Lens: Convert a Timestamp or Date…	Free
Epoch Lens: Insert Current Timestamp…	Free
Epoch Lens: Copy Current Unix Timestamp	Free
Epoch Lens: Switch Epoch Seconds ⇄ Milliseconds	Free
Epoch Lens: Toggle Inline Dates for Epochs	Free
Epoch Lens: Convert All Timestamps in File (Pro)	Pro
Epoch Lens: Export Timestamp Report: Markdown/CSV (Pro)	Pro
Epoch Lens: Insert or Convert with Format Preset (Pro)	Pro

Settings

Setting	Default	Purpose
`epochLens.hover.enabled`	`true`	Show the hover on timestamps and dates
`epochLens.inline.enabled`	`false`	Show the date inline after each epoch
`epochLens.inline.style`	`utc`	Inline date as `utc` or `local`
`epochLens.inline.languages`	`["*"]`	Language ids for inline dates
`epochLens.dateFormat`	`iso`	Epoch → date output: `iso`, `isoLocal`, or `rfc2822`
`epochLens.epochUnit`	`s`	Date → epoch output: `s` or `ms`
`epochLens.assumeLocalForNaiveDates`	`false`	Read dates without an offset as local time instead of UTC
`epochLens.minYear` / `epochLens.maxYear`	`1990` / `2100`	Plausible year window for hover and inline dates
`epochLens.extraTimeZones`	`[]`	Pro: extra IANA time zones
`epochLens.formatPresets`	`[]`	Pro: custom format patterns
`epochLens.proLicense`	`""`	Optional Pro license key

Format tokens: YYYY YY MMM MM M DD D ddd HH H hh h mm ss SSS A a Z ZZ X x. Put literal text in [brackets].

Privacy

No telemetry, no accounts, and no network calls. Time zone math uses the runtime's built-in Intl support.

Support

woodbetweenstudio+plugins@mail.grokbot.com