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

Java中的 Year with() 方法和示例

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

with(TemporalAdjuster 调节器)

用于使用 TemporalAdjuster 调整今年的Year类的with(TemporalAdjusteradjuster)方法，调整后返回调整后的 Year 的副本。使用指定的调整器策略对象进行调整。 Year 的这个实例是不可变的，不受此方法调用的影响。

句法：

public Year with(TemporalAdjuster adjuster)

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

返回值：此方法在此基础上返回经过调整的年份。

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

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

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

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

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

句法：

public Year with(TemporalField field, long newValue)

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

返回值：此方法基于此返回带有指定字段集的年份。

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

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

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

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

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