Crear un paquete npm para fechas en Node.js

Domina la creación de un paquete npm en Node.js para formatear fechas con precisión. Aquí verás cómo construir, documentar y probar localmente un módulo que expone dos funciones clave: obtener un timestamp y generar una fecha en formato largo con locale configurable, usando JavaScript moderno y buenas prácticas.

¿Cómo crear un paquete npm para manejar fechas?

Construirás un paquete llamado "platzdate" enfocado en dos utilidades: gettimestamp y getlongtime. La primera devuelve Date.now() y la segunda retorna la fecha completa en el locale indicado, con día de la semana, año, mes y zona horaria. Además, se prepara el entorno con Git y npm para trabajar de forma ordenada.

¿Qué estructura de proyecto usar en Node.js?

• Crea la carpeta del paquete: mkdir platzdate.
• Inicializa Git: git init.
• Inicializa npm con valores por defecto: npm init -y.
• Crea el código fuente en src/index.js.
• Mantén todo organizado y sin typos antes de continuar.

¿Qué funciones exporta el paquete platzdate?

• gettimestamp: retorna el valor de Date.now().
• getlongtime: retorna la fecha en formato largo con toLocaleDateString.
• Se exportan con module.exports para uso externo.

Código sugerido en src/index.js:

// src/index.js
const gettimestamp = () => {
  return Date.now();
};

const getlongtime = (locale = 'es') => {
  const options = {
    weekday: 'long',
    year: 'numeric',
    month: 'long',
    day: 'numeric',
    hour: 'numeric',
    minute: 'numeric',
    second: 'numeric',
    timeZoneName: 'short',
  };
  return new Date().toLocaleDateString(locale, options);
};

module.exports = { gettimestamp, getlongtime };

Conceptos y keywords integrados: timestamp, long time, locale, Date.now(), toLocaleDateString, options, module.exports.

¿Cómo documentar y configurar package.json para npm?

La documentación clara y la configuración correcta hacen que el paquete sea fácil de usar e identificar. Se recomienda un README con descripción, instalación y propósito del módulo, además de un package.json con campos clave para la web de npm.

¿Qué incluir en el README.md?

• Nombre del paquete: platzdate.
• Descripción: utilidad para manejar fechas en timestamp y long time.
• Instalación desde terminal:

npm install plazi-date

• Espacio para notas y ejemplos de uso.

¿Qué campos clave van en package.json?

• main: apunta al archivo fuente en src/index.js.
• keywords: date, nodejs para clasificar el proyecto.
• author: tu nombre de contacto.
• license: MIT.
• description: copia la descripción unificada del README.

Buenas prácticas adicionales: - Revisa nombres y rutas antes de publicar. - Guarda cambios y verifica coherencia del contenido.

¿Cómo probar el paquete con npm link antes de publicar?

Probar localmente con npm link crea un enlace simbólico que permite usar el paquete sin subirlo todavía a npm. Así validas que las funciones exportadas funcionan en un proyecto real.

¿Cómo crear el enlace simbólico con npm link?

• Dentro de la carpeta del paquete ejecuta:

npm link

• En tu proyecto principal enlaza el paquete por nombre:

npm link plazi-date

• Verifica que aparece en node_modules y que el editor lo reconoce.

¿Cómo escribir la prueba en Node.js?

Crea date.js en el proyecto principal y consume el paquete con require:

// date.js
const dateFormater = require('plazi-date');

console.log(dateFormater.gettimestamp());
console.log(dateFormater.getlongtime()); // por defecto en español
console.log(dateFormater.getlongtime('en-US')); // inglés de Estados Unidos

Ejecuta la prueba:

node date.js

Qué validar en la salida: - Un número de timestamp en milisegundos. - Fecha en español con día de la semana y zona horaria. - Fecha en inglés al pasar 'en-US' como locale.

Habilidades y conceptos aplicados: creación de paquetes npm, configuración de package.json, documentación con README, exportación con module.exports, formateo de fechas con toLocaleDateString, uso de locales y options, pruebas locales con npm link, enlaces simbólicos en node_modules, consumo con require, ejecución con node.

¿Tienes dudas o quieres compartir cómo extenderías el formato de fecha? Comenta tus ideas y casos de uso.