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 utilitiespython3(optional, for millisecond epoch)- No external dependencies or API keys
When to Use
- Quick timestamp check —
unixtime currentgives epoch, local, UTC, ISO 8601, and calendar info - Parsing log timestamps —
unixtime to-date 1700000000or evenunixtime to-date 1700000000000(auto-detects ms) - Date string conversion —
unixtime to-epoch '2025-06-15 14:00:00'for quick epoch lookup - Event countdowns —
unixtime countdown <future-epoch>shows remaining time in a breakdown - 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