@mll-lab/js-utils 2.38.0 → 2.40.0

package/dist/index.js

@@ -9594,6 +9594,18 @@ function makeBooleanCompareFn(map) {
         return Number(mappedA) - Number(mappedB);
     };
 }
+/**
+ * Takes a function that maps the values to sort to Dates and returns a compare function
+ * using their timestamps, usable in `Array.toSorted` or similar APIs.
+ *
+ * null and undefined are coalesced to the oldest possible date and thus not distinguished and first in sort order.
+ */
+function makeDateCompareFn(map, 
+// See https://stackoverflow.com/a/11526569 for an explanation of this value.
+fallbackValue = new Date(-8640000000000000)) {
+    const fallbackTime = fallbackValue.getTime();
+    return makeNumberCompareFn((sortable) => { var _a, _b; return (_b = (_a = map(sortable)) === null || _a === void 0 ? void 0 : _a.getTime()) !== null && _b !== void 0 ? _b : fallbackTime; });
+}
 /**
  * Returns a compare function for values that are string, null or undefined,
  * using `String.prototype.localeCompare`, usable in `Array.toSorted` or similar APIs.
@@ -16342,6 +16354,7 @@ exports.joinNonEmpty = joinNonEmpty;
 exports.last = last;
 exports.localeCompareStrings = localeCompareStrings;
 exports.makeBooleanCompareFn = makeBooleanCompareFn;
+exports.makeDateCompareFn = makeDateCompareFn;
 exports.makeNumberCompareFn = makeNumberCompareFn;
 exports.makeStringCompareFn = makeStringCompareFn;
 exports.mapSequentially = mapSequentially;