Merge branch 'moment:master' into master

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+# 3.5.0 (2024-08-03)
+
+- Various performance improvements
+- throwOnInvalid causes the constructor to throw if the year is invalid
+
 # 3.4.4 (2023-11-12)
 
 - Localized week support (#1454)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "luxon",
-  "version": "3.4.4",
+  "version": "3.5.0",
   "description": "Immutable date wrapper",
   "author": "Isaac Cambron",
   "keywords": [

src/datetime.js

@@ -1823,7 +1823,7 @@ export default class DateTime {
    * @example DateTime.now().toISO() //=> '2017-04-22T20:47:05.335-04:00'
    * @example DateTime.now().toISO({ includeOffset: false }) //=> '2017-04-22T20:47:05.335'
    * @example DateTime.now().toISO({ format: 'basic' }) //=> '20170422T204705.335-0400'
-   * @return {string}
+   * @return {string|null}
    */
   toISO({
     format = "extended",
@@ -1850,7 +1850,7 @@ export default class DateTime {
    * @param {string} [opts.format='extended'] - choose between the basic and extended format
    * @example DateTime.utc(1982, 5, 25).toISODate() //=> '1982-05-25'
    * @example DateTime.utc(1982, 5, 25).toISODate({ format: 'basic' }) //=> '19820525'
-   * @return {string}
+   * @return {string|null}
    */
   toISODate({ format = "extended" } = {}) {
     if (!this.isValid) {
@@ -1935,7 +1935,7 @@ export default class DateTime {
   /**
    * Returns a string representation of this DateTime appropriate for use in SQL Date
    * @example DateTime.utc(2014, 7, 13).toSQLDate() //=> '2014-07-13'
-   * @return {string}
+   * @return {string|null}
    */
   toSQLDate() {
     if (!this.isValid) {
@@ -2137,7 +2137,7 @@ export default class DateTime {
   /**
    * Return an Interval spanning between this DateTime and another DateTime
    * @param {DateTime} otherDateTime - the other end point of the Interval
-   * @return {Interval}
+   * @return {Interval|DateTime}
    */
   until(otherDateTime) {
     return this.isValid ? Interval.fromDateTimes(this, otherDateTime) : this;

src/interval.js

@@ -196,6 +196,14 @@ export default class Interval {
     return this.isValid ? this.e : null;
   }
 
+  /**
+   * Returns the last DateTime included in the interval (since end is not part of the interval)
+   * @type {DateTime}
+   */
+  get lastDateTime() {
+    return this.isValid ? (this.e ? this.e.minus(1) : null) : null;
+  }
+
   /**
    * Returns whether this Interval's end is at least its start, meaning that the Interval isn't 'backwards'.
    * @type {boolean}

src/luxon.js

@@ -9,7 +9,7 @@ import InvalidZone from "./zones/invalidZone.js";
 import SystemZone from "./zones/systemZone.js";
 import Settings from "./settings.js";
 
-const VERSION = "3.4.4";
+const VERSION = "3.5.0";
 
 export {
   VERSION,

src/package.json

@@ -1,4 +1,4 @@
 {
   "type": "module",
-  "version": "3.4.4"
+  "version": "3.5.0"
 }