DateTime Utilities

Date and time operations for scheduling, timezone conversion, and duration calculations.

Quick Start

Current Time

node /path/to/skills/datetime/scripts/now.js

Convert Timezone

node /path/to/skills/datetime/scripts/convert.js "2024-01-15 10:00" --from UTC --to "America/New_York"

Calculate Duration

node /path/to/skills/datetime/scripts/duration.js "2024-01-01" "2024-12-31"

Scripts

now.js

Get current date and time information.

Usage:

node now.js [OPTIONS]

Options:

• •--timezone <tz> - Show time in specific timezone (default: local)
• •--format <fmt> - Output format: iso, unix, human (default: human)
• •--json - Output as JSON with all formats

convert.js

Convert time between timezones.

Usage:

node convert.js <datetime> --from <tz> --to <tz>

Arguments:

• •<datetime> - Date/time to convert (ISO format or "YYYY-MM-DD HH:mm")
• •--from <tz> - Source timezone (default: local)
• •--to <tz> - Target timezone (required)

duration.js

Calculate duration between two dates.

Usage:

node duration.js <start> <end>

Options:

• •--unit <unit> - Output unit: auto, days, hours, minutes, seconds

Examples

Current Time in Multiple Timezones

node now.js --json

Output:

{
  "local": "2024-01-15T10:30:00-05:00",
  "utc": "2024-01-15T15:30:00Z",
  "unix": 1705332600
}

Convert Meeting Time

node convert.js "2024-01-20 14:00" --from "America/Los_Angeles" --to "Europe/London"

Output: 2024-01-20 22:00 GMT

Days Until Deadline

node duration.js "$(date +%Y-%m-%d)" "2024-12-31"

Common Timezones

ISO 8601 Format

All outputs support ISO 8601 format:

• •Date: 2024-01-15
• •DateTime: 2024-01-15T10:30:00
• •With timezone: 2024-01-15T10:30:00-05:00
• •UTC: 2024-01-15T15:30:00Z