This package connects @ver0/now-ish to date-fns. It provides a ready-to-use parse function that turns expressions like now-7d/d into timezone-aware TZDate objects.

If you're already using date-fns in your project, this is the adapter for you.

Installation

npm install @ver0/now-ish_date-fns @ver0/now-ish

@ver0/now-ish is a peer dependency.

How to use

The default parser uses UTC timezone and recognizes the now keyword.

import {parse} from '@ver0/now-ish_date-fns';

const sevenDaysAgo = parse('now-7d');
const startOfToday = parse('now/d');
const startOfLastWeek = parse('now-1w/w');

// Round to end of period instead of start
const endOfMonth = parse('now/mo', 'round-up');

// Override timezone per call
const tokyoMidnight = parse('now/d', 'round-down', {timezone: 'Asia/Tokyo'});

For the full expression syntax, see the core package documentation.

Supported units

ms (millisecond), s (second), m (minute), h (hour), d (day), w (week), mo (month), y (year)

Weeks follow ISO 8601 — they start on Monday.

Custom configuration

You can create a custom parser with a different default timezone, localized keywords, or additional units.

Adding now aliases:

import {createParser} from '@ver0/now-ish';
import {now, units} from '@ver0/now-ish_date-fns';

const parse = createParser({
	now,
	units,
	nowAliases: ['now', 'jetzt', 'сейчас'],
	timezone: 'Europe/Berlin',
});

parse('jetzt-7d'); // works

Adding unit aliases:

import {createParser} from '@ver0/now-ish';
import {now, units} from '@ver0/now-ish_date-fns';

// Add aliases for existing units
const extendedUnits = new Map(units);
extendedUnits.set('t', units.get('d')!); // German: Tag = day
extendedUnits.set('wo', units.get('w')!); // German: Woche = week

const parse = createParser({
	now,
	units: extendedUnits,
	nowAliases: ['now', 'jetzt'],
	timezone: 'UTC',
});

parse('jetzt-7t'); // 7 days ago

Related

• @ver0/now-ish — Core parser, expression syntax, extensibility
• @ver0/now-ish_temporal — Temporal API adapter