ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

UnixTime

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

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/bytesagain3/unixtime
Or

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

CommandDescription
unixtime currentShow 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 versionShow version
unixtime helpShow 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 checkunixtime current gives epoch, local, UTC, ISO 8601, and calendar info
  2. Parsing log timestampsunixtime to-date 1700000000 or even unixtime to-date 1700000000000 (auto-detects ms)
  3. Date string conversionunixtime to-epoch '2025-06-15 14:00:00' for quick epoch lookup
  4. Event countdownsunixtime countdown <future-epoch> shows remaining time in a breakdown
  5. Duration analysisunixtime 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                         │
└───────────────────────────────────────────────┘

Metadata

Stars3840
Views0
Updated2026-04-06
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-bytesagain3-unixtime": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags

#unix#time#timestamp#date#convert#epoch#utility#developer
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.