UnixTime

---

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 <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

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

# 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*