Moment.js / Day.js para JavaScript (Node.js): guía completa con ejemplos

¿Qué es esta biblioteca y para qué sirve?

\n\n

Moment.js y Day.js son dos potentes bibliotecas para JavaScript, diseñadas para trabajar con fechas y horas. Resuelven un problema fundamental: el objeto nativo Date en JavaScript es extremadamente incómodo para tareas cotidianas. No admite formato, cálculos complejos con fechas, análisis de cadenas en diferentes formatos ni trabajo con zonas horarias sin escribir decenas de líneas de código.

\n\n

Moment.js fue durante mucho tiempo el estándar de facto, pero ahora se considera "legacy": su desarrollo está congelado y no se recomienda para nuevos proyectos debido a su gran tamaño (alrededor de 300 KB). Lo ha reemplazado Day.js, una biblioteca ligera (solo 2 KB) y rápida con una API prácticamente idéntica. Day.js es totalmente compatible con Moment.js en la mayoría de las operaciones básicas, lo que facilita la migración.

\n\n

Ambas bibliotecas ofrecen:

\n

\n
• Análisis de fechas a partir de cadenas de cualquier formato
\n
• Formateo de fechas en cadenas legibles
\n
• Manipulaciones (suma/resta de días, meses, años)
\n
• Comparación de fechas (antes, después, entre)
\n
• Trabajo con zonas horarias (a través de complementos)
\n
• Localización (soporte para diferentes idiomas y formatos regionales)
\n

\n\n

En este artículo, nos centraremos en Day.js como alternativa moderna, pero todos los ejemplos también funcionarán con Moment.js con cambios mínimos.

\n\n

Instalación

\n\n

La instalación para Node.js se realiza a través de npm o yarn. Para el navegador, se puede usar un CDN.

\n\n

Instalación de Day.js

\n

# A través de npm\nnpm install dayjs\n\n# A través de yarn\nyarn add dayjs

\n\n

Instalación de Moment.js

\n

npm install moment\n\n# o\nyarn add moment

\n\n

Inclusión en el proyecto

\n

// Day.js\nconst dayjs = require('dayjs');\n\n// Moment.js\nconst moment = require('moment');

\n\n

Inicio rápido con un ejemplo de código

\n\n

Después de la instalación, puede comenzar a trabajar con fechas de inmediato. Aquí hay un ejemplo mínimo que demuestra las capacidades principales:

\n\n

const dayjs = require('dayjs');\n\n// Fecha y hora actuales\nconst now = dayjs();\nconsole.log('Ahora:', now.format('DD.MM.YYYY HH:mm:ss'));\n\n// Análisis de una cadena\nconst date = dayjs('2024-03-15');\nconsole.log('Análisis:', date.format('DD.MM.YYYY'));\n\n// Manipulaciones\nconst nextWeek = dayjs().add(7, 'day');\nconsole.log('En una semana:', nextWeek.format('DD.MM.YYYY'));\n\n// Diferencia entre fechas\nconst diff = nextWeek.diff(now, 'day');\nconsole.log('Diferencia en días:', diff);\n\n// Comparación\nconsole.log('¿Hoy es antes?', now.isBefore(nextWeek)); // true

\n\n

Métodos/Funciones principales

\n\n

1. dayjs() — creación de un objeto de fecha

\n

Qué hace: Crea un objeto Day.js que representa un momento específico en el tiempo. Sin argumentos, devuelve la fecha y hora actuales.

\n

Parámetros:

\n

\n
• date (opcional) — una cadena, número (timestamp), objeto Date u otro objeto Day.js
\n
• format (opcional) — una cadena de formato para el análisis, si date es una cadena
\n

\n

Ejemplo de código funcional:

\n

// Fecha actual\nconst now = dayjs();\n\n// Desde una cadena\nconst fromString = dayjs('2024-12-31');\n\n// Desde un timestamp (milisegundos)\nconst fromTimestamp = dayjs(1704067200000);\n\n// Desde un objeto Date\nconst fromDate = dayjs(new Date(2024, 0, 1)); // 1 de enero de 2024\n\n// Especificando el formato\nconst customFormat = dayjs('31.12.2024', 'DD.MM.YYYY');\n\nconsole.log(now.format()); // 2024-03-15T10:30:00+03:00\nconsole.log(customFormat.format('YYYY-MM-DD')); // 2024-12-31

\n\n

2. format() — formateo de fecha

\n

Qué hace: Convierte el objeto de fecha en una cadena según un formato