🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub✦ BytesAgain

Unixtime

by @bytesagain3

Convert Unix timestamps to dates and back. Use when parsing epoch values, calculating time differences, debugging logs, or generating relative dates.

Versionv3.0.0
Downloads556
Installs1
TERMINAL
clawhub install unixtime

πŸ“– About This Skill


name: UnixTime description: "Convert Unix timestamps to dates and back. Use when parsing epoch values, calculating time differences, debugging logs, or generating relative dates." version: "3.0.0" author: "BytesAgain" homepage: https://bytesagain.com source: https://github.com/bytesagain/ai-skills tags: ["unix","time","timestamp","date","convert","epoch","utility","developer"] categories: ["Developer Tools", "Utility"]

UnixTime

A Unix time utility for converting timestamps, counting down to events, and analyzing time ranges. Features millisecond detection, ISO 8601 output, and detailed duration breakdowns.

Commands

| Command | Description | |---------|-------------| | unixtime current | Show current Unix timestamp with epoch (s/ms), local, UTC, ISO 8601, day-of-year, week number | | unixtime to-date | Convert a Unix timestamp to readable date (auto-detects milliseconds for 13+ digit values) | | unixtime to-epoch | Convert a human-readable date string to Unix epoch | | unixtime countdown | Show time remaining until a future timestamp (or how long ago it passed) | | unixtime ranges | Show full duration between two timestamps (seconds through weeks) | | unixtime version | Show version | | unixtime help | Show available commands and usage |

Requirements

  • Bash 4+ (set -euo pipefail)
  • date, awk β€” standard Unix utilities
  • python3 (optional, for millisecond epoch)
  • No external dependencies or API keys
  • When to Use

    1. Quick timestamp check β€” unixtime current gives epoch, local, UTC, ISO 8601, and calendar info 2. Parsing log timestamps β€” unixtime to-date 1700000000 or even unixtime to-date 1700000000000 (auto-detects ms) 3. Date string conversion β€” unixtime to-epoch '2025-06-15 14:00:00' for quick epoch lookup 4. Event countdowns β€” unixtime countdown shows remaining time in a breakdown 5. Duration analysis β€” unixtime ranges shows the gap in seconds, minutes, hours, days, and weeks

    Examples

    # Show current Unix time with full details
    unixtime current

    Convert timestamp to date (auto-detects milliseconds)

    unixtime to-date 1700000000 unixtime to-date 1700000000000

    Convert date string to epoch

    unixtime to-epoch '2025-06-15 14:00:00' unixtime to-epoch 'Jan 15 2025'

    Countdown to a future timestamp

    unixtime countdown 1800000000

    Analyze a time range

    unixtime ranges 1700000000 1700086400

    Example Output

    $ unixtime current
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚  Current Unix Time                            β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  Epoch (s):   1773916290                       β”‚
    β”‚  Epoch (ms):  1773916290572                    β”‚
    β”‚  Local:       2026-03-19 18:31:30 CST          β”‚
    β”‚  UTC:         2026-03-19 10:31:30 UTC          β”‚
    β”‚  ISO 8601:    2026-03-19T10:31:30Z             β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  Day of year: 78/365                           β”‚
    β”‚  Week:        12                               β”‚
    β”‚  Day:         Thursday                         β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

    $ unixtime countdown 1800000000 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ ⏳ Countdown β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Target: 1800000000 (2027-01-14 ...) β”‚ β”‚ Now: 1773916290 β”‚ β”‚ Remaining: 301d 12h 1m 50s β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Seconds: 26083710 β”‚ β”‚ Minutes: 434728.5 β”‚ β”‚ Hours: 7245.47 β”‚ β”‚ Days: 301.894 β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜


    *Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*

    ⚑ When to Use

    TriggerAction
    2. **Parsing log timestamps** β€” `unixtime to-date 1700000000` or even `unixtime to-date 1700000000000` (auto-detects ms)
    3. **Date string conversion** β€” `unixtime to-epoch '2025-06-15 14:00:00'` for quick epoch lookup
    4. **Event countdowns** β€” `unixtime countdown ` shows remaining time in a breakdown
    5. **Duration analysis** β€” `unixtime ranges ` shows the gap in seconds, minutes, hours, days, and weeks

    πŸ’‘ Examples

    # Show current Unix time with full details
    unixtime current

    Convert timestamp to date (auto-detects milliseconds)

    unixtime to-date 1700000000 unixtime to-date 1700000000000

    Convert date string to epoch

    unixtime to-epoch '2025-06-15 14:00:00' unixtime to-epoch 'Jan 15 2025'

    Countdown to a future timestamp

    unixtime countdown 1800000000

    Analyze a time range

    unixtime ranges 1700000000 1700086400

    Example Output

    $ unixtime current
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚  Current Unix Time                            β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  Epoch (s):   1773916290                       β”‚
    β”‚  Epoch (ms):  1773916290572                    β”‚
    β”‚  Local:       2026-03-19 18:31:30 CST          β”‚
    β”‚  UTC:         2026-03-19 10:31:30 UTC          β”‚
    β”‚  ISO 8601:    2026-03-19T10:31:30Z             β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  Day of year: 78/365                           β”‚
    β”‚  Week:        12                               β”‚
    β”‚  Day:         Thursday                         β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

    $ unixtime countdown 1800000000 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ ⏳ Countdown β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Target: 1800000000 (2027-01-14 ...) β”‚ β”‚ Now: 1773916290 β”‚ β”‚ Remaining: 301d 12h 1m 50s β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Seconds: 26083710 β”‚ β”‚ Minutes: 434728.5 β”‚ β”‚ Hours: 7245.47 β”‚ β”‚ Days: 301.894 β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜


    *Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*