Date

jtEssentials.date

Aquí hay algunas funciones que facilitan la vida respecto a las fechas y horas.

Important

Importa jtEssentials directamente en tu proyecto.

Para los ejemplos usaremos la importación directa jtEssentials

import jtEssentials from '@javiert.dev/essentials';

Format

Esta función permite formatear una fecha a un formato específico, con la máscara que le indiques.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha que deseas formatear
format	String	Opcional	dd/mm/yyyy h:i:s	Formato que deseas aplicar a la fecha. No importan las mayúsculas/minúsculas.

Formato	Descripción
YYYY	Año con 4 dígitos (ej: 2025)
YY	Año con 2 dígitos (ej: 25)
MM	Mes con 2 dígitos (ej: 05)
DD	Día con 2 dígitos (ej: 14)
h	Hora con 2 dígitos (ej: 00)
i	Minutos con 2 dígitos (ej: 00)
s	Segundos con 2 dígitos (ej: 00)

Estructura

jtEssentials.date.format(date: Date, format: string): string

Ejemplos de uso

let result = jtEssentials.date.format(new Date(), 'YYYY-MM-DD');
console.log(result);
//Resultado: "2025-05-14"

let result = jtEssentials.date.format(new Date(), 'YY/MM/DD');
console.log(result);
//Resultado: "25/05/14"

let result = jtEssentials.date.format(new Date(), 'h:i:s');
console.log(result);
//Resultado: "00:00:00"

let result = jtEssentials.date.format(new Date(), 'DD/MM/YYYY h:i:s');
console.log(result);
//Resultado: "14/05/2025 00:00:00"

parseTimezone

Esta función permite traducir la fecha a una zona horaria específica.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha que deseas traducir a una zona horaria específica
timezone	String	Opcional	America/Santiago	Zona horaria a la que deseas traducir la fecha. Puedes revisar todas las zonas horarias esta página de Wikipedia.

Estructura

jtEssentials.date.parseTimezone(date: Date, timezone: string): Date

Ejemplos de uso

let result = jtEssentials.date.parseTimezone(new Date(), 'America/Santiago');
console.log(result);
//Resultado: "2025-05-14T00:00:00.000Z"

daysBetween

Esta función permite calcular la diferencia de días entre dos fechas.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date1	Date	Obligatorio		Primera fecha
date2	Date	Obligatorio		Segunda fecha

Estructura

jtEssentials.date.daysBetween(date1: Date, date2: Date): number

Ejemplos de uso

let result = jtEssentials.date.daysBetween(new Date('2025-05-14'), new Date('2025-05-20'));
console.log(result);
//Resultado: 6

time

add

Esta función permite sumar un tiempo específico a una fecha.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha a la que deseas sumar el tiempo
time.hours	Number	Opcional	0	Horas que deseas sumar a la fecha
time.minutes	Number	Opcional	0	Minutos que deseas sumar a la fecha
time.seconds	Number	Opcional	0	Segundos que deseas sumar a la fecha

Estructura

jtEssentials.date.time.add(date: Date, time: { hours: number = 0, minutes: number = 0, seconds: number = 0 }): Date 

Ejemplos de uso

let result = jtEssentials.date.time.add(new Date('2025-05-14'), { hours: 1, minutes: 30, seconds: 0 });
console.log(result);
//Resultado: "2025-05-14T01:30:00.000Z"

let result = jtEssentials.date.time.add(new Date('2025-05-14'), { minutes: 30 });
console.log(result);
//Resultado: "2025-05-14T00:30:00.000Z"

sub

Esta función permite restar un tiempo específico a una fecha.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha a la que deseas restar el tiempo
time.hours	Number	Opcional	0	Horas que deseas restar a la fecha
time.minutes	Number	Opcional	0	Minutos que deseas restar a la fecha
time.seconds	Number	Opcional	0	Segundos que deseas restar a la fecha

Estructura

jtEssentials.date.time.sub(date: Date, time: { hours: number = 0, minutes: number = 0, seconds: number = 0 }): Date 

Ejemplos de uso

let result = jtEssentials.date.time.sub(new Date('2025-05-14'), { hours: 1, minutes: 30, seconds: 0 });
console.log(result);
//Resultado: "2025-05-13T22:30:00.000Z"

days

add

Esta función permite sumar días a una fecha.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha a la que deseas sumar los días
days	Number	Obligatorio		Días que deseas sumar a la fecha

Estructura

jtEssentials.date.days.add(date: Date, days: number): Date 

