@js-joda/core 4.3.0 → 5.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@js-joda/core",
-  "version": "4.3.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": "cdc181e107e04638303605e304e78eaba5864ea0"
+  "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/format/DateTimeFormatterBuilder.js

@@ -1424,7 +1424,7 @@ class InstantPrinterParser  {
             if (hi > 0) {
                 buf.append('+').append(hi);
             }
-            buf.append(ldt);
+            buf.append(ldt.toString());
             if (ldt.second() === 0) {
                 buf.append(':00');
             }
@@ -1435,7 +1435,7 @@ class InstantPrinterParser  {
             const lo = MathUtil.intMod(zeroSecs, SECONDS_PER_10000_YEARS);
             const ldt = LocalDateTime.ofEpochSecond(lo - SECONDS_0000_TO_1970, 0, ZoneOffset.UTC);
             const pos = buf.length();
-            buf.append(ldt);
+            buf.append(ldt.toString());
             if (ldt.second() === 0) {
                 buf.append(':00');
             }

package/src/temporal/Temporal.js

@@ -351,3 +351,19 @@ export class Temporal extends TemporalAccessor {
         abstractMethodFail('_withField');
     }
 }
+
+if (typeof Symbol !== 'undefined' && Symbol.toPrimitive) {
+    Temporal.prototype[Symbol.toPrimitive] = function (hint) {
+        // hint could be 'number', 'string' or 'default'. Only 'number'
+        // should throw and 'default' is treated as 'string'.
+        if (hint !== 'number') {
+            return this.toString();
+        }
+
+        throw new TypeError(
+            'A conversion from Temporal to a number is not allowed. ' +
+            'To compare use the methods .equals(), .compareTo(), .isBefore() ' +
+            'or one that is more suitable to your use case.'
+        );
+    };
+}

package/src/temporal/TemporalAmount.js

@@ -164,3 +164,19 @@ export class TemporalAmount {
     }
     
 }
+
+if (typeof Symbol !== 'undefined' && Symbol.toPrimitive) {
+    TemporalAmount.prototype[Symbol.toPrimitive] = function (hint) {
+        // hint could be 'number', 'string' or 'default'. Only 'number'
+        // should throw and 'default' is treated as 'string'.
+        if (hint !== 'number') {
+            return this.toString();
+        }
+
+        throw new TypeError(
+            'A conversion from TemporalAmount to a number is not allowed. ' +
+            'To compare use the methods .equals(), .compareTo(), .isBefore() ' +
+            'or one that is more suitable to your use case.'
+        );
+    };
+}

package/typings/js-joda.d.ts

@@ -1770,7 +1770,6 @@ export class OffsetTime extends Temporal implements TemporalAdjuster {
     plusNanos(nanos: number): OffsetTime;
     plusSeconds(seconds: number): OffsetTime;
     second(): number;
-    toEpochSecond(date: LocalDate): number;
     toJSON(): string;
     toLocalTime(): LocalTime;
     toString(): string;

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)