Java中的 LocalDateTime with() 方法及示例

在 LocalDateTime 类中，根据传递给它的参数，有两种类型的 with() 方法。

with(TemporalAdjuster 调节器)

LocalDateTime类的with(TemporalAdjusteradjuster)方法用于使用 TemporalAdjuster 调整此日期时间，调整后返回调整后的日期时间的副本。使用指定的调整器策略对象进行调整。此 LocalDateTime 实例是不可变的，不受此方法调用的影响。一个简单的调整器用于设置其中一个字段，例如年份字段，一个更复杂的调整器可能会将时间设置为一年中的最后一天。

句法：

public LocalDateTime with(TemporalAdjuster adjuster)

参数：此方法接受调节器作为要使用的调节器的参数。

返回值：此方法基于此返回一个 LocalDateTime 并进行调整。

异常：此方法抛出以下异常：

• DateTimeException – 如果无法进行调整。
• ArithmeticException – 如果发生数字溢出。

下面的程序说明了 with() 方法：
方案一：

// 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(TemporalField field, long newValue)

LocalDateTime类的with(TemporalField field, long newValue)方法，用于将 LocalDateTime 的指定字段设置为新值并返回新时间的副本。该方法可用于更改任何支持的字段，例如年、日、月、时、分或秒。如果由于不支持该字段或由于某些其他原因而无法设置新值，则会引发异常。此 LocalDateTime 实例是不可变的，不受此方法调用的影响。

句法：

public LocalDateTime with(TemporalField field, long newValue)

参数：此方法接受作为结果中要设置的字段的字段和结果中字段的新值作为参数的newValue 。

返回值：该方法基于此返回一个LocalDateTime，并带有指定的字段集。

异常：此方法抛出以下异常：

• DateTimeException – 如果无法进行调整。
• UnsupportedTemporalTypeException – 如果不支持该字段。
• ArithmeticException – 如果发生数字溢出。

下面的程序说明了 with() 方法：
方案一：

// 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

参考：
https://docs.oracle.com/javase/10/docs/api/java Java Java)
https://docs.oracle.com/javase/10/docs/api/java Java Java, long)