UnixTime

# 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 <timestamp>` | Convert a Unix timestamp to readable date (auto-detects milliseconds for 13+ digit values) | | `unixtime to-epoch <date-string>` | Convert a human-readable date string to Unix epoch | | `unixtime countdown <future-timestamp>` | Show time remaining until a future timestamp (or how long ago it passed) | | `unixtime ranges <start> <end>` | 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 <future-epoch>` shows remaining time in a breakdown 5. **Duration analysis** — `unixtime ranges <start> <end>` shows the gap in seconds, minutes, hours, days, and weeks ## Examples ```bash # 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*