Java Instant minus() 方法

2025 年 1 月 7 日 | 阅读 3 分钟

Java Instant 类的 minus() 方法用于返回此 Instant 的副本,并减去指定的量。

Instant minus() 方法包含 2 种参数类型

  • Java Instant minus(TemporalAmount amountToSubtract) 方法
  • Java Instant minus(long amountToSubtract, TemporalUnit unit)

minus(TemporalAmount amountToSubtract) 方法返回一个 Instant,基于此 Instant,减去指定的量。该量通常是 Duration,但也可以是实现 TemporalAmount 接口的任何其他类型。

minus(long amountToSubtract, TemporalUnit unit) 方法返回一个 Instant,基于此 Instant,减去指定单位的量。如果无法减去该量(例如,因为不支持该单位或出于其他原因),则会抛出异常。

语法

参数

amountToSubtract - 要减去的值,不能为空

amountToSubtract - 要从结果中减去的单位量,可以是负数。

unit - 要减去的单位,不能为空。

返回

基于此 Instant 并已执行减法的 Instant,不能为空

基于此 Instant 并已减去指定量的 Instant,不能为空。

异常

DateTimeException - 如果无法进行减法

ArithmeticException - 如果发生数值溢出

DateTimeException - 如果无法进行减法

UnsupportedTemporalTypeException - 如果不支持该单位

ArithmeticException - 如果发生数值溢出

示例 1

输出

输出将如下所示。

2017-02-03T10:27:30Z

示例 2

输出

输出将如下所示。

2014-08-25T10:15:30Z

示例 3

输出

输出将如下所示。

2014-12-03T10:15:30Z

示例 4

输出

输出将如下所示。

2014-12-03T10:15:33Z

示例 5

输出

输出将如下所示。

2017-05-01T20:57:43.045Z

   Nanos > 2017-05-01T20:57:43.044999990Z

  Micros > 2017-05-01T20:57:43.044990Z

  Millis > 2017-05-01T20:57:43.035Z

 Seconds > 2017-05-01T20:57:33.045Z

 Minutes > 2017-05-01T20:47:43.045Z

   Hours > 2017-05-01T10:57:43.045Z

HalfDays > 2017-04-26T20:57:43.045Z

    Days > 2017-04-21T20:57:43.045Z

      -- Weeks not supported

      -- Months not supported

      -- Years not supported

      -- Decades not supported

      -- Centuries not supported

      -- Millennia not supported

      -- Eras not supported

      -- Forever not supported

Java Instant minus(long amountToSubtract, TemporalUnit unit) 方法示例

示例 6

输出

输出将如下所示。

2014-08-25T10:15:30Z

示例 7

输出

输出将如下所示。

2017-02-03T05:37:30Z