@rowsncolumns/utils 9.5.3 → 9.5.4

package/dist/cjs/date.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Excel's 1900 date system counts a day that never happened: serial 60 is
+ * 1900-02-29 (Lotus 1-2-3 compatibility). 1900-01-01 is 1, 1900-02-28 is 59,
+ * 1900-03-01 is 61. Google Sheets keeps the same numbering.
+ */
+export declare const EXCEL_LEAP_BUG_SERIAL = 60;
+/** The calendar day Excel's serial 60 stands for, which no `Date` can hold. */
+export declare const isExcelLeapDay: (year: number, month: number, day: number) => boolean;
 export type DateSerialMode = "local" | "excel-utc";
 /**
  * Convert date to serial with explicit time zone behavior.
@@ -6,6 +14,14 @@ export type DateSerialMode = "local" | "excel-utc";
  */
 export declare const toSerialWithMode: (date: Date, use1904?: boolean, mode?: DateSerialMode) => number;
 export declare const toSerial: (date: Date, use1904?: boolean) => number;
+/**
+ * Serial for calendar parts the way a user typed them. Unlike
+ * `toSerial(new Date(y, m, d))`, this never goes through a `Date`, so the
+ * phantom 1900-02-29 stays serial 60 instead of rolling over to March 1
+ * (rowsncolumns/spreadsheet#1026). Every other date takes the same path as
+ * `toSerial` in "local" mode. `month` is 0-based like `Date`.
+ */
+export declare const toSerialFromParts: (year: number, month: number, day: number, hour?: number, minute?: number, second?: number, use1904?: boolean) => number;
 /**
  * Convert serial to date
  * @param serial

package/dist/cjs/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../date.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,IAAI,EACV,iBAAe,EACf,OAAM,cAAwB,WAwB/B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,EAAE,iBAAe,WAEnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,iBAAe,SA+BrD,CAAC"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../date.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,+EAA+E;AAC/E,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,EAAE,KAAK,MAAM,YAC3B,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,IAAI,EACV,iBAAe,EACf,OAAM,cAAwB,WAwB/B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,EAAE,iBAAe,WAEnD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,KAAK,MAAM,EACX,aAAQ,EACR,eAAU,EACV,eAAU,EACV,iBAAe,WAWhB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,iBAAe,SA+BrD,CAAC"}

package/dist/cjs/date.js

@@ -1,8 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toDate = exports.toSerial = exports.toSerialWithMode = void 0;
+exports.toDate = exports.toSerialFromParts = exports.toSerial = exports.toSerialWithMode = exports.isExcelLeapDay = exports.EXCEL_LEAP_BUG_SERIAL = void 0;
 var DAY_TO_MS = 24 * 60 * 60 * 1000;
-var EXCEL_LEAP_BUG_SERIAL = 60;
+/**
+ * Excel's 1900 date system counts a day that never happened: serial 60 is
+ * 1900-02-29 (Lotus 1-2-3 compatibility). 1900-01-01 is 1, 1900-02-28 is 59,
+ * 1900-03-01 is 61. Google Sheets keeps the same numbering.
+ */
+exports.EXCEL_LEAP_BUG_SERIAL = 60;
+/** The calendar day Excel's serial 60 stands for, which no `Date` can hold. */
+var isExcelLeapDay = function (year, month, day) {
+    return year === 1900 && month === 1 && day === 29;
+};
+exports.isExcelLeapDay = isExcelLeapDay;
 /**
  * Convert date to serial with explicit time zone behavior.
  * - local: interpret date components in local time (UI entry behavior).
@@ -31,6 +41,25 @@ var toSerial = function (date, use1904) {
     return (0, exports.toSerialWithMode)(date, use1904, "local");
 };
 exports.toSerial = toSerial;
+/**
+ * Serial for calendar parts the way a user typed them. Unlike
+ * `toSerial(new Date(y, m, d))`, this never goes through a `Date`, so the
+ * phantom 1900-02-29 stays serial 60 instead of rolling over to March 1
+ * (rowsncolumns/spreadsheet#1026). Every other date takes the same path as
+ * `toSerial` in "local" mode. `month` is 0-based like `Date`.
+ */
+var toSerialFromParts = function (year, month, day, hour, minute, second, use1904) {
+    if (hour === void 0) { hour = 0; }
+    if (minute === void 0) { minute = 0; }
+    if (second === void 0) { second = 0; }
+    if (use1904 === void 0) { use1904 = false; }
+    var timeFraction = (hour * 3600 + minute * 60 + second) / (24 * 60 * 60);
+    if (!use1904 && (0, exports.isExcelLeapDay)(year, month, day)) {
+        return exports.EXCEL_LEAP_BUG_SERIAL + timeFraction;
+    }
+    return (0, exports.toSerialWithMode)(new Date(year, month, day, hour, minute, second, 0), use1904, "local");
+};
+exports.toSerialFromParts = toSerialFromParts;
 /**
  * Convert serial to date
  * @param serial
@@ -44,11 +73,11 @@ var toDate = function (serial, use1904) {
         var utcDate_1 = new Date(utcMillis_1);
         return new Date(utcDate_1.getUTCFullYear(), utcDate_1.getUTCMonth(), utcDate_1.getUTCDate(), utcDate_1.getUTCHours(), utcDate_1.getUTCMinutes(), utcDate_1.getUTCSeconds(), utcDate_1.getUTCMilliseconds());
     }
-    if (serial === EXCEL_LEAP_BUG_SERIAL) {
+    if (serial === exports.EXCEL_LEAP_BUG_SERIAL) {
         return new Date(1900, 1, 28);
     }
     var baseUtc = Date.UTC(1899, 11, 31);
-    var dayCount = serial < EXCEL_LEAP_BUG_SERIAL ? serial : serial - 1;
+    var dayCount = serial < exports.EXCEL_LEAP_BUG_SERIAL ? serial : serial - 1;
     var utcMillis = baseUtc + dayCount * DAY_TO_MS;
     var utcDate = new Date(utcMillis);
     return new Date(utcDate.getUTCFullYear(), utcDate.getUTCMonth(), utcDate.getUTCDate(), utcDate.getUTCHours(), utcDate.getUTCMinutes(), utcDate.getUTCSeconds(), utcDate.getUTCMilliseconds());

package/dist/esm/date.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Excel's 1900 date system counts a day that never happened: serial 60 is
+ * 1900-02-29 (Lotus 1-2-3 compatibility). 1900-01-01 is 1, 1900-02-28 is 59,
+ * 1900-03-01 is 61. Google Sheets keeps the same numbering.
+ */
+export declare const EXCEL_LEAP_BUG_SERIAL = 60;
+/** The calendar day Excel's serial 60 stands for, which no `Date` can hold. */
+export declare const isExcelLeapDay: (year: number, month: number, day: number) => boolean;
 export type DateSerialMode = "local" | "excel-utc";
 /**
  * Convert date to serial with explicit time zone behavior.
@@ -6,6 +14,14 @@ export type DateSerialMode = "local" | "excel-utc";
  */
 export declare const toSerialWithMode: (date: Date, use1904?: boolean, mode?: DateSerialMode) => number;
 export declare const toSerial: (date: Date, use1904?: boolean) => number;
