io.github.jokoframework.utils.date

Class DateTimeUtils

java.lang.Object

io.github.jokoframework.utils.date.DateTimeUtils

public class DateTimeUtils
extends java.lang.Object

Utilidades para trabajar con fechas

Constructor Summary

Constructors

Constructor and Description
DateTimeUtils()

Method Summary

Modifier and Type	Method and Description
static java.util.GregorianCalendar	calendarFromHour(java.lang.String hh) Retorna un GregorianCalendar al cual se le asigna la hora proveída con el formato "HH" (Valor entre "00" y "29").
static java.lang.Boolean	currentTimeAfter(java.lang.Integer time) Retorna True si es que el tiempo actual se encuentra despues que la hora proveída, sino retorna False.
static java.lang.Boolean	currentTimeBefore(java.lang.Integer time) Retorna True si es que el tiempo actual se encuentra antes que la hora proveída, sino retorna False.
static java.lang.Boolean	currentTimeWithin(java.lang.Integer from, java.lang.Integer to) Retorna True si es que la tiempo actual se encuentra entre las horas proveídas, sino retorna False.
static java.util.Date	dateFromHourMinSec(java.lang.String hhmmss) Retorna la fecha actual con el tiempo proveído en el formato "hh:mm:ss" donde la hora esta entre "00" y "29" y los minutos y segundos entre "00" y "59" (De poner más de 23 horas en el campo de hora se ajustara el día de la fecha).
static java.lang.Integer	daysBetween(java.util.Date fromDate, java.util.Date toDate) Retorna un objeto con la cantidad de dias entre las dos fechas proveídas.
static java.lang.Integer	daysTillEndOfMonth() Retorna un objeto con los días que faltan para el final del mes actual.
static java.util.Date	firstDayOfMonth() Retorna la fecha del primer día del mes actual con campos de tiempo en 0 (H:M:S 00:00:00).
static int	getCurrentMonth() Retorna el número del mes actual (1 a 12).
static int	getCurrentYear() Retorna el número del año actual.
static java.util.Date	getDateUntilEndOfMonth() Retorna la fecha y tiempo hasta el fin de mes.
static java.util.Date	getDateUntilEndOfYear() Retorna la fecha y tiempo hasta el fin de año.
static java.util.Date	getDateUntilFriday() Retorna la fecha y tiempo hasta el viernes siguiente.
static java.lang.Boolean	isDay(java.time.DayOfWeek day) Retorna True si el día de la semana actual es igual al proveído, sino False.
static java.util.Date	lastDayOfMonth() Retorna la fecha del último día del mes actual con campos de tiempo en 0 (H:M:S 00:00:00).
static java.util.Date	now() Retorna la fecha y tiempo actual.
static java.util.Date	parseDate(java.lang.String fechaString) Se analiza el string proveído para retornar un objeto del tipo Date con los datos obtenidos del string, el formato definido que debe tener el string es: "dd/MM/yyyy HH:mm:ss" (Día, Mes, Año, Hora, Minuto, Segundo).
static java.util.Date	shiftDate(java.util.Date date, java.lang.Integer seconds, java.lang.Integer minutes, java.lang.Integer hours, java.lang.Integer days, java.lang.Integer months, java.lang.Integer years, java.lang.Boolean delay) Retorna la fecha y tiempo pasada sumándole (Si delay es False) o restándole (Si delay es True) los demás campos proveídos con sus respectivos campos.
static java.util.Date	shiftDate(java.util.Date date, java.lang.Integer miliseconds, java.lang.Integer seconds, java.lang.Integer minutes, java.lang.Integer hours, java.lang.Integer days, java.lang.Integer months, java.lang.Integer years, java.lang.Boolean delay) Retorna la fecha y tiempo pasada sumándole (Si delay es False) o restándole (Si delay es True) los demás campos proveídos con sus respectivos campos.
static java.util.Date	subtractDaysFromDate(java.util.Date date, int days) Retorna la fecha resultante de restar la cantidad de días proveídos a la fecha proveída, el tiempo de la fecha resultante mantiene el valor de la fecha proveída.
static java.util.Date	subtractMonthFromDate(java.util.Date date, int months) Retorna la fecha resultante de restar la cantidad de meses proveídos a la fecha proveída, el tiempo de la fecha resultante mantiene el valor de la fecha proveída.
static java.util.Date	today() Retorna la fecha del día actual con campos de tiempo en 0 (H:M:S 00:00:00).
static java.lang.Integer	yearsBetween(java.util.Date fromDate, java.util.Date toDate) Retorna un objeto con la cantidad de años entre las dos fechas proveídas.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DateTimeUtils

public DateTimeUtils()

Method Detail

