external-lib

Librería utilitaria de JavaScript/Node.js con funciones helper para diferentes tareas.

⚠️ Nota: Esta librería está en desarrollo activo. Pronto se agregarán más módulos y funcionalidades.

Instalación

npm install external-lib

Módulos Disponibles

📅 Datetime (utils/datetime.js)

Utilidades para manipulación y formateo de fechas, basadas en Luxon.

Funciones

| Función | Descripción | |---------|-------------| | getNowByFormat(format?) | Obtiene la fecha actual con formato. Por defecto yyyy-MM-dd | | formatDate(date, format?) | Formatea una fecha ISO al formato especificado | | getDateByFormat(date, format?) | Convierte una fecha ISO al formato deseado con zona horaria | | addMonthsDate(date, months, format?) | Suma meses a una fecha específica | | detectFormat(date) | Detecta el formato de una cadena de fecha | | validateDateAndFormat(date, outputFormat?) | Valida y formatea fechas flexibles | | isValidFlexibleDate(date) | Valida si una fecha es válida en múltiples formatos | | getStartOf(period?, format?) | Obtiene el inicio de un período (day, month, year, etc.) |

Ejemplos de uso

import { getNowByFormat, formatDate, addMonthsDate } from 'external-lib';

// Fecha actual
getNowByFormat(); // "2026-06-03"
getNowByFormat('dd/MM/yyyy HH:mm:ss'); // "03/06/2026 16:56:09"

// Formatear fecha
formatDate('2026-06-03T10:30:00Z'); // "2026-06-03"

// Sumar meses
addMonthsDate('2026-06-03 10:30:00', 3); // "2026-09-03 10:30:00"

// Validación flexible
import { isValidFlexibleDate } from 'external-lib';
isValidFlexibleDate('03/06/2026'); // true
isValidFlexibleDate('2026-06-03'); // true

// Inicio de período (equivale a moment().startOf())
import { getStartOf } from 'external-lib';
getStartOf();                       // "2026-06-01 00:00:00" (inicio de mes actual)
getStartOf('day');                  // "2026-06-03 00:00:00" (inicio del día)
getStartOf('year');                 // "2026-01-01 00:00:00" (inicio del año)
getStartOf('week');                 // "2026-06-01 00:00:00" (inicio de semana)

Estructura del proyecto

external-lib/
├── index.js           # Punto de entrada principal
├── utils/
│   └── datetime.js    # Módulo de utilidades de fecha/hora
├── package.json
└── README.md

Configuración de zona horaria

Por defecto, todas las funciones trabajan con la zona horaria America/Bogota (Colombia). Esto puede modificarse directamente en el código fuente si necesitas otra zona horaria.

Requisitos

• Node.js >= 14.x
• npm >= 6.x

Licencia

ISC