convert_timestamp
Convert Unix epoch timestamps to human-readable dates or parse date strings back to timestamps. Auto-detects seconds, milliseconds, ISO 8601, and other formats, returning UTC, local time, and calendar analysis.
Instructions
Unix Timestamp Converter. Convert a Unix epoch timestamp to a human-readable date, or parse a date string back to a Unix timestamp, with full UTC and local-time breakdowns. Auto-detects the input format: 10-digit Unix seconds, 13-digit Unix milliseconds, ISO 8601, or any parseable date string. Unlike time_iso_8601_formatter (which only parses and formats ISO 8601 / RFC 3339 strings) or time_date_difference (which measures spans between two dates), this tool centres on a single instant and emits every common representation of it at once. Requires a non-empty input; it does not fall back to the current time. Runs locally on the value you provide: read-only, non-destructive, contacts no external service, and is rate-limited (60 requests/minute for anonymous callers). Returns the detected format plus Unix seconds, milliseconds, ISO 8601, UTC, local strings, and a calendar analysis (weekday, day/week of year, quarter, leap-year flag, days in month, timezone offset, and a now-relative phrase that varies between cal
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input | Yes | The timestamp or date to convert. Accepts 10-digit Unix seconds, 13-digit Unix milliseconds, an ISO 8601 datetime, or any parseable date string. Must not be blank (also accepted under the keys timestamp or text). | |
| now | No | Optional reference instant in Unix milliseconds used only to compute the relative phrase (for example 2 days ago). Omit to use the server current time, which makes the relative field vary between calls. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | No | Whether the conversion succeeded. | |
| detectedFormat | No | The input format that was auto-detected (for example Unix Timestamp seconds, ISO 8601, or Date String). | |
| results | No | The converted instant in multiple representations. | |
| error | No | Present only on a 400 error response; the failure reason. |