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

• 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

# 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 | [e-mail]