Java 8 – MonthDay

Este extraño objeto perteneciente al package java.time de java8 es una clase capaz de conservar dia y mes. Estos valores no se guardan con relación a año, o zona, por lo que tienen una utilidad relativa. Como todas las clases de este paquete, esta clase es inmutable y además thread-safe

now(), of(), parse(), from()

static MonthDay	now()
static MonthDay	now(Clock clock)
static MonthDay	now(ZoneId zone)
static MonthDay	of(int month, int dayOfMonth)
static MonthDay	of(Month month, int dayOfMonth)
static MonthDay	parse(CharSequence text)
static MonthDay	parse(CharSequence text, DateTimeFormatter formatter)
static MonthDay	from(TemporalAccessor temporal)

Crea un objeto MonthDay desde diversos orígenes

• Desde el reloj del sistema
• Desde un reloj definido
• Desde el reloj del sistema en la zona indicada
• Pasándole dos enteros correspondientes a mes y día
• Pasándole el mes como literal y día como entero
• Indicando el texto en una string, añadiéndole patrón de formato si no es el estandar
• desde otro campo temporal que contenga como mínimo la información necesaria (día y mes)

En el ejemplo, mostramos todas las posibilidades indicadas

public static void main(String[] args) {
		
	MonthDay ahora= MonthDay.now();
		
	Clock clock = Clock.systemDefaultZone();		
	MonthDay ahoraDef = MonthDay.now(clock);		
	MonthDay ahoraMX = MonthDay.now(ZoneId.of("America/Mexico_City"));
	
	System.out.println("Ahora        :" + ahora);
	System.out.println("Ahora Def    :" + ahoraDef);
	System.out.println("Ahora MX     :" + ahoraMX);
//---of		
	MonthDay unDia = MonthDay.of(11, 30);
	MonthDay otrDia = MonthDay.of(Month.JANUARY, 15 );
		
	System.out.println("unDia        :" + unDia);
	System.out.println("otrDia       :" + otrDia);
// parse		
	MonthDay dParse = MonthDay.parse("--11-21");
	
	DateTimeFormatter formato = DateTimeFormatter.ofPattern("MM dd");
        MonthDay dParseF = MonthDay.parse("12 01", formato);
        
        System.out.println("dParse       :" + dParse);
	System.out.println("dParseF      :" + dParseF);		
// from		
	LocalDateTime mas = LocalDateTime.now();
	MonthDay pFrom = MonthDay.from(mas);
	System.out.println("dFrom        :" + pFrom);	
}

Al ejecutar, veremos los resultados

with(), withDayOfMonth(), withMonth()

MonthDay	with(Month month)
MonthDay	withDayOfMonth(int dayOfMonth)
MonthDay	withMonth(int month)

Estos métodos nos permiten obtener in objeto MontDay, a partir de otro existente, pero cambiando el mes o el día

Podemos ver como trabaja en el siguiente ejemplo

public static void main(String[] args) {
		
	MonthDay hoy = MonthDay.now();		
	System.out.println("Hoy        :" + hoy);
		
	MonthDay d20 = hoy.withDayOfMonth(20);
	System.out.println("d20        :" + d20);

	MonthDay cambioMes = hoy.withMonth(8);
	System.out.println("cambioMes  :" + cambioMes);
  
	MonthDay cambioAny = hoy.with(Month.MARCH);
	System.out.println("cambioMes2 :" + cambioAny);
}

Que nos ofrece los siguientes resultados

isAfter(), isBefore(), isSupported(), isValidYear()

boolean	isAfter(MonthDay other)
boolean	isBefore(MonthDay other)
boolean	equals(Object obj)
int	compareTo(MonthDay other)

Nos permite comprobar si el mes/dia que estamos probando es anterior o posterior a otro objeto MonthDay. En este caso, no podemos utilizar el comparador igual (==)

Si utilizamos el método compareTo, debemos utilizar el 0 y los valores positivos y negativos que surjan, para saber cual es mayor, ya que los valores absolutos que nos facilita son delicados de manejar

boolean	isSupported(TemporalField field)

Nos permite comprobar si la unidad que indicamos, existe en el campo. En este caso, solo se aceptara las correspondientes a día y mes

boolean	isValidYear(int year)

Nos permite comprobar si el MonthDay indicado es correcto para el año indicado

Vemos como podemos utilizarlo en el siguiente ejemplo:

