native-dates

API / Functions

today() function

The calendar date it is right now, with no clock attached. Where you stand decides the answer, so it takes a zone.

import { today } from 'native-dates'

Signature

today(zone?): CalendarDate

Parameters

zonestring

The zone to judge the day from. Leave it out for the default zone.

Returns

CalendarDate

Today’s date in zone. It has no time of day, so it never shifts when read somewhere else.

Two zones, two todays

At 9 PM on November 10 in Los Angeles it is already November 11 in Berlin.

Call Returns
today('America/Los_Angeles') 2026-11-10
today('Europe/Berlin') 2026-11-11
today('America/Los_Angeles').equals(today('Europe/Berlin')) false

Start a chain from today

Most date math starts here. tomorrow() and yesterday() are the same call one day either side.

due.js
import { today } from 'native-dates';

const due = today().plus(30, 'days');
const review = today().next('friday');
const kickoff = today().startOf('month').plus(1, 'month');

A date is not a number

today() < due throws. Compare dates with isBefore() and isAfter(), which say what they mean.

Edit this pageUpdated Nov 10, 2026