@checkdigit/time 4.0.0 → 5.0.0-PR.21-7813

package/dist-types/holidays/united-states/federal-reserve-bank/index.d.ts

@@ -1,4 +1,4 @@
-export { default as addUSFederalReserveBankBusinessDays } from './add-us-federal-reserve-bank-business-days';
-export { default as getAllUSFederalReserveBankHolidays } from './get-all-us-federal-reserve-bank-holidays';
-export { default as isUSFederalReserveBankClosed } from './is-us-federal-reserve-bank-closed';
-export { type PlainDate } from './plain-date';
+export { default as addUSFederalReserveBankBusinessDays } from './add-us-federal-reserve-bank-business-days.ts';
+export { default as getAllUSFederalReserveBankHolidays } from './get-all-us-federal-reserve-bank-holidays.ts';
+export { default as isUSFederalReserveBankClosed } from './is-us-federal-reserve-bank-closed.ts';
+export { type PlainDate } from './plain-date.ts';

package/dist-types/holidays/united-states/federal-reserve-bank/is-us-federal-reserve-bank-closed.d.ts

@@ -1,4 +1,4 @@
-import { type PlainDate } from './index';
+import { type PlainDate } from './index.ts';
 /**
  * @name isUSFederalReserveBankClosed
  * @summary Is the US Federal Reserve Bank Closed?

package/dist-types/index.d.ts

@@ -1,5 +1,4 @@
-export * as Temporal from './temporal';
-export * from './date-fns';
-export * from './date-fns-tz';
-export { default as formatUtc } from './format-utc';
-export * from './holidays';
+export * from './date-fns/index.ts';
+export * from './date-fns-tz/index.ts';
+export { default as formatUtc } from './format-utc.ts';
+export * from './holidays/index.ts';

package/package.json

@@ -1,75 +1 @@
-{
-  "name": "@checkdigit/time",
-  "version": "4.0.0",
-  "description": "Standard time handling",
-  "author": "Check Digit, LLC",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/checkdigit/time/issues"
-  },
-  "homepage": "https://github.com/checkdigit/time#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/checkdigit/time.git"
-  },
-  "engines": {
-    "node": ">=20.11"
-  },
-  "type": "module",
-  "sideEffects": false,
-  "exports": {
-    ".": {
-      "types": "./dist-types/index.d.ts",
-      "import": "./dist-mjs/index.mjs",
-      "default": "./dist-mjs/index.mjs"
-    }
-  },
-  "files": [
-    "src",
-    "dist-types",
-    "dist-mjs",
-    "!src/**/*.test.ts",
-    "!src/**/*.spec.ts",
-    "!dist-types/**/*.test.d.ts",
-    "!dist-types/**/*.spec.d.ts",
-    "!dist-mjs/**/*.test.mjs",
-    "!dist-mjs/**/*.spec.mjs",
-    "SECURITY.md"
-  ],
-  "devDependencies": {
-    "@checkdigit/eslint-config": "^9.2.0",
-    "@checkdigit/jest-config": "^6.0.0",
-    "@checkdigit/prettier-config": "^5.3.0",
-    "@checkdigit/typescript-config": "^7.0.1",
-    "@js-temporal/polyfill": "^0.4.4",
-    "rimraf": "^5.0.5"
-  },
-  "scripts": {
-    "prepublishOnly": "npm run build:dist-types && npm run build:dist-mjs",
-    "build:dist-types": "rimraf dist-types && npx builder --type=types --outDir=dist-types",
-    "build:dist-mjs": "rimraf dist-mjs && npx builder --type=module --sourceMap --outDir=dist-mjs && node dist-mjs/index.mjs",
-    "lint": "eslint --max-warnings 0 --ignore-path .gitignore .",
-    "lint:fix": "eslint --ignore-path .gitignore . --fix",
-    "prettier": "prettier --ignore-path .gitignore --list-different .",
-    "prettier:fix": "prettier --ignore-path .gitignore --write .",
-    "test": "npm run ci:compile && npm run ci:test && npm run ci:lint && npm run ci:style",
-    "ci:compile": "tsc --noEmit",
-    "ci:test": "NODE_OPTIONS=\"--disable-warning ExperimentalWarning --experimental-vm-modules\" jest --coverage=false",
-    "ci:coverage": "NODE_OPTIONS=\"--disable-warning ExperimentalWarning --experimental-vm-modules\" jest --coverage=true",
-    "ci:lint": "npm run lint",
-    "ci:style": "npm run prettier"
-  },
-  "jest": {
-    "preset": "@checkdigit/jest-config"
-  },
-  "eslintConfig": {
-    "extends": [
-      "@checkdigit/eslint-config"
-    ],
-    "ignorePatterns": [
-      "src/date-fns/**",
-      "src/date-fns-tz/**"
-    ]
-  },
-  "prettier": "@checkdigit/prettier-config"
-}
+{"name":"@checkdigit/time","version":"5.0.0-PR.21-7813","description":"Standard time handling","homepage":"https://github.com/checkdigit/time#readme","bugs":{"url":"https://github.com/checkdigit/time/issues"},"repository":{"type":"git","url":"git+https://github.com/checkdigit/time.git"},"license":"MIT","author":"Check Digit, LLC","sideEffects":false,"type":"module","exports":{".":{"types":"./dist-types/index.d.ts","import":"./dist-mjs/index.mjs","default":"./dist-mjs/index.mjs"}},"files":["src","dist-types","dist-mjs","!src/**/*.test.ts","!src/**/*.spec.ts","!dist-types/**/*.test.d.ts","!dist-types/**/*.spec.d.ts","!dist-mjs/**/*.test.mjs","!dist-mjs/**/*.spec.mjs","SECURITY.md"],"scripts":{"build:dist-mjs":"rimraf dist-mjs && npx builder --type=module --sourceMap --outDir=dist-mjs && node dist-mjs/index.mjs","build:dist-types":"rimraf dist-types && npx builder --type=types --outDir=dist-types","ci:compile":"tsc --noEmit","ci:coverage":"rimraf coverage && mkdir coverage && node --experimental-strip-types --test-timeout 600000 --experimental-test-coverage --test-reporter=lcov --test-reporter-destination=coverage/lcov.info --test \"src/**/*.spec.ts\"","ci:lint":"npm run lint","ci:style":"npm run prettier","ci:test":"node --disable-warning ExperimentalWarning --experimental-strip-types --test-timeout 600000 --test \"src/**/*.spec.ts\"","lint":"eslint --max-warnings 0 .","lint:fix":"eslint . --fix","prepublishOnly":"npm run build:dist-types && npm run build:dist-mjs","prettier":"prettier --ignore-path .gitignore --list-different .","prettier:fix":"prettier --ignore-path .gitignore --write .","test":"npm run ci:compile && npm run ci:test && npm run ci:lint && npm run ci:style"},"prettier":"@checkdigit/prettier-config","devDependencies":{"@checkdigit/eslint-config":"^11.1.0","@checkdigit/prettier-config":"^6.2.0","@checkdigit/typescript-config":"^9.0.0","rimraf":"^6.0.1"},"engines":{"node":">=22.11"}}