public static void main(String[] args) {
		
	MonthDay d1 = MonthDay.of( Month.AUGUST, 13);
	System.out.println("d1               :" + d1);
		
	MonthDay d2 = MonthDay.of(Month.APRIL, 13);
	System.out.println("d2               :" + d2);
		
	System.out.println("d1 es after?  :" + d1.isAfter(d2));
	System.out.println("d1 es before? :" + d1.isBefore(d2));
	System.out.println("d1 es =?      :" + d1.equals(d2));
	System.out.println("d1 compareTo  :" + d1.compareTo(d2));
		
	boolean ms = d1.isSupported(ChronoField.MILLI_OF_SECOND);
	boolean dw = d1.isSupported(ChronoField.DAY_OF_WEEK);
	boolean dm = d1.isSupported(ChronoField.DAY_OF_MONTH);
		
	System.out.println("Soporta ChronoField.MILLI_OF_SECOND:"+ms);
	System.out.println("Soporta ChronoField.DAY_OF_WEEK    :"+dw);
	System.out.println("Soporta ChronoField.DAY_OF_MONTH   :"+dm);
		
		
	System.out.println("d1 es valido para 2022             :" + d1.isValidYear(2022));
}

Veremos el resultado

get(), getDayOfMonth(), getLong(), getMonth(), getMonthValue()

int	get(TemporalField field)
int	getDayOfMonth()
long	getLong(TemporalField field)
Month	getMonth()
int	getMonthValue()

Nos permite obtener los distintos valores contenidos en el MonthDay, en distintos formatos

Vemos un ejemplo de como utilizar estos métodos sobre un único objeto MonthDay

	public static void main(String[] args) {
		MonthDay hoy = MonthDay.now();
		
		System.out.println("Fecha           :" + 
				hoy.toString());
		System.out.println("Dia mes         :" + 
				hoy.getDayOfMonth());	
		System.out.println("Numero mes      :" + 
				hoy.getMonthValue());	
		
		System.out.println("Mes        Obj  :" + 
				hoy.getMonth());
		
		System.out.println("----------------------------------------");
		System.out.println("Dia   cualquiera int  :" + 
				hoy.get(ChronoField.DAY_OF_MONTH));
		System.out.println("----------------------------------------");
		

	}

Con el siguiente resultado:

range()

ValueRange	range(TemporalField field)

Facilita el rango con que podemos filtrar cualquiera de los valores soportados

El siguiente ejemplo

	public static void main(String[] args) {
		MonthDay hoy = MonthDay.now();
		
		System.out.println("Fecha           :" + 
				hoy.toString());
		
		System.out.println("Rango  dias mes        :" + 
				hoy.range(ChronoField.DAY_OF_MONTH));
		System.out.println("Rango  meses           :" + 
				hoy.range(ChronoField.MONTH_OF_YEAR));	
		
	}

Nos responde con los rangos que se pueden utilizar para mes y para día del mes

toString()

String	toString()

Somo se puede suponer nos ofrece el contenido del objeto en formato string

public static void main(String[] args) {
	MonthDay hoy = MonthDay.now();
		
	System.out.println("mes/dia          :" + 
				hoy.toString());
}

Nos presenta

format()

String	format(DateTimeFormatter formatter)

Formatea el MonthDay según la forma deseada

En el ejemplo, se muestran algunos formatos. Es conveniente revisar DateTimeFormatter

public static void main(String[] args) {
		
	MonthDay hoy = MonthDay.now();

	String formattedDate="";	
	String formateado = hoy.format(DateTimeFormatter.ofPattern("dd - MMM "));
	System.out.println("Formato manual..: " + formateado);
			
}

No da como resultado:

adjustInto()

Temporal	adjustInto(Temporal temporal)

Obtiene un objeto temporal tras aplicarle al MonthDay el ajuste indicado. El objeto obtenido esta limitado por el tipo de ajuste

En el ejemplo, vemos como cambiamos el mes y el dia unicamente tras utilizar un objetoMonthDay con los valores deseados

public static void main(String[] args) {
		
	ZonedDateTime date = ZonedDateTime.now();
	System.out.println(date);  

	MonthDay date1 = MonthDay.parse("--02-03");
	date = (ZonedDateTime)date1.adjustInto(date);
	System.out.println(date);  

}

Consigue el siguiente resultado

atYear()

LocalDate	atYear(int year)

Nos construye un objeto LocalDate, tras añadirle a un MonthDay el año que nos interese

Lo vemos a continuación

public static void main(String[] args) {
	  MonthDay hoy = MonthDay.now();
	  System.out.println("hoy           : " + hoy); 
          LocalDate ahora = hoy.atYear(2022);
	  System.out.println("con año       : " + ahora); 
}

Que nos calcula

Conclusión

La clase MonthDay, mantiene una fecha (día y mes ) y puede ser reutilizados en el resto de clases de la api java.time

Este articulo detalle una de las clases de la api java.time descritas anteriormente en el indice que se facilito sobre este tema