@js-joda/core 5.1.0 → 5.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@js-joda/core",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "description": "a date and time library for javascript",
   "repository": {
     "type": "git",
@@ -48,5 +48,5 @@
     "sourceMap": false,
     "instrument": false
   },
-  "gitHead": "dda0bbb3894919782d859060bbabbaa3859775a8"
+  "gitHead": "d07153c38a3d0b2b29b8185e3daaac69c624d4a9"
 }

package/src/Instant.js

@@ -172,6 +172,20 @@ export class Instant extends Temporal {
         return Instant._create(secs, mos * 1000000);
     }
 
+    /**
+     * Obtains an instance of {@link Instant} using microseconds from the
+     * epoch of 1970-01-01T00:00:00Z.
+     *
+     * @param {number} epochMicro - the number of microseconds from 1970-01-01T00:00:00Z
+     * @return {Instant} an instant, not null
+     * @throws DateTimeException if the instant exceeds the maximum or minimum instant
+     */
+    static ofEpochMicro(epochMicro) {
+        const secs = MathUtil.floorDiv(epochMicro, 1000000);
+        const mos = MathUtil.floorMod(epochMicro, 1000000);
+        return Instant._create(secs, mos * 1000);
+    }
+
     /**
      * Obtains an instance of {@link Instant} from a temporal object.
      *
@@ -525,7 +539,7 @@ export class Instant extends Temporal {
         if (unit instanceof ChronoUnit) {
             switch (unit) {
                 case ChronoUnit.NANOS: return this.plusNanos(amountToAdd);
-                case ChronoUnit.MICROS: return this._plus(MathUtil.intDiv(amountToAdd, 1000000), MathUtil.intMod(amountToAdd, 1000000) * 1000);
+                case ChronoUnit.MICROS: return this.plusMicros(amountToAdd);
                 case ChronoUnit.MILLIS: return this.plusMillis(amountToAdd);
                 case ChronoUnit.SECONDS: return this.plusSeconds(amountToAdd);
                 case ChronoUnit.MINUTES: return this.plusSeconds(MathUtil.safeMultiply(amountToAdd, LocalTime.SECONDS_PER_MINUTE));
@@ -578,6 +592,19 @@ export class Instant extends Temporal {
         return this._plus(0, nanosToAdd);
     }
 
+    /**
+     * Returns a copy of this instant with the specified duration in microseconds added.
+     *
+     * This instance is immutable and unaffected by this method call.
+     *
+     * @param {number} microsToAdd - the microseconds to add, positive or negative
+     * @return {Instant} an {@link Instant} based on this instant with the specified microseconds added, not null
+     * @throws DateTimeException if the result exceeds the maximum or minimum instant
+     */
+    plusMicros(microsToAdd) {
+        return this._plus(MathUtil.intDiv(microsToAdd, 1000000), MathUtil.intMod(microsToAdd, 1000000) * 1000);
+    }
+
     /**
      * Returns a copy of this instant with the specified duration added.
      *
@@ -652,6 +679,20 @@ export class Instant extends Temporal {
         return this.plusNanos(-1 * nanosToSubtract);
     }
 
+    /**
+     * Returns a copy of this instant with the specified duration in microseconds subtracted.
+     *
+     * This instance is immutable and unaffected by this method call.
+     *
+     * @param {number} microsToSubtract  the microseconds to subtract, positive or negative
+     * @return {Instant} an {@link Instant} based on this instant with the specified microseconds subtracted, not null
+     * @throws DateTimeException if the result exceeds the maximum or minimum instant
+     * @throws ArithmeticException if numeric overflow occurs
+     */
+    minusMicros(microsToSubtract) {
+        return this.plusMicros(-1 * microsToSubtract);
+    }
+
     //-------------------------------------------------------------------------
     /**
      * Queries this instant using the specified query.

package/src/license-preamble.js

@@ -1,3 +0,0 @@
-//! @copyright (c) 2015-present, Philipp Thürwächter, Pattrick Hüper & js-joda contributors
-//! @copyright (c) 2007-present, Stephen Colebourne & Michael Nascimento Santos
-//! @license BSD-3-Clause (see LICENSE in the root directory of this source tree)