@js-joda/core 5.1.0 → 5.3.1

package/package.json

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

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/YearMonth.js

@@ -881,6 +881,7 @@ export class YearMonth extends Temporal {
      * @see #isValidDay(int)
      */
     atDay(dayOfMonth) {
+        requireNonNull(dayOfMonth, 'dayOfMonth');
         return LocalDate.of(this._year, this._month, dayOfMonth);
     }
 

package/src/ZoneRegion.js

@@ -29,7 +29,6 @@ import { ZoneRulesProvider } from './zone/ZoneRulesProvider';
  */
 export class ZoneRegion extends ZoneId {
     /**
-     * not yet implemented
      * @param {string} zoneId
      * @return {ZoneId}
      */

package/typings/js-joda.d.ts

@@ -1152,6 +1152,7 @@ export class Instant extends Temporal implements TemporalAdjuster {
 
     static from(temporal: TemporalAccessor): Instant;
     static now(clock?: Clock): Instant;
+    static ofEpochMicro(epochMicro: number): Instant;
     static ofEpochMilli(epochMilli: number): Instant;
     static ofEpochSecond(epochSecond: number, nanoAdjustment?: number): Instant;
     static parse(text: string): Instant;
@@ -1171,12 +1172,14 @@ export class Instant extends Temporal implements TemporalAdjuster {
     isSupported(fieldOrUnit: TemporalField | TemporalUnit): boolean;
     minus(amountToSubtract: number, unit: TemporalUnit): Instant;
     minus(amount: TemporalAmount): Instant;
+    minusMicros(microsToSubtract: number): Instant;
     minusMillis(millisToSubtract: number): Instant;
     minusNanos(nanosToSubtract: number): Instant;
     minusSeconds(secondsToSubtract: number): Instant;
     nano(): number;
     plus(amountToAdd: number, unit: TemporalUnit): Instant;
     plus(amount: TemporalAmount): Instant;
+    plusMicros(microsToAdd: number): Instant;
     plusMillis(millisToAdd: number): Instant;
     plusNanos(nanosToAdd: number): Instant;
     plusSeconds(secondsToAdd: number): Instant;

package/typings/js-joda.flow.js

@@ -122,6 +122,7 @@ declare module "js-joda" {
         MAX_SECONDS: Instant;
         from(temporal: TemporalAccessor): Instant;
         now(clock?: Clock): Instant;
+        ofEpochMicro(epochMicro: number): Instant;
         ofEpochMilli(epochMilli: number): Instant;
         ofEpochSecond(epochSecond: number, nanoAdjustment?: number): Instant;
         parse(text: string): Instant;
@@ -137,12 +138,14 @@ declare module "js-joda" {
         isSupported(fieldOrUnit: TemporalField | TemporalUnit): boolean;
         minus(amount: TemporalAmount): Instant;
         minus(amountToSubtract: number, unit: TemporalUnit): Instant;
+        minusMicros(microsToSubtract: number): Instant;
         minusMillis(millisToSubtract: number): Instant;
         minusNanos(nanosToSubtract: number): Instant;
         minusSeconds(secondsToSubtract: number): Instant;
         nano(): number;
         plus(amount: TemporalAmount): Instant;
         plus(amountToAdd: number, unit: TemporalUnit): Instant;
+        plusMicros(microsToAdd: number): Instant;
         plusMillis(millisToAdd: number): Instant;
         plusNanos(nanosToAdd: number): Instant;
         plusSeconds(secondsToAdd: number): Instant;

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)