Year with() Método en Java con ejemplos

En la clase Year, hay dos tipos de método with() según los parámetros que se le pasen.

con (ajustador TemporalAdjuster)

con el método (ajustador TemporalAdjuster) de la clase de año utilizada para ajustar este año usando TemporalAdjuster y después del ajuste devuelve la copia del año ajustado. El ajuste se lleva a cabo usando el objeto de estrategia de ajustador especificado. Esta instancia de Year es inmutable y no se ve afectada por esta llamada de método.

Sintaxis:

public Year with(TemporalAdjuster adjuster)

Parámetros: Este método acepta ajustador como parámetro que es el ajustador a utilizar.

Valor devuelto: Este método devuelve un Año basado en esto con el ajuste realizado.

Excepción: este método arroja las siguientes excepciones:

• DateTimeException : si no se puede realizar el ajuste.
• ArithmeticException : si se produce un desbordamiento numérico.

Los siguientes programas ilustran el método with():
Programa 1:

// Java program to demonstrate
// Year.with() method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a Year object
        Year yr
            = Year.of(2019);
  
        // print instance
        System.out.println("Year before"
                           + " adjustment: "
                           + yr);
  
        // apply with method of Year class
        Year updatedlocal = yr.with(Year.of(2012));
  
        // print instance
        System.out.println("Year after"
                           + " adjustment: "
                           + updatedlocal);
    }
}

Year before adjustment: 2019
Year after adjustment: 2012

with(campo TemporalField, long newValue)

with(TemporalField field, long newValue) método de la clase Year que se usa para establecer el campo especificado de Year en un nuevo valor y devuelve la copia de la nueva hora. Este método se puede usar para cambiar cualquier campo compatible, como el año. Se lanza una excepción si no es posible establecer el nuevo valor debido a que el campo no es compatible o por alguna otra razón. Esta instancia de Year es inmutable y no se ve afectada por esta llamada de método.

Sintaxis:

public Year with(TemporalField field, long newValue)

Parámetros: este método acepta campo, que es el campo que se establecerá en el resultado, y newValue, que es el nuevo valor del campo en el resultado como parámetros.

Valor de retorno: este método devuelve un año basado en esto con el conjunto de campos especificado.

Excepción: este método arroja las siguientes excepciones:

• DateTimeException : si no se puede realizar el ajuste.
• UnsupportedTemporalTypeException : si el campo no es compatible.
• ArithmeticException : si se produce un desbordamiento numérico.

Los siguientes programas ilustran el método with():
Programa 1:

// Java program to demonstrate
// Year.with() method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a Year object
        Year yr
            = Year.of(2019);
  
        // print instance
        System.out.println("Year before"
                           + " applying method: "
                           + yr);
  
        // apply with method of Year class
        Year updatedlocal
            = yr.with(ChronoField.YEAR, 2100);
  
        // print instance
        System.out.println("Year after"
                           + " applying method: "
                           + updatedlocal);
    }
}

Year before applying method: 2019
Year after applying method: 2100

Referencias:
https://docs.oracle.com/javase/10/docs/api/java/time/Year.html#with(java.time.temporal.TemporalAdjuster)
https://docs.oracle.com/javase/ 10/docs/api/java/time/Year.html#with(java.time.temporal.TemporalField, largo)