+/**
+ * Serial for calendar parts the way a user typed them. Unlike
+ * `toSerial(new Date(y, m, d))`, this never goes through a `Date`, so the
+ * phantom 1900-02-29 stays serial 60 instead of rolling over to March 1
+ * (rowsncolumns/spreadsheet#1026). Every other date takes the same path as
+ * `toSerial` in "local" mode. `month` is 0-based like `Date`.
+ */
+export declare const toSerialFromParts: (year: number, month: number, day: number, hour?: number, minute?: number, second?: number, use1904?: boolean) => number;
 /**
  * Convert serial to date
  * @param serial

package/dist/esm/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../date.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,IAAI,EACV,iBAAe,EACf,OAAM,cAAwB,WAwB/B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,EAAE,iBAAe,WAEnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,iBAAe,SA+BrD,CAAC"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../date.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,+EAA+E;AAC/E,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,EAAE,KAAK,MAAM,YAC3B,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,IAAI,EACV,iBAAe,EACf,OAAM,cAAwB,WAwB/B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,EAAE,iBAAe,WAEnD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,KAAK,MAAM,EACX,aAAQ,EACR,eAAU,EACV,eAAU,EACV,iBAAe,WAWhB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,iBAAe,SA+BrD,CAAC"}

package/dist/esm/date.js

@@ -1,5 +1,12 @@
 const DAY_TO_MS = 24 * 60 * 60 * 1000;
-const EXCEL_LEAP_BUG_SERIAL = 60;
+/**
+ * Excel's 1900 date system counts a day that never happened: serial 60 is
+ * 1900-02-29 (Lotus 1-2-3 compatibility). 1900-01-01 is 1, 1900-02-28 is 59,
+ * 1900-03-01 is 61. Google Sheets keeps the same numbering.
+ */
+export const EXCEL_LEAP_BUG_SERIAL = 60;
+/** The calendar day Excel's serial 60 stands for, which no `Date` can hold. */
+export const isExcelLeapDay = (year, month, day) => year === 1900 && month === 1 && day === 29;
 /**
  * Convert date to serial with explicit time zone behavior.
  * - local: interpret date components in local time (UI entry behavior).
@@ -23,6 +30,20 @@ export const toSerialWithMode = (date, use1904 = false, mode = "local") => {
 export const toSerial = (date, use1904 = false) => {
     return toSerialWithMode(date, use1904, "local");
 };
+/**
+ * Serial for calendar parts the way a user typed them. Unlike
+ * `toSerial(new Date(y, m, d))`, this never goes through a `Date`, so the
+ * phantom 1900-02-29 stays serial 60 instead of rolling over to March 1
+ * (rowsncolumns/spreadsheet#1026). Every other date takes the same path as
+ * `toSerial` in "local" mode. `month` is 0-based like `Date`.
+ */
+export const toSerialFromParts = (year, month, day, hour = 0, minute = 0, second = 0, use1904 = false) => {
+    const timeFraction = (hour * 3600 + minute * 60 + second) / (24 * 60 * 60);
+    if (!use1904 && isExcelLeapDay(year, month, day)) {
+        return EXCEL_LEAP_BUG_SERIAL + timeFraction;
+    }
+    return toSerialWithMode(new Date(year, month, day, hour, minute, second, 0), use1904, "local");
+};
 /**
  * Convert serial to date
  * @param serial

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/utils",
-  "version": "9.5.3",
+  "version": "9.5.4",
   "author": "Vinay M",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "./dist/cjs/index.js",