now

public static java.util.Date now()

Retorna la fecha y tiempo actual.

Returns:

Fecha y tiempo actual

today

public static java.util.Date today()

Retorna la fecha del día actual con campos de tiempo en 0 (H:M:S 00:00:00).

Returns:

Fecha del día actual con campos de tiempo en 0 (H:M:S 00:00:00)

getCurrentMonth

public static int getCurrentMonth()

Retorna el número del mes actual (1 a 12).

Returns:

Número del mes actual (1 a 12)

getCurrentYear

public static int getCurrentYear()

Retorna el número del año actual.

Returns:

Número del año actual

yearsBetween

public static java.lang.Integer yearsBetween(java.util.Date fromDate,
                                             java.util.Date toDate)

Retorna un objeto con la cantidad de años entre las dos fechas proveídas.

El valor retornado es el resultado de la resta "toDate - fromDate" (No saltan errores al retornar valores negativos).

Parameters:

fromDate - Fecha inferior

toDate - Fecha superior

Returns:

Cantidad de años entre las dos fechas proveídas

daysBetween

public static java.lang.Integer daysBetween(java.util.Date fromDate,
                                            java.util.Date toDate)

Retorna un objeto con la cantidad de dias entre las dos fechas proveídas.

El valor retornado es el resultado de la resta "toDate - fromDate" (No saltan errores al retornar valores negativos).

Parameters:

fromDate - Fecha inferior

toDate - Fecha superior

Returns:

Cantidad de años entre las dos fechas proveídas

firstDayOfMonth

public static java.util.Date firstDayOfMonth()

Retorna la fecha del primer día del mes actual con campos de tiempo en 0 (H:M:S 00:00:00).

Returns:

Fecha del primer día del mes actual con campos de tiempo en 0 (H:M:S 00:00:00)

lastDayOfMonth

public static java.util.Date lastDayOfMonth()

Retorna la fecha del último día del mes actual con campos de tiempo en 0 (H:M:S 00:00:00).

Returns:

Fecha del último día del mes actual con campos de tiempo en 0 (H:M:S 00:00:00)

daysTillEndOfMonth

public static java.lang.Integer daysTillEndOfMonth()

Retorna un objeto con los días que faltan para el final del mes actual.

Returns:

Días que faltan para el final del mes actual

subtractDaysFromDate

public static java.util.Date subtractDaysFromDate(java.util.Date date,
                                                  int days)

Retorna la fecha resultante de restar la cantidad de días proveídos a la fecha proveída, el tiempo de la fecha resultante mantiene el valor de la fecha proveída.

Parameters:

date - Fecha y tiempo a la que se le restaran los días

days - Cantidad de días que se quieren restar a la fecha

Returns:

Fecha resultante de restar la cantidad de días proveídos a la fecha proveída, el tiempo de la fecha física resultante mantiene el valor de la fecha proveída.

subtractMonthFromDate

public static java.util.Date subtractMonthFromDate(java.util.Date date,
                                                   int months)

Retorna la fecha resultante de restar la cantidad de meses proveídos a la fecha proveída, el tiempo de la fecha resultante mantiene el valor de la fecha proveída.

Parameters:

date - Fecha y tiempo a la que se le restaran los meses

months - Cantidad de meses que se quieren restar a la fecha

Returns:

Fecha resultante de restar la cantidad de meses proveídos a la fecha proveída, el tiempo de la fecha física resultante mantiene el valor de la fecha proveída.

currentTimeWithin

public static java.lang.Boolean currentTimeWithin(java.lang.Integer from,
                                                  java.lang.Integer to)

Retorna True si es que la tiempo actual se encuentra entre las horas proveídas, sino retorna False.

Parameters:

from - Limite inferior (Hora del dia en formato de numero)

to - Limite superior (Hora del dia en formato de numero)

Returns:

True si es que el tiempo actual se encuentra entre las horas proveídas, sino False

currentTimeBefore

public static java.lang.Boolean currentTimeBefore(java.lang.Integer time)

Retorna True si es que el tiempo actual se encuentra antes que la hora proveída, sino retorna False.

Parameters:

time - Limite superior (Hora del dia en formato de numero)

Returns:

True si es que el tiempo actual se encuentra antes que la hora proveída, sino False

currentTimeAfter

public static java.lang.Boolean currentTimeAfter(java.lang.Integer time)

Retorna True si es que el tiempo actual se encuentra despues que la hora proveída, sino retorna False.

Parameters:

time - Limite inferior (Hora del dia en formato de numero)

Returns:

True si es que el tiempo actual se encuentra despues que la hora proveída, sino False

calendarFromHour

public static java.util.GregorianCalendar calendarFromHour(java.lang.String hh)

