Timestamp Skill

Convert between various timestamp formats.

When to Use

✅ USE this skill when:

• "Convert this timestamp to readable date"
• "What time is 1704067200?"
• "Get current timestamp"
• "Parse this date string"
• "Calculate time difference"

When NOT to Use

❌ DON'T use this skill when:

• Scheduling tasks → use cron/system scheduler
• Time zone conversions → use timezone-aware libraries
• Calendar operations → use calendar tools

Commands

Current Time

{baseDir}/timestamp.sh now
{baseDir}/timestamp.sh now --format iso
{baseDir}/timestamp.sh now --format unix
{baseDir}/timestamp.sh now --utc

Convert Timestamp

{baseDir}/timestamp.sh convert 1704067200
{baseDir}/timestamp.sh convert "2024-01-01T00:00:00Z"
{baseDir}/timestamp.sh convert "January 1, 2024"
{baseDir}/timestamp.sh convert 1704067200 --format iso

Relative Time

{baseDir}/timestamp.sh relative "2 hours ago"
{baseDir}/timestamp.sh relative "tomorrow"
{baseDir}/timestamp.sh relative "next week"
{baseDir}/timestamp.sh relative "in 3 days"

Time Difference

{baseDir}/timestamp.sh diff "2024-01-01" "2024-01-10"
{baseDir}/timestamp.sh diff 1704067200 1704153600
{baseDir}/timestamp.sh diff "now" "tomorrow"

Parse Date String

{baseDir}/timestamp.sh parse "January 1, 2024"
{baseDir}/timestamp.sh parse "2024-01-01 12:00:00"
{baseDir}/timestamp.sh parse "01/01/2024"

Output Formats

Format	Description	Example
unix	Unix timestamp	1704067200
iso	ISO 8601	2024-01-01T00:00:00Z
date	Date only	2024-01-01
time	Time only	00:00:00
datetime	Date and time	2024-01-01 00:00:00
human	Human readable	Monday, January 1, 2024
relative	Relative time	2 hours ago

Examples

Get current Unix timestamp:

{baseDir}/timestamp.sh now --format unix
# Output: 1704067200

Convert Unix to ISO:

{baseDir}/timestamp.sh convert 1704067200 --format iso
# Output: 2024-01-01T00:00:00Z

Get time 2 hours from now:

{baseDir}/timestamp.sh relative "in 2 hours"
# Output: 2024-01-01T02:00:00Z

Calculate days between dates:

{baseDir}/timestamp.sh diff "2024-01-01" "2024-01-31" --unit days
# Output: 30 days

Notes

• All operations use UTC by default
• Use --local for local timezone
• Supports various date formats
• Handles relative time expressions