@javiertinc/essentials
Version:
Una librería con variedad de funciones útiles que considero esenciales en la mayoría de los desarrollos web.
176 lines (175 loc) • 6.81 kB
JavaScript
const date = {
/**
* Formatea una fecha a un formato específico
* @param date - La fecha a formatear
* @param format - El formato deseado (por defecto 'dd/mm/yyyy H:i:s')
* @returns La fecha formateada como string
**/
format(date, format = 'dd/mm/yyyy H:i:s') {
const day = date.getDate().toString().padStart(2, '0');
const month = (date.getMonth() + 1).toString().padStart(2, '0');
const year = date.getFullYear().toString();
const yearShort = year.slice(-2);
const hours = date.getHours().toString().padStart(2, '0');
const minutes = date.getMinutes().toString().padStart(2, '0');
const seconds = date.getSeconds().toString().padStart(2, '0');
return format.toLowerCase()
.replace(/yyyy/g, year)
.replace(/yy/g, yearShort)
.replace(/dd/g, day)
.replace(/mm/g, month)
.replace(/h/g, hours)
.replace(/i/g, minutes)
.replace(/s/g, seconds);
},
/**
* Convierte una fecha a la zona horaria especificada
* @param date - La fecha a convertir
* @param timezone - La zona horaria a la cual convertir (por defecto 'America/Santiago')
* @returns La fecha convertida a la zona horaria especificada
**/
parseTimezone(date, timezone = 'America/Santiago') {
return new Date(date.toLocaleString('es-CL', { timeZone: timezone }));
},
/**
* Calcula la cantidad de días entre dos fechas
* @param date1 - Primera fecha
* @param date2 - Segunda fecha
* @returns La cantidad de días entre las dos fechas
**/
daysBetween(date1, date2) {
const oneDay = 24 * 60 * 60 * 1000; // hours*minutes*seconds*milliseconds
return Math.round(Math.abs((date1.getTime() - date2.getTime()) / (oneDay)));
},
time: {
/**
* Suma tiempo a una fecha
* @param date - La fecha a la cual se le sumará el tiempo
* @param time - Un objeto con horas, minutos y segundos a sumar
* @param time.hours - Horas a sumar
* @param time.minutes - Minutos a sumar
* @param time.seconds - Segundos a sumar
* @returns La nueva fecha con el tiempo sumado
**/
add(date, time = { hours: 0, minutes: 0, seconds: 0 }) {
date.setHours(date.getHours() + time.hours);
date.setMinutes(date.getMinutes() + time.minutes);
date.setSeconds(date.getSeconds() + time.seconds);
return date;
},
/**
* Resta tiempo a una fecha
* @param date - La fecha a la cual se le restará el tiempo
* @param time - Un objeto con horas, minutos y segundos a restar
* @param time.hours - Horas a restar
* @param time.minutes - Minutos a restar
* @param time.seconds - Segundos a restar
* @returns La nueva fecha con el tiempo restado
**/
sub(date, time = { hours: 0, minutes: 0, seconds: 0 }) {
date.setHours(date.getHours() - time.hours);
date.setMinutes(date.getMinutes() - time.minutes);
date.setSeconds(date.getSeconds() - time.seconds);
return date;
}
},
days: {
/**
* Suma días a una fecha
* @param date - La fecha a la cual se le sumarán los días
* @param days - La cantidad de días a sumar
* @returns La nueva fecha con los días sumados
**/
add(date, days) {
date.setDate(date.getDate() + days);
return date;
},
/**
* Resta días a una fecha
* @param date - La fecha a la cual se le restarán los días
* @param days - La cantidad de días a restar
* @returns La nueva fecha con los días restados
**/
sub(date, days) {
date.setDate(date.getDate() - days);
return date;
}
},
months: {
/**
* Suma meses a una fecha
* @param date - La fecha a la cual se le sumarán los meses
* @param months - La cantidad de meses a sumar
* @returns La nueva fecha con los meses sumados
**/
add(date, months) {
date.setMonth(date.getMonth() + months);
return date;
},
/**
* Resta meses a una fecha
* @param date - La fecha a la cual se le restarán los meses
* @param months - La cantidad de meses a restar
* @returns La nueva fecha con los meses restados
**/
sub(date, months) {
date.setMonth(date.getMonth() - months);
return date;
}
},
years: {
/**
* Suma años a una fecha
* @param date - La fecha a la cual se le sumarán los años
* @param years - La cantidad de años a sumar
* @returns La nueva fecha con los años sumados
**/
add(date, years) {
date.setFullYear(date.getFullYear() + years);
return date;
},
/**
* Resta años a una fecha
* @param date - La fecha a la cual se le restarán los años
* @param years - La cantidad de años a restar
* @returns La nueva fecha con los años restados
**/
sub(date, years) {
date.setFullYear(date.getFullYear() - years);
return date;
}
},
/**
* Obtiene la edad a partir de una fecha de nacimiento
* @param birthdate - Fecha de nacimiento en formato 'YYYY-MM-DD'
* @returns Un objeto con años, meses y días
**/
getAge(birthdate) {
let today = new Date();
let birthDate = new Date(birthdate);
return {
years: today.getFullYear() - birthDate.getFullYear(),
months: today.getMonth() - birthDate.getMonth(),
days: today.getDate() - birthDate.getDate(),
};
},
/**
* Obtiene el nombre del día de la semana en el idioma especificado
* @param date - La fecha de la cual obtener el día de la semana
* @param locale - El código de idioma (ej: 'es-ES', 'en-US', 'fr-FR')
* @returns El nombre del día de la semana en el idioma especificado
**/
getDayOfWeek(date, locale = 'es-ES') {
return date.toLocaleDateString(locale, { weekday: 'long' });
},
/**
* Obtiene el nombre del mes en el idioma especificado
* @param date - La fecha de la cual obtener el mes
* @param locale - El código de idioma (ej: 'es-ES', 'en-US', 'fr-FR')
* @returns El nombre del mes en el idioma especificado
**/
getMonth(date, locale = 'es-ES') {
return date.toLocaleDateString(locale, { month: 'long' });
}
};
export default date;