Java中的 OffsetDateTime until() 方法及示例

OffsetDateTime类的until()方法，用于使用 TemporalUnit 计算两个 OffsetDateTime 对象之间的时间量。起点和终点是 this 和作为参数传递的指定 OffsetDateTime。如果结束在开始之前，结果将为负数。计算返回一个整数，表示两个 OffsetDateTime 之间的完整单位数。此实例是不可变的，不受此方法调用的影响。

句法：

public long until(Temporal endExclusive, TemporalUnit unit)

参数：此方法接受两个参数 endExclusive 是结束日期，exclusive 是转换为 OffsetDateTime 和 unit 是衡量金额的单位。

返回值：此方法返回此 OffsetDateTime 和结束 OffsetDateTime 之间的时间量。

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

• DateTimeException – 如果无法计算金额，或者无法将结束时间转换为 OffsetDateTime。
• UnsupportedTemporalTypeException – 如果不支持该单位。
• ArithmeticException – 如果发生数字溢出。

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

// Java program to demonstrate
// OffsetDateTime.until() method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
        // create OffsetDateTime objects
        OffsetDateTime date1 = OffsetDateTime.parse("2018-12-12T13:30:30+05:00");
        OffsetDateTime date2 = OffsetDateTime.parse("2015-12-12T13:30:30+05:00");
  
        // apply until method of OffsetDateTime class
        long result
            = date2.until(date1,
                          ChronoUnit.MONTHS);
  
        // print results
        System.out.println("Result in MONTHS: "
                           + result);
    }
}

输出：

Result in MONTHS: 36

方案二：

// Java program to demonstrate
// OffsetDateTime.until() method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
        // create OffsetDateTime objects
        OffsetDateTime date1 = OffsetDateTime.parse("2018-12-12T13:30:30+05:00");
        OffsetDateTime date2 = OffsetDateTime.parse("2015-12-12T13:30:30+05:00");
  
        // apply until method of OffsetDateTime class
        long result
            = date1.until(date2,
                          ChronoUnit.YEARS);
  
        // print results
        System.out.println("Result in YEARS: "
                           + result);
    }
}

输出：

Result in YEARS: -3

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