🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub✦ BytesAgain

Epoch

by @bytesagain3

Convert Unix timestamps, compare epochs, and do time arithmetic. Use when converting dates, debugging timestamps, or checking timezone offsets.

Versionv3.0.0
Downloads554
Installs2
TERMINAL
clawhub install epoch

πŸ“– About This Skill


name: Epoch description: "Convert Unix timestamps, compare epochs, and do time arithmetic. Use when converting dates, debugging timestamps, or checking timezone offsets." version: "3.0.0" author: "BytesAgain" homepage: https://bytesagain.com source: https://github.com/bytesagain/ai-skills tags: ["epoch","unix","timestamp","time","converter","calculator","developer"] categories: ["Developer Tools", "Utility"]

Epoch

A real Unix timestamp tool for converting, comparing, and calculating epoch timestamps. All conversions use the system date command with support for both local and UTC output.

Commands

| Command | Description | |---------|-------------| | epoch now | Show current epoch timestamp + human-readable date (local & UTC) | | epoch convert | Convert an epoch timestamp to human-readable local, UTC, and age | | epoch from | Convert a human-readable date string to epoch | | epoch diff | Calculate difference between two timestamps (seconds, minutes, hours, days) | | epoch add | Add seconds to a timestamp and show the result | | epoch version | Show version | | epoch help | Show available commands and usage |

Requirements

  • Bash 4+ (set -euo pipefail)
  • date, awk β€” standard Unix utilities
  • No external dependencies or API keys
  • When to Use

    1. Quick timestamp lookup β€” epoch now gives you the current epoch + human date instantly 2. Debugging timestamps in logs β€” epoch convert 1700000000 shows you what that number actually means 3. Parsing date strings β€” epoch from '2024-01-15 10:30:00' gets you the epoch value 4. Calculating time differences β€” epoch diff shows the gap in every unit 5. Time arithmetic β€” epoch add 1700000000 3600 adds an hour and shows the result

    Examples

    # Show current epoch + human-readable date
    epoch now

    Convert epoch to date

    epoch convert 1700000000

    Convert date string to epoch

    epoch from '2024-01-15 10:30:00' epoch from 'Jan 15 2024'

    Difference between two timestamps

    epoch diff 1700000000 1700086400

    Add 1 hour (3600 seconds) to a timestamp

    epoch add 1700000000 3600

    Add 7 days to a timestamp

    epoch add 1700000000 604800

    Example Output

    $ epoch now
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚  Current Time                       β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  Epoch:  1773916290                 β”‚
    β”‚  Human:  2026-03-19 18:31:30 CST   β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  UTC:    2026-03-19 10:31:30 UTC   β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

    $ epoch diff 1700000000 1700086400 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Timestamp Difference β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ From: 1700000000 (2023-11-15 06:13:20 CST) β”‚ β”‚ To: 1700086400 (2023-11-16 06:13:20 CST) β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Seconds: 86400 β”‚ β”‚ Minutes: 1440.00 β”‚ β”‚ Hours: 24.00 β”‚ β”‚ Days: 1.0000 β”‚ β”‚ Duration: 1d 0h 0m 0s β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜


    *Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*

    ⚑ When to Use

    TriggerAction
    2. **Debugging timestamps in logs** β€” `epoch convert 1700000000` shows you what that number actually means
    3. **Parsing date strings** β€” `epoch from '2024-01-15 10:30:00'` gets you the epoch value
    4. **Calculating time differences** β€” `epoch diff ` shows the gap in every unit
    5. **Time arithmetic** β€” `epoch add 1700000000 3600` adds an hour and shows the result

    πŸ’‘ Examples

    # Show current epoch + human-readable date
    epoch now

    Convert epoch to date

    epoch convert 1700000000

    Convert date string to epoch

    epoch from '2024-01-15 10:30:00' epoch from 'Jan 15 2024'

    Difference between two timestamps

    epoch diff 1700000000 1700086400

    Add 1 hour (3600 seconds) to a timestamp

    epoch add 1700000000 3600

    Add 7 days to a timestamp

    epoch add 1700000000 604800

    Example Output

    $ epoch now
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚  Current Time                       β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  Epoch:  1773916290                 β”‚
    β”‚  Human:  2026-03-19 18:31:30 CST   β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  UTC:    2026-03-19 10:31:30 UTC   β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

    $ epoch diff 1700000000 1700086400 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Timestamp Difference β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ From: 1700000000 (2023-11-15 06:13:20 CST) β”‚ β”‚ To: 1700086400 (2023-11-16 06:13:20 CST) β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Seconds: 86400 β”‚ β”‚ Minutes: 1440.00 β”‚ β”‚ Hours: 24.00 β”‚ β”‚ Days: 1.0000 β”‚ β”‚ Duration: 1d 0h 0m 0s β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜


    *Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*