Java OffsetDateTime with()方法及示例

Java OffsetDateTime with()方法及示例

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

with(TemporalAdjuster adjuster)

OffsetDateTime 类的 with(TemporalAdjuster adjuster) 方法用于使用TemporalAdjuster来调整这个OffsetDateTime,调整后返回调整后的OffsetDateTime的副本。OffsetDateTime的这个实例是不可改变的,不受这个方法调用的影响。

语法

public OffsetDateTime with(TemporalAdjuster adjuster)

参数: 该方法接受 调整器 作为参数,它是要使用的调整器。

返回值 :该方法返回一个基于该调整器的OffsetDateTime。

异常: 该方法会抛出以下异常。

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

下面的程序说明了with()方法:
程序1 :

// Java program to demonstrate
// OffsetDateTime.with() method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a OffsetDateTime object
        OffsetDateTime off
            = OffsetDateTime.parse("2018-12-12T13:30:30+05:00");
  
        // print instance
        System.out.println("OffsetDateTime before"
                           + " adjustment: "
                           + off);
  
        // apply with method of OffsetDateTime class
        OffsetDateTime updatedlocal
            = off.with(Month.JUNE)
                  .with(TemporalAdjusters
                            .firstDayOfMonth());
  
        // print instance
        System.out.println("OffsetDateTime after"
                           + " adjustment: "
                           + updatedlocal);
    }
}

输出。

OffsetDateTime before adjustment: 2018-12-12T13:30:30+05:00
OffsetDateTime after adjustment: 2018-06-01T13:30:30+05:00

with(TemporalField field, long newValue)

OffsetDateTime 类的 with(TemporalField field, long newValue) 方法用于将OffsetDateTime的指定字段设置为一个新值,并返回新时间的副本。这个方法可以用来改变任何支持的字段,例如年、月、日。如果由于该字段不被支持或其他原因而无法设置新值,则会抛出一个异常。OffsetDateTime的这个实例是不可改变的,不受这个方法调用的影响。

语法

public OffsetDateTime with(TemporalField field, long newValue)

参数: 该方法接受 field (即要在结果中设置的字段)和 newValue (即结果中该字段的新值)作为参数。

返回值: 该方法返回一个基于指定字段设置的OffsetDateTime。

异常: 该方法会抛出以下异常。

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

以下程序说明了with()方法:
程序1 :

// Java program to demonstrate
// OffsetDateTime.with() method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a OffsetDateTime object
        OffsetDateTime off
            = OffsetDateTime.parse("2018-12-12T13:30:30+05:00");
  
        // print instance
        System.out.println("OffsetDateTime before"
                           + " adjustment: "
                           + off);
  
        // apply with method of OffsetDateTime class
        OffsetDateTime updatedlocal
            = off.with(ChronoField.DAY_OF_MONTH, 31);
  
        // print instance
        System.out.println("OffsetDateTime after"
                           + " applying method: "
                           + updatedlocal);
    }
}

输出。

OffsetDateTime before adjustment: 2018-12-12T13:30:30+05:00
OffsetDateTime after applying method: 2018-12-31T13:30:30+05:00

参考文献:
https://docs.oracle.com/javase/10/docs/api/java/time/OffsetDateTime.html#with(java.time.temporal.TemporalAdjuster)
https://docs.oracle.com/javase/10/docs/api/java/time/OffsetDateTime.html#with(java.time.temporal.TemporalField, long)

Python教程

Java教程

Web教程

数据库教程

图形图像教程

大数据教程

开发工具教程

计算机教程

Java OffsetDateTime