Método LocalDateTime with() en Java con ejemplos

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

con (ajustador TemporalAdjuster)

with(TemporalAdjuster ajustador) método de la clase LocalDateTime utilizado para ajustar esta fecha y hora usando TemporalAdjuster y después del ajuste devuelve la copia de la fecha y hora ajustada. El ajuste se lleva a cabo usando el objeto de estrategia de ajustador especificado. Esta instancia de LocalDateTime es inmutable y no se ve afectada por esta llamada de método. Un ajustador simple usa para establecer uno de los campos, como el campo del año donde un ajustador más complejo podría establecer la hora hasta el último día del año.

Sintaxis:

public LocalDateTime 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 LocalDateTime 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
// LocalDateTime.with() method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a LocalDateTime object
        LocalDateTime local
            = LocalDateTime.parse(
                "2020-12-31T10:15:30");
  
        // print instance
        System.out.println("LocalDateTime before"
                           + " adjustment: "
                           + local);
  
        // apply with method of LocalDateTime class
        LocalDateTime updatedlocal
            = local.with(Month.OCTOBER)
                  .with(TemporalAdjusters
                            .firstDayOfMonth());
  
        // print instance
        System.out.println("LocalDateTime after"
                           + " adjustment: "
                           + updatedlocal);
    }
}

LocalDateTime before adjustment: 2020-12-31T10:15:30
LocalDateTime after adjustment: 2020-10-01T10:15:30

with(campo TemporalField, long newValue)

with(TemporalField field, long newValue) método de la clase LocalDateTime utilizado para establecer el campo especificado de LocalDateTime en un nuevo valor y devuelve la copia de la nueva hora. Este método se puede utilizar para cambiar cualquier campo compatible, como año, día, mes, hora, minuto o segundo. 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 LocalDateTime es inmutable y no se ve afectada por esta llamada de método.

Sintaxis:

public LocalDateTime 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 LocalDateTime 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
// LocalDateTime.with() method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a LocalDateTime object
        LocalDateTime local
            = LocalDateTime.parse(
                "2021-01-01T19:55:30");
  
        // print instance
        System.out.println("LocalDateTime before"
                           + " applying method: "
                           + local);
  
        // apply with method of LocalDateTime class
        LocalDateTime updatedlocal
            = local.with(ChronoField.YEAR, 2017);
  
        // print instance
        System.out.println("LocalDateTime after"
                           + " applying method: "
                           + updatedlocal);
    }
}

LocalDateTime before applying method: 2021-01-01T19:55:30
LocalDateTime after applying method: 2017-01-01T19:55:30

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