datevanta
v1.1.0
Published
Modern JavaScript date utility library with a date-fns compatible API
Maintainers
Readme
datevanta
datevanta is a JavaScript date utility library for Node.js and the browser. It provides a large set of small, pure functions for parsing, comparing, formatting, and shifting dates.
The public API matches date-fns: the same function names, arguments, and return values. Point your imports at datevanta and the rest of the call sites stay as they are.
Installation
npm install datevantaUsage
CommonJS
const { parseISO, isValid, isAfter } = require("datevanta");
const parsed = parseISO("2026-10-29");
if (isValid(parsed) && isAfter(parsed, new Date(2020, 0, 1))) {
console.log(parsed.toISOString());
}ES modules
import { format, compareAsc } from "datevanta";
format(new Date(2014, 1, 11), "yyyy-MM-dd");
//=> '2014-02-11'
const dates = [
new Date(1995, 6, 2),
new Date(1987, 1, 11),
new Date(1989, 6, 10),
];
dates.sort(compareAsc);TypeScript declarations are included for both module systems.
What you get
- Compatible API.
parseISO,isValid,isAfter,format, and the rest of the function set behave the same way as in date-fns 4.4.0. - Modular imports. Use the package root, a submodule, or a single function. Bundlers such as webpack, Rollup, and Browserify can tree-shake unused code.
- Native dates. Every function accepts and returns the built-in
Datetype, and leavesDate.prototypeunchanged. - Pure functions. Each call returns a new value and does not mutate the date you passed in.
- Locales. Dozens of locales ship with the package. Import only the ones you need.
- Functional variants. Curried, data-last helpers are available from
datevanta/fp.
Entry points
datevanta— the full function setdatevanta/fp— curried functionsdatevanta/locale— every localedatevanta/locale/<code>— one locale, for exampledatevanta/locale/en-USdatevanta/constants— shared constants such asdaysInYeardatevanta/<function>— one function, for exampledatevanta/parseISO
const { format } = require("datevanta");
const { enUS } = require("datevanta/locale");
format(new Date(2014, 1, 11), "PP", { locale: enUS });import { addDays } from "datevanta/fp";
const addFiveDays = addDays(5);
addFiveDays(new Date(2026, 9, 29));Time zones
Time zone values use the same companion packages as the compatible API: @date-fns/tz and @date-fns/utc. Pass a TZDate or UTCDate into a datevanta function and the result keeps that date type.
Version
datevanta 1.1.0 tracks the date-fns 4.4.0 function set. Default options, locale codes, and format tokens are unchanged.
Full function reference: date-fns.org.
License
This package includes work by Sasha Koss and Lesha Koss, used under the MIT License.
