dmn (date-me-now) (^_^)

A simple, fast, and high-developer-experience (DX) Date/Time CLI tool designed to format and calculate dates into ISO-8601 format, including support for human-readable natural language inputs and relative time math.

Installation

Install globally using pnpm:

pnpm add -g date-me-now

Or run directly without installing via npx:

npx date-me-now

Usage

1. Get Current Date (Local & UTC)

Get the current time in local ISO format:

dmn

Get the current time in UTC:

dmn -u
# Or
dmn --utc

Get only the date portion (YYYY-MM-DD):

dmn -d

Get only the time portion:

dmn -t

Output raw dates without banners or headers:

dmn -p
# Or
dmn --plain

2. Parse Dates (Natural Language / Timestamps / Strings)

dmn seamlessly parses dates, Unix timestamps (seconds or milliseconds), and natural language:

dmn "2025-05-19T10:00:00Z"
dmn 1735689600
dmn "tomorrow at 5pm"
dmn "next friday"

3. Date Math & Time Calculations

Add days, hours, months, or years to a base date/time:

dmn add 5 days
dmn add 3 months "tomorrow at 12pm"

Subtract durations from a base date/time:

dmn sub 10 hours
dmn sub 1 year "2025-05-19"

Get relative human phrasing using the --human flag:

dmn add 2 days --human
# Output: "in 2 days"

dmn sub 3 hours --human
# Output: "3 hours ago"

4. Time Difference & Durations

Compare a target date with a base date (defaults to current time):

dmn diff "next friday" "today"
# Output: number of days

# Specifying units (-n): millisecond, second, minute, hour, day, month, year
dmn diff "tomorrow" "today" -n hour
# Output: 24

# Relative humanized difference:
dmn diff "next friday" "today" --human
# Output: "in 10 days"

Testing

Run the Vitest suite:

pnpm test

License

MIT