@vbarbarosh/node-helpers 3.54.1 → 3.55.0

package/package.json

@@ -2,7 +2,7 @@
     "author": "Vladimir Barbarosh <vladimir.barbarosh@gmail.com>",
     "license": "MIT",
     "name": "@vbarbarosh/node-helpers",
-    "version": "3.54.1",
+    "version": "3.55.0",
     "description": "A set of helpers for JavaScript/Node.js",
     "files": [
         "src"

package/src/date_add_months.js

@@ -0,0 +1,24 @@
+/**
+ * @link https://stackoverflow.com/a/7937257
+ */
+function date_add_months(d, months)
+{
+    if (!months) {
+        return d;
+    }
+
+    // https://github.com/briannesbitt/Carbon/blob/f01cfa96468f4c38325f507ab81a4f1d2cd93cfe/src/Carbon/Traits/Units.php#L360C1-L361C1
+    // > } elseif (isset($canOverflow, $day) && $canOverflow && $day !== $date?->day) {
+    // >     $date = $date?->modify('last day of previous month');
+    // > }
+
+    const date0 = d.getDate();
+    d.setMonth(d.getMonth() + months);
+    if (d.getDate() !== date0) {
+        d.setDate(0);
+    }
+
+    return d;
+}
+
+module.exports = date_add_months;

package/src/date_add_months.test.js

@@ -0,0 +1,40 @@
+const assert = require('assert');
+const date_add_months = require('./date_add_months');
+const format_date_ymd = require('./format_date_ymd');
+
+const items = [
+    ['2024/12/24', '2024/12/24', 0],
+    ['2024/12/24', '2025/01/24', 1],
+    ['2024/12/24', '2024/11/24', -1],
+    ['2012/01/14', '2011/10/14', -3],
+    ['2019/03/31', '2019/02/28', -1],
+    ['2023/01/15', '2023/04/15', 3, 'Basic Positive Addition'],
+    ['2023/05/15', '2023/03/15', -2, 'Basic Negative Addition'],
+    ['2023/10/15', '2024/03/15', 5, 'Year Crossover (Positive)'],
+    ['2023/03/15', '2022/10/15', -5, 'Year Crossover (Negative)'],
+    ['2024/02/29', '2025/02/28', 12, 'Leap Year - Adding Months in Leap Year'],
+    ['2024/03/01', '2023/03/01', -12, 'Negative Leap Year Crossover'],
+    ['2023/01/31', '2023/02/28', 1, 'End of Month (31st to Shorter Month)'],
+    ['2023/03/31', '2023/02/28', -1, 'End of Month Crossover (Negative)'],
+    ['2023/06/15', '2023/06/15', 0, 'Zero Months Added'],
+    ['2023/01/01', '2033/01/01', 120, 'Large Positive Addition'],
+    ['2023/01/01', '2013/01/01', -120, 'Large Negative Addition'],
+    ['2020/02/29', '2024/02/29', 48, 'Multiple Leap Years'],
+    ['2023/12/15', '2024/01/15', 1, 'Adding to December'],
+    ['2023/01/15', '2022/12/15', -1, 'Subtracting from January'],
+    ['2023/05/31', '2023/06/30', 1, 'Day Preservation with Shorter Month'],
+    ['2023/02/28', '2024/02/28', 12, 'Adding Months to February (Non-Leap Year)'],
+    ['2024/03/01', '2023/02/01', -13, 'Negative Months Across Leap Year'],
+    ['2000/01/01', '2030/01/01', 360, 'Multiple Decades'],
+    ['1970/01/01', '2020/01/01', 600, 'Edge Case: Epoch Date'],
+    ['3000/01/01', '2900/01/01', -1200, 'Far Future Date']
+];
+
+describe('date_add_months', function () {
+    items.forEach(function ([input, expected, months, message]) {
+        it(`${input} → ${expected}`, function () {
+            const d = date_add_months(new Date(input), months);
+            assert.strictEqual(format_date_ymd(d), expected, message);
+        });
+    });
+});

package/src/date_is_leap_year.js

@@ -0,0 +1,15 @@
+/**
+ * @link https://github.com/moment/moment/blob/18aba135ab927ffe7f868ee09276979bed6993a6/src/lib/utils/is-leap-year.js
+ * @link https://en.wikipedia.org/wiki/Leap_year
+ * > Each leap year has 366 days instead of 365. This extra leap day
+ * > occurs in each year that is a multiple of 4, except for years
+ * > evenly divisible by 100 but not by 400.
+ */
+function date_is_leap_year(d)
+{
+    const year = d.getFullYear();
+    // return (year % 4 === 0) && !(year % 100 === 0 && year % 400 !== 0);
+    return (year % 4 === 0 && year % 100 !== 0) || (year % 400 === 0);
+}
+
+module.exports = date_is_leap_year;

package/src/date_is_leap_year.test.js

@@ -0,0 +1,14 @@
+const assert = require('assert');
+const date_is_leap_year = require('./date_is_leap_year');
+
+describe('date_add_months', function () {
+    it('Brute force', function () {
+        for (let year = 100; year < 9999; ++year) {
+            const d = new Date(`${year}/01/01 00:00:00`);
+            const d2 = new Date(`${year}/02/29 00:00:00`);
+            assert.strictEqual(d.getFullYear(), year);
+            assert.strictEqual(d2.getFullYear(), year);
+            assert.strictEqual(date_is_leap_year(d), d2.getMonth() === 1, year);
+        }
+    });
+});

package/src/format_date_ymd.js

@@ -0,0 +1,6 @@
+function format_date_ymd(d)
+{
+    return d.getFullYear() + `/0${d.getMonth()+1}/0${d.getDate()}`.replace(/0(\d\d)/g, '$1');
+}
+
+module.exports = format_date_ymd;