Ejemplos de uso

let result = jtEssentials.date.days.add(new Date('2025-05-14'), 5);
console.log(result);
//Resultado: "2025-05-19T00:00:00.000Z"

sub

Esta función permite restar días a una fecha.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha a la que deseas restar los días
days	Number	Obligatorio		Días que deseas restar a la fecha

Estructura

jtEssentials.date.days.sub(date: Date, days: number): Date 

Ejemplos de uso

let result = jtEssentials.date.days.sub(new Date('2025-05-14'), 5);
console.log(result);
//Resultado: "2025-05-09T00:00:00.000Z"

months

add

Esta función permite sumar meses a una fecha.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha a la que deseas sumar los meses
months	Number	Obligatorio		Meses que deseas sumar a la fecha

Estructura

jtEssentials.date.months.add(date: Date, months: number): Date

Ejemplos de uso

let result = jtEssentials.date.months.add(new Date('2025-05-14'), 5);
console.log(result);
//Resultado: "2025-10-14T00:00:00.000Z"

sub

Esta función permite restar meses a una fecha.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha a la que deseas restar los meses
months	Number	Obligatorio		Meses que deseas restar a la fecha

Estructura

jtEssentials.date.months.sub(date: Date, months: number): Date 

Ejemplos de uso

let result = jtEssentials.date.months.sub(new Date('2025-05-14'), 5);
console.log(result);
//Resultado: "2025-01-14T00:00:00.000Z"

years

add

Esta función permite sumar años a una fecha.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha a la que deseas sumar los años
years	Number	Obligatorio		Años que deseas sumar a la fecha

Estructura

jtEssentials.date.years.add(date: Date, years: number): Date 

Ejemplos de uso

let result = jtEssentials.date.years.add(new Date('2025-05-14'), 5);
console.log(result);
//Resultado: "2030-05-14T00:00:00.000Z"

sub

Esta función permite restar años a una fecha.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha a la que deseas restar los años
years	Number	Obligatorio		Años que deseas restar a la fecha

Estructura

jtEssentials.date.years.sub(date: Date, years: number): Date 

Ejemplos de uso

let result = jtEssentials.date.years.sub(new Date('2025-05-14'), 5);
console.log(result);
//Resultado: "2020-05-14T00:00:00.000Z"

getAge

Esta función permite calcular la edad de una persona a partir de su fecha de nacimiento.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
birthdate	String	Obligatorio		Fecha de nacimiento de la persona en formato 'YYYY-MM-DD'

Estructura

jtEssentials.date.getAge(birthdate: string): { years: number; months: number; days: number }

Ejemplos de uso

let result = jtEssentials.date.getAge('1990-05-14');
console.log(result);
//Resultado: { years: 35, months: 0, days: 0 }

getDayOfWeek

Esta función permite obtener el nombre del día de la semana de una fecha específica.

Note

Se retornará siempre en minúsculas. Puedes capitalizarlo usando esta función jtEssentials.text.capitalize(result).

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha de la que deseas obtener el día de la semana
locale	String	Opcional	es-ES	Localización para el nombre del día de la semana. Puedes usar cualquier localización válida de JavaScript, como en-US, fr-FR, etc.

Estructura

jtEssentials.date.getDayOfWeek(date: Date, locale?: string = 'es-ES'): string

Ejemplos de uso

let result = jtEssentials.date.getDayOfWeek(new Date('2025-05-14'));
console.log(result);
//Resultado: "miércoles"

let result = jtEssentials.date.getDayOfWeek(new Date('2025-05-14'), 'en-US');
console.log(result);
//Resultado: "wednesday"

getMonth

Esta función permite obtener el nombre del mes de una fecha específica.

Note

Se retornará siempre en minúsculas. Puedes capitalizarlo usando esta función jtEssentials.text.capitalize(result).

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
date	Date	Obligatorio		Fecha de la que deseas obtener el mes
locale	String	Opcional	es-ES	Localización para el nombre del mes. Puedes usar cualquier localización válida de JavaScript, como en-US, fr-FR, etc.

Estructura

jtEssentials.date.getMonth(date: Date, locale?: string = 'es-ES'): string

Ejemplos de uso

let result = jtEssentials.date.getMonth(new Date('2025-05-14'));
console.log(result);
//Resultado: "mayo"

let result = jtEssentials.date.getMonth(new Date('2025-05-14'), 'en-US');
console.log(result);
//Resultado: "may"