{
  "slug": "unix-timestamp-converter",
  "name": "gizza-ai/unix-timestamp-converter",
  "version": "0.1.0",
  "title": "Unix Timestamp Converter — epoch date converter — gizza.ai",
  "description": "Convert Unix timestamps (seconds, milliseconds, microseconds, nanoseconds) to UTC dates, or parse human-readable dates back to epoch timestamps. Free, private, no upload.",
  "tags": [
    "unix timestamp",
    "epoch converter",
    "timestamp to date",
    "date to timestamp",
    "utc time"
  ],
  "category": "data",
  "urls": {
    "page": "https://gizza.ai/tools/unix-timestamp-converter/",
    "markdown": "https://gizza.ai/tools/unix-timestamp-converter/index.md",
    "descriptor": "https://gizza.ai/tools/unix-timestamp-converter/tool.json",
    "deep_link_example": "https://gizza.ai/tools/unix-timestamp-converter/?value=1700000000%20or%202023-11-14T22%3A13%3A20Z&mode=auto&unit=auto"
  },
  "cli": "gizza tool unix-timestamp-converter \"1700000000 or 2023-11-14T22:13:20Z\"",
  "tool": {
    "description": "Convert between Unix (epoch) timestamps and human-readable dates in many common formats, entirely locally. Give 'value' as either a numeric timestamp (e.g. 1700000000) to convert to a UTC date, or a date/time string (ISO 8601 / RFC 3339, RFC 2822 email dates, US/European slash & dotted dates, month-name dates, e.g. '2023-11-14 22:13:20', '2023-11-14T22:13:20+02:00', 'January 1, 1970') to convert to a timestamp. 'mode' = auto (default; numeric -> date, else date -> timestamp), to-date, or to-timestamp. 'unit' = auto (default, detected from magnitude), seconds, milliseconds, microseconds, or nanoseconds — the unit of a numeric timestamp being read as a date (outputs always include all four units). For timestamp -> date it returns the timestamp in every unit, a UTC string, ISO 8601 and RFC 2822 renderings, and a full calendar breakdown (year, month + name, day, weekday, day-of-year, ISO week, hour/minute/second/nanosecond). For date -> timestamp it returns the Unix timestamp in seconds/milliseconds/microseconds/nanoseconds; an offset-less wall-clock is interpreted as UTC (assumed_utc=true). Runs locally; nothing is uploaded.",
    "parameters": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "default": "auto",
          "description": "Conversion direction. auto (default): a numeric value becomes a date, anything else is parsed as a date. to-date: force timestamp -> date. to-timestamp: force date -> timestamp.",
          "enum": [
            "auto",
            "to-date",
            "to-timestamp"
          ],
          "type": "string"
        },
        "unit": {
          "default": "auto",
          "description": "Unit of the numeric timestamp when converting to a date (ignored for to-timestamp). auto (default) detects it from the magnitude. Outputs always include all four units.",
          "enum": [
            "auto",
            "seconds",
            "milliseconds",
            "microseconds",
            "nanoseconds"
          ],
          "type": "string"
        },
        "value": {
          "description": "The thing to convert: a numeric Unix timestamp (e.g. 1700000000) to turn into a date, or a date/time string (e.g. '2023-11-14 22:13:20', '2023-11-14T22:13:20+02:00', 'January 1, 1970') to turn into a timestamp.",
          "type": "string"
        }
      },
      "required": [
        "value"
      ],
      "type": "object"
    }
  }
}