date-light — biblioteca de utilidades de fechas en TypeScript de 3.11 KB

A veces quieres incluir una biblioteca de fechas, pero no necesitas todo: locale/zona horaria/duration/plugins.

date-light es una pequeña biblioteca de utilidades de fechas que resuelve ese problema. Ofrece 39 funciones, eligiendo solo las tareas con fechas que más se usan en web/apps. No tiene dependencias en tiempo de ejecución e incluye tipos de TypeScript y entry points ESM/CJS.

import { addDays, differenceInDays, format, startOfWeek } from "date-light";  
  
const launch = new Date(2026, 5, 30, 14, 30);  
const reminder = addDays(launch, -7);  
  
format(launch, "yyyy-MM-dd HH:mm"); // "2026-06-30 14:30"  
format(startOfWeek(launch), "yyyy-MM-dd"); // "2026-06-29"  
differenceInDays(launch, reminder); // 7  

Qué ofrece

format, parseISO, parse

addDays, addMonths, addYears, addHours, subDays, subMonths...

differenceInDays, differenceInMonths, differenceInYears

isBefore, isAfter, isEqual, isSameDay, isSameMonth

isWeekend, isLeapYear, isValid, getDaysInMonth

startOfDay, endOfWeek, startOfMonth, endOfYear, etc.

No modifica el Date de entrada. Todas las funciones devuelven un Date nuevo o calculan un valor.

Por qué se creó

La mayoría de las apps usan solo una parte muy pequeña de una biblioteca de fechas.

Normalmente basta con formatear fechas, parsear cadenas ISO, sumar algunos días, obtener la diferencia entre dos fechas y ajustar al inicio o fin de una semana/mes/año.

date-light apuesta por mantener solo ese alcance de forma compacta. Conserva una experiencia de uso parecida a date-fns, pero agrupa únicamente las utilidades más frecuentes.

Lo que intencionalmente no incluye

No incluye locale, base de datos de zonas horarias, objetos duration, plugins ni una API encadenable.

Si necesitas esas funciones, Intl, Temporal, Luxon o date-fns son opciones más adecuadas. date-light es una herramienta para cuando solo quieres un manejo general de fechas en apps, pero en un paquete pequeño.

Tamaño

Aproximadamente 3.11 KB minzipped tomando como referencia 39 funciones.

Según el criterio de comparación de tamaño de bundle de la documentación, es unas 5.9 veces más pequeño que traer 20 funciones similares desde date-fns.

GitHub: https://github.com/flyingsquirrel0419/date-light
npm: npm install date-light
docs/playground: https://date-light.flyingsquirrel.me/