Retorna un GregorianCalendar al cual se le asigna la hora proveída con el formato "HH" (Valor entre "00" y "29").

Parameters:

hh - String con horas con las que se inicializa el calendario, formato "HH" (Valor entre "00" y "29")

Returns:

GregorianCalendar con la hora proveída asignada

dateFromHourMinSec

public static java.util.Date dateFromHourMinSec(java.lang.String hhmmss)

Retorna la fecha actual con el tiempo proveído en el formato "hh:mm:ss" donde la hora esta entre "00" y "29" y los minutos y segundos entre "00" y "59" (De poner más de 23 horas en el campo de hora se ajustara el día de la fecha).

Parameters:

hhmmss - String con horas, minutos y segundos con los que se inicializa el tipo Date, formato "hh:mm:ss" (Valor entre "00" y "29" para hh y entre "00" y "59" para mm y ss)

Returns:

La fecha actual con el tiempo proveído

isDay

public static java.lang.Boolean isDay(java.time.DayOfWeek day)

Retorna True si el día de la semana actual es igual al proveído, sino False.

Parameters:

day - Dia de la semana del tipo DayOfWeek

Returns:

Retorna True si el dia de la semana actual es el dia de la semana proveído

See Also:

DayOfWeek

shiftDate

public static java.util.Date shiftDate(java.util.Date date,
                                       java.lang.Integer seconds,
                                       java.lang.Integer minutes,
                                       java.lang.Integer hours,
                                       java.lang.Integer days,
                                       java.lang.Integer months,
                                       java.lang.Integer years,
                                       java.lang.Boolean delay)

Retorna la fecha y tiempo pasada sumándole (Si delay es False) o restándole (Si delay es True) los demás campos proveídos con sus respectivos campos.

Los campos que se pueden sumar/restar son los de Segundos, Minutos, Horas, Días, Meses y Años.

Parameters:

date - Fecha a la que se le sumaran o restaran los demas campos

seconds - Segundos a sumar o restar

minutes - Minutos a sumar o restar

hours - Horas a sumar o restar

days - Días a sumar o restar

months - Meses a sumar o restar

years - Años a sumar o restar

delay - Si es False se suman los campos a date si es True se restan

Returns:

La suma o resta (Depende del valor de delay) del campo fecha y tiempo "date" con los demás campos respectivos

shiftDate

public static java.util.Date shiftDate(java.util.Date date,
                                       java.lang.Integer miliseconds,
                                       java.lang.Integer seconds,
                                       java.lang.Integer minutes,
                                       java.lang.Integer hours,
                                       java.lang.Integer days,
                                       java.lang.Integer months,
                                       java.lang.Integer years,
                                       java.lang.Boolean delay)

Retorna la fecha y tiempo pasada sumándole (Si delay es False) o restándole (Si delay es True) los demás campos proveídos con sus respectivos campos.

Los campos que se pueden sumar/restar son los de Milisegundos, Segundos, Minutos, Horas, Días, Meses y Años.

Parameters:

date - Fecha a la que se le sumaran o restaran los demas campos

miliseconds - Milisegundos a sumar o restar

seconds - Segundos a sumar o restar

minutes - Minutos a sumar o restar

hours - Horas a sumar o restar

days - Días a sumar o restar

months - Meses a sumar o restar

years - Años a sumar o restar

delay - Si es False se suman los campos a date si es True se restan

Returns:

La suma o resta (Depende del valor de delay) del campo fecha y tiempo "date" con los demas campos respectivos

parseDate

public static java.util.Date parseDate(java.lang.String fechaString)

Se analiza el string proveído para retornar un objeto del tipo Date con los datos obtenidos del string, el formato definido que debe tener el string es: "dd/MM/yyyy HH:mm:ss" (Día, Mes, Año, Hora, Minuto, Segundo).

Parameters:

fechaString - String con el formato "dd/MM/yyyy HH:mm:ss" (Día, Mes, Año, Hora, Minuto, Segundo) con los que se creara el objeto Date

Returns:

Objeto Date construido en base al string proveído

getDateUntilFriday

public static java.util.Date getDateUntilFriday()

Retorna la fecha y tiempo hasta el viernes siguiente.

Returns:

Fecha y tiempo hasta el viernes siguiente

getDateUntilEndOfMonth

public static java.util.Date getDateUntilEndOfMonth()

Retorna la fecha y tiempo hasta el fin de mes.

Returns:

Fecha y tiempo hasta el fin de mes

getDateUntilEndOfYear

public static java.util.Date getDateUntilEndOfYear()

Retorna la fecha y tiempo hasta el fin de año.

Returns:

Fecha y tiempo hasta el fin de año