Timezone Timestamp Normalizer

    1

    Normalize ISO-like timestamps to a fixed UTC offset for sorting and comparison. Supports quoted strings, Z, compact offsets, JSON batches, and explicit invalid-value policies.

    $12

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    Timezone Timestamp Normalizer

    Example session with this skill installed

    Normalize 2025-01-01T00:00:00Z and 2025-01-01T09:00:00+0900 to the default offset so I can compare them.

    • Read your context and instructions
    • Compiled the timezone timestamp normalizer

    Command

    python3 scripts/timestamp_normalizer.py 2025-01-01T00:00:00Z 2025-01-01T09:00:00+0900
    

    Output (captured in examples/normalized.json)

    [{"index": 0, "input": "2025-01-01T00:00:00Z", "iso": "2025-01-01T09:00:00+09:00", "epoch": 1735689600}, {"index": 1, "input": "2025-01-01T09:00:00+0900", "iso": "2025-01-01T09:00:00+09:00", "epoch": 1735689600}]
    

    Summary

    Both inputs normalize to 2025-01-01T09:00:00+09:00 and share the epoch value 1735689600, so they are the same instant. The dates in the example are synthetic.

    Next steps

    • Add --timezone -05:00 to choose a different output offset.
    • Add --naive-timezone +09:00 to set how values without an offset are read.
    • Use --input examples/events.json --field occurred_at for a JSON batch.
    • Use --invalid null, keep, or epoch-zero instead of stopping on an invalid value.
    • Offsets are fixed; daylight-saving transitions are not modeled.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Normalize ISO-like timestamp strings to one fixed UTC offset so they can be compared and sorted consistently. Timezone Timestamp Normalizer is a local Python command-line tool that uses only the standard library.

    What it does

    • Accepts ISO timestamps with Z, colon offsets, compact offsets such as +0900, and balanced wrapping quotes.
    • --timezone sets the output offset; --naive-timezone sets how values without an offset are interpreted. Both default to +09:00 (Japan Standard Time).
    • --input FILE --field NAME normalizes a JSON array of records; results are indexed.
    • --invalid chooses the behavior for invalid values: stop with an error (default), null, keep, or epoch-zero.
    • --epoch-unit milliseconds emits epoch milliseconds instead of seconds.
    • Python helpers compare() and sort_records() compare actual instants after normalization.

    What is included

    • scripts/timestamp_normalizer.py: parsing, normalization, comparison, and the CLI
    • tests/: 19 independent behavior tests
    • examples/: synthetic single and batch inputs with captured outputs
    • SKILL.md, README.md, LICENSE

    Requirements and limits

    • Python 3.10 or newer. Standard library only.
    • Time zones are fixed UTC offsets. Daylight-saving transition rules and time zone databases are not used.
    • Malformed values return exit code 2 by default.

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for DevOps & Cloud.

    Time zones are fixed UTC offsets; daylight-saving transition rules and time zone databases are not used. Python 3.10 or newer is required. Unsupported date syntax or malformed JSON input stops the tool (exit code 2 by default).

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Money-back guarantee

    Doesn't do what its page promises? You get your money back.

    Trust & safety

    Security scan

    Security scan passed 3 days ago

    Software
    Python 3.10+

    Permissions

    Terminal / Shell
    Write Files
    Listed3 days ago

    What's inside

    Frequently Asked Questions

    It converts ISO-like timestamp strings to one fixed UTC offset and prints indexed JSON with the normalized ISO string and the epoch value, so timestamps can be compared and sorted by instant.

    ISO-like timestamps with Z, colon offsets, compact offsets such as +0900, and balanced wrapping quotes. Values without an offset use the --naive-timezone setting (default +09:00). A JSON array of records can be read with --input and --field.

    No. Time zones are fixed UTC offsets. Daylight-saving transition rules and time zone databases are not used.

    By default the tool stops and returns exit code 2. With --invalid you can choose null, keep (retain the input), or epoch-zero (the legacy convention of mapping invalid values to zero).

    Python 3.10 or newer, standard library only. Run python3 scripts/timestamp_normalizer.py TIMESTAMP ... Use --timezone for the output offset and --epoch-unit milliseconds for milliseconds. Run the 19 tests with python3 -m unittest discover -s tests -v.

    New in DevOps & Cloud