package/src/date-fns/CHANGELOG.md

@@ -8,6 +8,70 @@ This change log follows the format documented in [Keep a CHANGELOG].
 [semantic versioning]: http://semver.org/
 [keep a changelog]: http://keepachangelog.com/
 
+## v4.1.0 - 2024-09-17
+
+This release adds time zone support to format functions (that I somehow missed when working on the feature) and fixes a few bugs.
+
+Make sure also upgrade `TZDate` to v1.0.2 as it [includes a bunch of critical bug fixes](https://github.com/date-fns/tz/blob/main/CHANGELOG.md#v102---2024-09-14).
+
+### Fixed
+
+- Fixed internal `constructFrom` throwing an exception on `null` arguments. While `null` isn't allowed, the functions should rather return `Invalid Date` or `NaN` in such cases. See [#3885](https://github.com/date-fns/date-fns/issues/3885).
+
+### Added
+
+- Added missing time zone support to `format`, `formatISO`, `formatISO9075`, `formatRelative` and `formatRFC3339`. See [#3886](https://github.com/date-fns/date-fns/issues/3886).
+
+## v4.0.0 - 2024-09-16
+
+I have great news! First, ten years after its release, date-fns finally gets first-class time zone support.
+
+Another great news is that there aren't many breaking changes in this release. All of them are type-related and will affect only those explicitly using internal date-fns types. Finally, it has been less than a year since the last major release, which is an improvement over the previous four years between v2 and v3. I plan on keeping the pace and minimizing breaking changes moving forward.
+
+[Read more about the release in the announcement blog post](https://blog.date-fns.org/v40-with-time-zone-support/).
+
+\- [Sasha @kossnocorp](https://twitter.com/kossnocorp)
+
+### Added
+
+- Added time zones support via [`@date-fns/tz`](https://github.com/date-fns/tz)'s `TZDate` class and `tz` helper function. See its [README](https://github.com/date-fns/tz) for the details about the API.
+
+- All relevant functions now accept the context `in` option, which allows to specify the time zone to make the calculations in. If the function also returns a date, it will be in the specified time zone:
+
+  ```ts
+  import { addDays, startOfDay } from 'date-fns';
+  import { tz } from '@date-fns/tz';
+
+  startOfDay(addDays(Date.now(), 5, { in: tz('Asia/Singapore') }));
+  //=> "2024-09-16T00:00:00.000+08:00"
+  ```
+
+  In the example, `addDays` will get the current date and time in Singapore and add 5 days to it. `startOfDay` will inherit the date type and return the start of the day in Singapore.
+
+### Changed
+
+- The function arguments, as well as `Interval`'s `start` and `end`, now can be of different types, allowing you to mix `UTCDate`, `TZDate`, `Date`, and other extensions, as well as primitives (strings and numbers).
+
+  The functions will normalize these values, make calculations, and return the result in the same type, preventing any bugs caused by the discrepancy. If passed, the type will be inferred from the context `in` option or the first encountered argument object type. The `Interval`'s `start` and `end` will be considered separately, starting from `start`.
+
+  In the given example, the result will be in the `TZDate` as the first argument is a number, and the `start` takes precedence over the `end`.
+
+  ```ts
+  clamp(Date.now(), {
+    start: new TZDate(start, 'Asia/Singapore'),
+    end: new UTCDate(),
+  });
+  //=> TZDate
+  ```
+
+- **BREAKING**: This release contains a bunch of types changes that should not affect the library's expected usage. The changes are primarily internal and nuanced, so rather than listing them here, I recommend you running the type checker after the upgrade. If there are unfixable problems, please [open an issue](https://github.com/date-fns/date-fns/issues/new).
+
+- **BREAKING**: The package now is ESM-first. The CommonJS is still support and It should not affect most users, but it might break in certains environments. If you encounter any issues, please [report them](https://github.com/date-fns/date-fns/issues/new).
+
+### Fixed
+
+- Fixed CDN build compatibility with jQuery and other tools that expose `$` by properly wrapping the code in an IIFE.
+
 ## v3.6.0 - 2024-03-18
 
 On this release worked @kossnocorp and @world1dan. Also, thanks to [@seated](https://github.com/seated) [for sponsoring me](https://github.com/sponsors/kossnocorp).
@@ -90,7 +154,7 @@ This release is brought to you by @kossnocorp, @fturmel, @grossbart, @MelvinVerm
 
 ### Fixed
 
-- Fixed types compatability with Lodash's `flow` and fp-ts's `pipe`. ([#3641](https://github.com/date-fns/date-fns/issues/3641))
+- Fixed types compatibility with Lodash's `flow` and fp-ts's `pipe`. ([#3641](https://github.com/date-fns/date-fns/issues/3641))
 
 - [Fixed inconsistent behavior of `roundToNearestMinutes`.](https://github.com/date-fns/date-fns/pull/3132)
 
@@ -1559,7 +1623,7 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
 
 - [New `roundToNearestMinutes` function](https://github.com/date-fns/date-fns/pull/928). Kudos to [@xkizer](https://github.com/xkizer).
 
-- Added new function `fromUnixTime`. Thansk to [@xkizer](https://github.com/xkizer).
+- Added new function `fromUnixTime`. Thanks to [@xkizer](https://github.com/xkizer).
 
 - New interval, month, and year helpers to fetch a list of all Saturdays and Sundays (weekends) for a given date interval. `eachWeekendOfInterval` is the handler function while the other two are wrapper functions. Kudos to [@laekettavong](https://github.com/laekettavong)!
 

package/src/date-fns/_lib/addLeadingZeros/index.ts

@@ -1,5 +1,11 @@
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
 export function addLeadingZeros(number: number, targetLength: number): string {
   const sign = number < 0 ? '-' : '';
   const output = Math.abs(number).toString().padStart(targetLength, '0');
   return sign + output;
 }
+
+/* eslint-enable */

package/src/date-fns/_lib/defaultLocale/index.ts

@@ -1 +1,7 @@
-export { enUS as defaultLocale } from '../../locale/en-US/index';
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
+export { enUS as defaultLocale } from '../../locale/en-US/index.ts';
+
+/* eslint-enable */

package/src/date-fns/_lib/defaultOptions/index.ts

@@ -1,4 +1,8 @@
-import type { FirstWeekContainsDateOptions, Locale, LocalizedOptions, WeekOptions } from '../../types';
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
+import type { FirstWeekContainsDateOptions, Locale, LocalizedOptions, WeekOptions } from '../../types.ts';
 
 export type DefaultOptions = LocalizedOptions<keyof Locale> & WeekOptions & FirstWeekContainsDateOptions;
 
@@ -11,3 +15,5 @@ export function getDefaultOptions(): DefaultOptions {
 export function setDefaultOptions(newOptions: DefaultOptions): void {
   defaultOptions = newOptions;
 }
+
+/* eslint-enable */

package/src/date-fns/_lib/format/formatters/index.ts

@@ -1,9 +1,13 @@
-import { getDayOfYear } from '../../../getDayOfYear/index';
-import { getISOWeek } from '../../../getISOWeek/index';
-import { getISOWeekYear } from '../../../getISOWeekYear/index';
-import { getWeek } from '../../../getWeek/index';
-import { getWeekYear } from '../../../getWeekYear/index';
-import type { LocaleDayPeriod, Localize } from '../../../locale/types';
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
+import { getDayOfYear } from '../../../getDayOfYear/index.ts';
+import { getISOWeek } from '../../../getISOWeek/index.ts';
+import { getISOWeekYear } from '../../../getISOWeekYear/index.ts';
+import { getWeek } from '../../../getWeek/index.ts';
+import { getWeekYear } from '../../../getWeekYear/index.ts';
+import type { LocaleDayPeriod, Localize } from '../../../locale/types.ts';
 import type {
   Day,
   Era,
@@ -12,9 +16,9 @@ import type {
   Month,
   Quarter,
   WeekOptions,
-} from '../../../types';
-import { addLeadingZeros } from '../../addLeadingZeros/index';
-import { lightFormatters } from '../lightFormatters/index';
+} from '../../../types.ts';
+import { addLeadingZeros } from '../../addLeadingZeros/index.ts';
+import { lightFormatters } from '../lightFormatters/index.ts';
 
 const dayPeriodEnum = {
   am: 'am',
@@ -754,14 +758,13 @@ export const formatters: { [token: string]: Formatter } = {
 
   // Seconds timestamp
   t: function (date, token, _localize) {
-    const timestamp = Math.trunc(date.getTime() / 1000);
+    const timestamp = Math.trunc(+date / 1000);
     return addLeadingZeros(timestamp, token.length);
   },
 
   // Milliseconds timestamp
   T: function (date, token, _localize) {
-    const timestamp = date.getTime();
-    return addLeadingZeros(timestamp, token.length);
+    return addLeadingZeros(+date, token.length);
   },
 };
 
@@ -791,3 +794,5 @@ function formatTimezone(offset: number, delimiter: string = ''): string {
   const minutes = addLeadingZeros(absOffset % 60, 2);
   return sign + hours + delimiter + minutes;
 }
+
+/* eslint-enable */

package/src/date-fns/_lib/format/lightFormatters/index.ts

@@ -1,4 +1,8 @@
-import { addLeadingZeros } from '../../addLeadingZeros/index';
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
+import { addLeadingZeros } from '../../addLeadingZeros/index.ts';
 
 /*
  * |     | Unit                           |     | Unit                           |
@@ -56,7 +60,7 @@ export const lightFormatters = {
       case 'aaa':
         return dayPeriodEnumValue;
       case 'aaaaa':
-        return dayPeriodEnumValue[0]!;
+        return dayPeriodEnumValue[0];
       case 'aaaa':
       default:
         return dayPeriodEnumValue === 'am' ? 'a.m.' : 'p.m.';
@@ -97,3 +101,5 @@ export const lightFormatters = {
     return addLeadingZeros(fractionalSeconds, token.length);
   },
 };
+
+/* eslint-enable */

package/src/date-fns/_lib/format/longFormatters/index.ts

@@ -1,4 +1,8 @@
-import type { FormatLong } from '../../../locale/types';
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
+import type { FormatLong } from '../../../locale/types.ts';
 
 type LongFormatter = (pattern: string, formatLong: FormatLong) => string;
 
@@ -58,7 +62,7 @@ const dateTimeLongFormatter: LongFormatter = (pattern: string, formatLong: Forma
   }
 
   return dateTimeFormat
-    .replace('{{date}}', dateLongFormatter(datePattern!, formatLong))
+    .replace('{{date}}', dateLongFormatter(datePattern, formatLong))
     .replace('{{time}}', timeLongFormatter(timePattern, formatLong));
 };
 
@@ -66,3 +70,5 @@ export const longFormatters: Record<string, LongFormatter> = {
   p: timeLongFormatter,
   P: dateTimeLongFormatter,
 };
+
+/* eslint-enable */

package/src/date-fns/_lib/getRoundingMethod/index.ts

@@ -1,4 +1,8 @@
-import type { RoundingMethod } from '../../types';
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
+import type { RoundingMethod } from '../../types.ts';
 
 export function getRoundingMethod(method: RoundingMethod | undefined) {
   return (number: number) => {
@@ -8,3 +12,5 @@ export function getRoundingMethod(method: RoundingMethod | undefined) {
     return result === 0 ? 0 : result;
   };
 }
+
+/* eslint-enable */

package/src/date-fns/_lib/getTimezoneOffsetInMilliseconds/index.ts

@@ -1,4 +1,9 @@
-import { toDate } from '../../toDate/index';
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
+import { toDate } from '../../toDate/index.ts';
+import type { DateArg } from '../../types.ts';
 
 /**
  * Google Chrome as of 67.0.3396.87 introduced timezones with offset that includes seconds.
@@ -11,7 +16,7 @@ import { toDate } from '../../toDate/index';
  *
  * This function returns the timezone offset in milliseconds that takes seconds in account.
  */
-export function getTimezoneOffsetInMilliseconds(date: Date | number | string): number {
+export function getTimezoneOffsetInMilliseconds(date: DateArg<Date> & {}): number {
   const _date = toDate(date);
   const utcDate = new Date(
     Date.UTC(
@@ -27,3 +32,5 @@ export function getTimezoneOffsetInMilliseconds(date: Date | number | string): n
   utcDate.setUTCFullYear(_date.getFullYear());
   return +date - +utcDate;
 }
+
+/* eslint-enable */

package/src/date-fns/_lib/normalizeDates/index.ts

@@ -0,0 +1,25 @@
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
+import { constructFrom } from '../../constructFrom/index.ts';
+import type { ContextFn, DateArg } from '../../types.ts';
+
+export function normalizeDates(
+  context: ContextFn<Date> | undefined,
+  ...dates: [DateArg<Date>, DateArg<Date>, DateArg<Date>]
+): [Date, Date, Date];
+
+export function normalizeDates(
+  context: ContextFn<Date> | undefined,
+  ...dates: [DateArg<Date>, DateArg<Date>]
+): [Date, Date];
+
+export function normalizeDates(context: ContextFn<Date> | undefined, ...dates: Array<DateArg<Date> & {}>): Date[];
+
+export function normalizeDates(context: ContextFn<Date> | undefined, ...dates: Array<DateArg<Date> & {}>) {
+  const normalize = constructFrom.bind(null, context || dates.find((date) => typeof date === 'object'));
+  return dates.map(normalize);
+}
+
+/* eslint-enable */

package/src/date-fns/_lib/normalizeInterval/index.ts

@@ -0,0 +1,13 @@
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
+import type { ContextFn, Interval, NormalizedInterval } from '../../types.ts';
+import { normalizeDates } from '../normalizeDates/index.ts';
+
+export function normalizeInterval(context: ContextFn<Date> | undefined, interval: Interval): NormalizedInterval<Date> {
+  const [start, end] = normalizeDates(context, interval.start, interval.end);
+  return { start, end };
+}
+
+/* eslint-enable */

package/src/date-fns/_lib/protectedTokens/index.ts

@@ -1,3 +1,7 @@
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
 const dayOfYearTokenRE = /^D+$/;
 const weekYearTokenRE = /^Y+$/;
 
@@ -21,3 +25,5 @@ function message(token: string, format: string, input: string) {
   const subject = token[0] === 'Y' ? 'years' : 'days of the month';
   return `Use \`${token.toLowerCase()}\` instead of \`${token}\` (in \`${format}\`) for formatting ${subject} to the input \`${input}\`; see: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md`;
 }
+
+/* eslint-enable */

package/src/date-fns/add/index.ts

@@ -1,33 +1,32 @@
-import { addDays } from '../addDays/index';
-import { addMonths } from '../addMonths/index';
-import { constructFrom } from '../constructFrom/index';
-import { toDate } from '../toDate/index';
-import type { Duration } from '../types';
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
+import { addDays } from '../addDays/index.ts';
+import { addMonths } from '../addMonths/index.ts';
+import { constructFrom } from '../constructFrom/index.ts';
+import { toDate } from '../toDate/index.ts';
+import type { ContextOptions, DateArg, Duration } from '../types.ts';
+
+/**
+ * The {@link add} function options.
+ */
+export interface AddOptions<DateType extends Date = Date> extends ContextOptions<DateType> {}
 
 /**
  * @name add
  * @category Common Helpers
- * @summary Add the specified years, months, weeks, days, hours, minutes and seconds to the given date.
+ * @summary Add the specified years, months, weeks, days, hours, minutes, and seconds to the given date.
  *
  * @description
- * Add the specified years, months, weeks, days, hours, minutes and seconds to the given date.
+ * Add the specified years, months, weeks, days, hours, minutes, and seconds to the given date.
  *
- * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam DateType - The `Date` type the function operates on. Gets inferred from passed arguments. Allows using extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The date to be changed
- * @param duration - The object with years, months, weeks, days, hours, minutes and seconds to be added.
- *
- * | Key            | Description                        |
- * |----------------|------------------------------------|
- * | years          | Amount of years to be added        |
- * | months         | Amount of months to be added       |
- * | weeks          | Amount of weeks to be added        |
- * | days           | Amount of days to be added         |
- * | hours          | Amount of hours to be added        |
- * | minutes        | Amount of minutes to be added      |
- * | seconds        | Amount of seconds to be added      |
- *
- * All values default to 0
+ * @param duration - The object with years, months, weeks, days, hours, minutes, and seconds to be added.
+ * @param options - An object with options
  *
  * @returns The new date with the seconds added
  *
@@ -38,27 +37,32 @@ import type { Duration } from '../types';
  *   months: 9,
  *   weeks: 1,
  *   days: 7,
- *   hours: 5,\\-7
+ *   hours: 5,
  *   minutes: 9,
  *   seconds: 30,
  * })
  * //=> Thu Jun 15 2017 15:29:20
  */
-export function add<DateType extends Date>(date: DateType | number | string, duration: Duration): DateType {
+export function add<DateType extends Date, ResultDate extends Date = DateType>(
+  date: DateArg<DateType>,
+  duration: Duration,
+  options?: AddOptions<ResultDate> | undefined,
+): ResultDate {
   const { years = 0, months = 0, weeks = 0, days = 0, hours = 0, minutes = 0, seconds = 0 } = duration;
 
   // Add years and months
-  const _date = toDate(date);
+  const _date = toDate(date, options?.in);
   const dateWithMonths = months || years ? addMonths(_date, months + years * 12) : _date;
 
   // Add weeks and days
   const dateWithDays = days || weeks ? addDays(dateWithMonths, days + weeks * 7) : dateWithMonths;
 
-  // Add days, hours, minutes and seconds
+  // Add days, hours, minutes, and seconds
   const minutesToAdd = minutes + hours * 60;
   const secondsToAdd = seconds + minutesToAdd * 60;
   const msToAdd = secondsToAdd * 1000;
-  const finalDate = constructFrom(date, dateWithDays.getTime() + msToAdd);
 
-  return finalDate;
+  return constructFrom(options?.in || date, +dateWithDays + msToAdd);
 }
+
+/* eslint-enable */

package/src/date-fns/addBusinessDays/index.ts

@@ -1,21 +1,33 @@
-import { constructFrom } from '../constructFrom/index';
-import { isSaturday } from '../isSaturday/index';
-import { isSunday } from '../isSunday/index';
-import { isWeekend } from '../isWeekend/index';
-import { toDate } from '../toDate/index';
+/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+// @ts-nocheck
+
+import { constructFrom } from '../constructFrom/index.ts';
+import { isSaturday } from '../isSaturday/index.ts';
+import { isSunday } from '../isSunday/index.ts';
+import { isWeekend } from '../isWeekend/index.ts';
+import { toDate } from '../toDate/index.ts';
+import type { ContextOptions, DateArg } from '../types.ts';
+
+/**
+ * The {@link addBusinessDays} function options.
+ */
+export interface AddBusinessDaysOptions<DateType extends Date = Date> extends ContextOptions<DateType> {}
 
 /**
  * @name addBusinessDays
- * @category Date Extension Helpers
+ * @category Day Helpers
  * @summary Add the specified number of business days (mon - fri) to the given date.
  *
  * @description
  * Add the specified number of business days (mon - fri) to the given date, ignoring weekends.
  *
  * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ * @typeParam ResultDate - The result `Date` type, it is the type returned from the context function if it is passed, or inferred from the arguments.
  *
  * @param date - The date to be changed
  * @param amount - The amount of business days to be added.
+ * @param options - An object with options
  *
  * @returns The new date with the business days added
  *
@@ -24,11 +36,15 @@ import { toDate } from '../toDate/index';
  * const result = addBusinessDays(new Date(2014, 8, 1), 10)
  * //=> Mon Sep 15 2014 00:00:00 (skipped weekend days)
  */
-export function addBusinessDays<DateType extends Date>(date: DateType | number | string, amount: number): DateType {
-  const _date = toDate(date);
-  const startedOnWeekend = isWeekend(_date);
+export function addBusinessDays<DateType extends Date, ResultDate extends Date = DateType>(
+  date: DateArg<DateType>,
+  amount: number,
+  options?: AddBusinessDaysOptions<ResultDate> | undefined,
+): ResultDate {
+  const _date = toDate(date, options?.in);
+  const startedOnWeekend = isWeekend(_date, options);
 
-  if (isNaN(amount)) return constructFrom(date, NaN);
+  if (isNaN(amount)) return constructFrom(options?.in, NaN);
 
   const hours = _date.getHours();
   const sign = amount < 0 ? -1 : 1;
@@ -42,17 +58,17 @@ export function addBusinessDays<DateType extends Date>(date: DateType | number |
   // Loops over remaining days
   while (restDays > 0) {
     _date.setDate(_date.getDate() + sign);
-    if (!isWeekend(_date)) restDays -= 1;
+    if (!isWeekend(_date, options)) restDays -= 1;
   }
 
   // If the date is a weekend day and we reduce a dividable of
   // 5 from it, we land on a weekend date.
   // To counter this, we add days accordingly to land on the next business day
-  if (startedOnWeekend && isWeekend(_date) && amount !== 0) {
+  if (startedOnWeekend && isWeekend(_date, options) && amount !== 0) {
     // If we're reducing days, we want to add days until we land on a weekday
     // If we're adding days we want to reduce days until we land on a weekday
-    if (isSaturday(_date)) _date.setDate(_date.getDate() + (sign < 0 ? 2 : -1));
-    if (isSunday(_date)) _date.setDate(_date.getDate() + (sign < 0 ? 1 : -2));
+    if (isSaturday(_date, options)) _date.setDate(_date.getDate() + (sign < 0 ? 2 : -1));
+    if (isSunday(_date, options)) _date.setDate(_date.getDate() + (sign < 0 ? 1 : -2));
   }
 
   // Restore hours to avoid DST lag
@@ -60,3 +76,5 @@ export function addBusinessDays<DateType extends Date>(date: DateType | number |
 
   return _date;
 }
+
+/* eslint-enable */