Unix Timestamp Converter

WHAT IT DOES

Unix Timestamp Converter translates between Unix timestamps (seconds or milliseconds since January 1, 1970) and human-readable dates. Enter a timestamp and see the date in local and UTC time, or enter a date and get the corresponding timestamp. The tool displays timezone offset, supports multiple date formats (ISO, locale, custom), and automatically shows the current timestamp. You can copy results to your clipboard, and the current timestamp updates every second when auto-update is enabled.

WHERE IT RUNS

The extension runs entirely within your browser's local environment using the BotGentz framework. All timestamp conversion, date formatting, and timezone handling occur on your machine without any network requests. No timestamp data, date values, or user activity is ever transmitted, uploaded, or stored externally. The tool works on any website and respects the browser's security boundaries, operating within the isolated extension sandbox. Timestamp conversion uses the browser's native Date object and JavaScript time calculations.

HOW TO USE

Click the extension toolbar icon to open the Unix Timestamp Converter panel. The panel shows the current timestamp and its date representation. Enter a timestamp (e.g., "1704067200" for seconds or "1704067200000" for milliseconds) in the input field and click "Convert"—the tool displays the corresponding date in local and UTC time, along with the timezone offset. Enter a date string (e.g., "2024-01-01") and click "Convert" to get the timestamp. Click "Now" to insert the current timestamp. Click "Copy Result" to copy the conversion output to your clipboard. Toggle "Auto-update current time" to update the current timestamp display every second. Toggle "Show timezone offset" to show or hide the timezone offset in the output. Select the "Timestamp Unit" (Seconds or Milliseconds) to control how timestamps are interpreted. Select the "Date Format" (ISO, Locale, or Custom) to control how dates are displayed. The tool automatically detects whether you entered a timestamp or a date.

THE TIMESTAMP CONVERSION ENGINE — WHY IT WORKS

Most timestamp converters use separate functions for each conversion direction. This tool uses a unified approach with the JavaScript Date object: timestamps are converted to dates using new Date(timestamp * 1000) for seconds or new Date(timestamp) for milliseconds. Dates are converted to timestamps using date.getTime(), then divided by 1000 for seconds. The input detection checks if the input consists only of digits (timestamp) or contains letters (date). The timezone offset is calculated using date.getTimezoneOffset(), which returns the offset in minutes, formatted as ±HH:MM. The three date formats provide flexibility: ISO format uses toISOString(), locale format uses toLocaleString(), and custom format uses a manual formatting function. The current timestamp is calculated using Date.now() and updated via setInterval when auto-update is enabled. This approach provides accurate, reliable conversions in both directions.

THE PANEL

The Unix Timestamp Converter panel is fully draggable by its title bar and remembers its position on screen per website. It snaps to the edges of your browser window for clean alignment. Collapse the panel to a compact icon strip using the minimize button, restoring it with a single click. Resize the panel by dragging any edge or corner; the input area and output display adjust proportionally. Press the Escape key to close the panel instantly. The panel maintains independent state for each browser tab, allowing you to convert timestamps in multiple tabs simultaneously.

PLEASE NOTE

This extension requires the free BotGentz extension framework to be installed and enabled. The tool uses the browser's local timezone for local time display; UTC time is displayed for reference. Timestamps are based on the Unix epoch (January 1, 1970, 00:00:00 UTC). The auto-update feature updates the current timestamp every second; disabling it reduces CPU usage. The custom date format uses YYYY-MM-DD HH:mm:ss. All conversion data is processed locally and is never transmitted, logged, or shared. The extension requests no network permissions and functions entirely offline. The source code is fully auditable and available for review.