@checkdigit/time 1.1.0 → 2.0.0-PR.14-c9b0

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

@@ -0,0 +1,28 @@
+import { secondsInMinute } from '../constants/index';
+
+/**
+ * @name secondsToMinutes
+ * @category Conversion Helpers
+ * @summary Convert seconds to minutes.
+ *
+ * @description
+ * Convert a number of seconds to a full number of minutes.
+ *
+ * @param seconds - number of seconds to be converted
+ *
+ * @returns the number of seconds converted in minutes
+ *
+ * @example
+ * // Convert 120 seconds into minutes
+ * const result = secondsToMinutes(120)
+ * //=> 2
+ *
+ * @example
+ * // It uses floor rounding:
+ * const result = secondsToMinutes(119)
+ * //=> 1
+ */
+export default function secondsToMinutes(seconds: number): number {
+  const minutes = seconds / secondsInMinute;
+  return Math.floor(minutes);
+}

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

@@ -0,0 +1,80 @@
+import constructFrom from '../constructFrom/index';
+import setMonth from '../setMonth/index';
+import toDate from '../toDate/index';
+import type { DateValues } from '../types';
+
+/**
+ * @name set
+ * @category Common Helpers
+ * @summary Set date values to a given date.
+ *
+ * @description
+ * Set date values to a given date.
+ *
+ * Sets time values to date from object `values`.
+ * A value is not set if it is undefined or null or doesn't exist in `values`.
+ *
+ * Note about bundle size: `set` does not internally use `setX` functions from date-fns but instead opts
+ * to use native `Date#setX` methods. If you use this function, you may not want to include the
+ * other `setX` functions that date-fns provides if you are concerned about the bundle size.
+ *
+ * @param date - the date to be changed
+ * @param values - an object with options
+ * @param values.year - the number of years to be set
+ * @param values.month - the number of months to be set
+ * @param values.date - the number of days to be set
+ * @param values.hours - the number of hours to be set
+ * @param values.minutes - the number of minutes to be set
+ * @param values.seconds - the number of seconds to be set
+ * @param values.milliseconds - the number of milliseconds to be set
+ * @returns the new date with options set
+ *
+ * @example
+ * // Transform 1 September 2014 into 20 October 2015 in a single line:
+ * const result = set(new Date(2014, 8, 20), { year: 2015, month: 9, date: 20 })
+ * //=> Tue Oct 20 2015 00:00:00
+ *
+ * @example
+ * // Set 12 PM to 1 September 2014 01:23:45 to 1 September 2014 12:00:00:
+ * const result = set(new Date(2014, 8, 1, 1, 23, 45), { hours: 12 })
+ * //=> Mon Sep 01 2014 12:23:45
+ */
+
+export default function set<DateType extends Date>(dirtyDate: DateType | number, values: DateValues): DateType {
+  let date = toDate(dirtyDate);
+
+  // Check if date is Invalid Date because Date.prototype.setFullYear ignores the value of Invalid Date
+  if (isNaN(date.getTime())) {
+    return constructFrom(dirtyDate, NaN);
+  }
+
+  if (values.year != null) {
+    date.setFullYear(values.year);
+  }
+
+  if (values.month != null) {
+    date = setMonth(date, values.month);
+  }
+
+  if (values.date != null) {
+    date.setDate(values.date);
+  }
+
+  if (values.hours != null) {
+    date.setHours(values.hours);
+  }
+
+  if (values.minutes != null) {
+    date.setMinutes(values.minutes);
+  }
+
+  if (values.seconds != null) {
+    date.setSeconds(values.seconds);
+  }
+
+  if (values.milliseconds != null) {
+    date.setMilliseconds(values.milliseconds);
+  }
+
+  return date;
+}

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

@@ -0,0 +1,24 @@
+import toDate from '../toDate/index';
+
+/**
+ * @name setDate
+ * @category Day Helpers
+ * @summary Set the day of the month to the given date.
+ *
+ * @description
+ * Set the day of the month to the given date.
+ *
+ * @param date - the date to be changed
+ * @param dayOfMonth - the day of the month of the new date
+ * @returns the new date with the day of the month set
+ *
+ * @example
+ * // Set the 30th day of the month to 1 September 2014:
+ * const result = setDate(new Date(2014, 8, 1), 30)
+ * //=> Tue Sep 30 2014 00:00:00
+ */
+export default function setDate<DateType extends Date>(dirtyDate: DateType | number, dayOfMonth: number): DateType {
+  const date = toDate(dirtyDate);
+  date.setDate(dayOfMonth);
+  return date;
+}

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

@@ -0,0 +1,57 @@
+import addDays from '../addDays/index';
+import toDate from '../toDate/index';
+import type { LocaleOptions, WeekStartOptions } from '../types';
+import { getDefaultOptions } from '../_lib/defaultOptions/index';
+
+/**
+ * The {@link setDay} function options.
+ */
+export interface SetDayOptions extends LocaleOptions, WeekStartOptions {}
+
+/**
+ * @name setDay
+ * @category Weekday Helpers
+ * @summary Set the day of the week to the given date.
+ *
+ * @description
+ * Set the day of the week to the given date.
+ *
+ * @param date - the date to be changed
+ * @param day - the day of the week of the new date
+ * @param options - an object with options.
+ * @returns the new date with the day of the week set
+ *
+ * @example
+ * // Set week day to Sunday, with the default weekStartsOn of Sunday:
+ * const result = setDay(new Date(2014, 8, 1), 0)
+ * //=> Sun Aug 31 2014 00:00:00
+ *
+ * @example
+ * // Set week day to Sunday, with a weekStartsOn of Monday:
+ * const result = setDay(new Date(2014, 8, 1), 0, { weekStartsOn: 1 })
+ * //=> Sun Sep 07 2014 00:00:00
+ */
+export default function setDay<DateType extends Date>(
+  dirtyDate: DateType | number,
+  day: number,
+  options?: SetDayOptions,
+): DateType {
+  const defaultOptions = getDefaultOptions();
+  const weekStartsOn =
+    options?.weekStartsOn ??
+    options?.locale?.options?.weekStartsOn ??
+    defaultOptions.weekStartsOn ??
+    defaultOptions.locale?.options?.weekStartsOn ??
+    0;
+
+  const date = toDate(dirtyDate);
+  const currentDay = date.getDay();
+
+  const remainder = day % 7;
+  const dayIndex = (remainder + 7) % 7;
+
+  const delta = 7 - weekStartsOn;
+  const diff =
+    day < 0 || day > 6 ? day - ((currentDay + delta) % 7) : ((dayIndex + delta) % 7) - ((currentDay + delta) % 7);
+  return addDays(date, diff);
+}

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

@@ -0,0 +1,25 @@
+import toDate from '../toDate/index';
+
+/**
+ * @name setDayOfYear
+ * @category Day Helpers
+ * @summary Set the day of the year to the given date.
+ *
+ * @description
+ * Set the day of the year to the given date.
+ *
+ * @param date - the date to be changed
+ * @param dayOfYear - the day of the year of the new date
+ * @returns the new date with the day of the year set
+ *
+ * @example
+ * // Set the 2nd day of the year to 2 July 2014:
+ * const result = setDayOfYear(new Date(2014, 6, 2), 2)
+ * //=> Thu Jan 02 2014 00:00:00
+ */
+export default function setDayOfYear<DateType extends Date>(dirtyDate: DateType | number, dayOfYear: number): DateType {
+  const date = toDate(dirtyDate);
+  date.setMonth(0);
+  date.setDate(dayOfYear);
+  return date;
+}

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

@@ -0,0 +1,76 @@
+import {
+  getDefaultOptions,
+  setDefaultOptions as setInternalDefaultOptions,
+  DefaultOptions,
+} from '../_lib/defaultOptions/index';
+
+/**
+ * @name setDefaultOptions
+ * @category Common Helpers
+ * @summary Set default options including locale.
+ * @pure false
+ *
+ * @description
+ * Sets the defaults for
+ * `options.locale`, `options.weekStartsOn` and `options.firstWeekContainsDate`
+ * arguments for all functions.
+ *
+ * @param newOptions - an object with options.
+ * @param newOptions.locale - the locale object. See [Locale]{@link https://date-fns.org/docs/Locale}
+ * @param newOptions.weekStartsOn - the index of the first day of the week (0 - Sunday)
+ * @param newOptions.firstWeekContainsDate - the day of January, which is always in the first week of the year
+ *
+ * @example
+ * // Set global locale:
+ * import { es } from 'date-fns/locale'
+ * setDefaultOptions({ locale: es })
+ * const result = format(new Date(2014, 8, 2), 'PPPP')
+ * //=> 'martes, 2 de septiembre de 2014'
+ *
+ * @example
+ * // Start of the week for 2 September 2014:
+ * const result = startOfWeek(new Date(2014, 8, 2))
+ * //=> Sun Aug 31 2014 00:00:00
+ *
+ * @example
+ * // Start of the week for 2 September 2014,
+ * // when we set that week starts on Monday by default:
+ * setDefaultOptions({ weekStartsOn: 1 })
+ * const result = startOfWeek(new Date(2014, 8, 2))
+ * //=> Mon Sep 01 2014 00:00:00
+ *
+ * @example
+ * // Manually set options take priority over default options:
+ * setDefaultOptions({ weekStartsOn: 1 })
+ * const result = startOfWeek(new Date(2014, 8, 2), { weekStartsOn: 0 })
+ * //=> Sun Aug 31 2014 00:00:00
+ *
+ * @example
+ * // Remove the option by setting it to `undefined`:
+ * setDefaultOptions({ weekStartsOn: 1 })
+ * setDefaultOptions({ weekStartsOn: undefined })
+ * const result = startOfWeek(new Date(2014, 8, 2))
+ * //=> Sun Aug 31 2014 00:00:00
+ */
+export default function setDefaultOptions(newOptions: DefaultOptions): void {
+  const result: DefaultOptions = {};
+  const defaultOptions = getDefaultOptions();
+
+  for (const property in defaultOptions) {
+    if (Object.prototype.hasOwnProperty.call(defaultOptions, property)) {
+      (result as any)[property] = defaultOptions[property as keyof DefaultOptions];
+    }
+  }
+
+  for (const property in newOptions) {
+    if (Object.prototype.hasOwnProperty.call(newOptions, property)) {
+      if (newOptions[property as keyof DefaultOptions] === undefined) {
+        delete (result as any)[property];
+      } else {
+        (result as any)[property] = newOptions[property as keyof DefaultOptions];
+      }
+    }
+  }
+
+  setInternalDefaultOptions(result);
+}

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

@@ -0,0 +1,24 @@
+import toDate from '../toDate/index';
+
+/**
+ * @name setHours
+ * @category Hour Helpers
+ * @summary Set the hours to the given date.
+ *
+ * @description
+ * Set the hours to the given date.
+ *
+ * @param date - the date to be changed
+ * @param hours - the hours of the new date
+ * @returns the new date with the hours set
+ *
+ * @example
+ * // Set 4 hours to 1 September 2014 11:30:00:
+ * const result = setHours(new Date(2014, 8, 1, 11, 30), 4)
+ * //=> Mon Sep 01 2014 04:30:00
+ */
+export default function setHours<DateType extends Date>(dirtyDate: DateType | number, hours: number): DateType {
+  const date = toDate(dirtyDate);
+  date.setHours(hours);
+  return date;
+}

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

@@ -0,0 +1,29 @@
+import addDays from '../addDays/index';
+import getISODay from '../getISODay/index';
+import toDate from '../toDate/index';
+
+/**
+ * @name setISODay
+ * @category Weekday Helpers
+ * @summary Set the day of the ISO week to the given date.
+ *
+ * @description
+ * Set the day of the ISO week to the given date.
+ * ISO week starts with Monday.
+ * 7 is the index of Sunday, 1 is the index of Monday etc.
+ *
+ * @param date - the date to be changed
+ * @param day - the day of the ISO week of the new date
+ * @returns the new date with the day of the ISO week set
+ *
+ * @example
+ * // Set Sunday to 1 September 2014:
+ * const result = setISODay(new Date(2014, 8, 1), 7)
+ * //=> Sun Sep 07 2014 00:00:00
+ */
+export default function setISODay<DateType extends Date>(dirtyDate: DateType | number, day: number): DateType {
+  const date = toDate(dirtyDate);
+  const currentDay = getISODay(date);
+  const diff = day - currentDay;
+  return addDays(date, diff);
+}

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

@@ -0,0 +1,28 @@
+import getISOWeek from '../getISOWeek/index';
+import toDate from '../toDate/index';
+
+/**
+ * @name setISOWeek
+ * @category ISO Week Helpers
+ * @summary Set the ISO week to the given date.
+ *
+ * @description
+ * Set the ISO week to the given date, saving the weekday number.
+ *
+ * ISO week-numbering year: http://en.wikipedia.org/wiki/ISO_week_date
+ *
+ * @param date - the date to be changed
+ * @param isoWeek - the ISO week of the new date
+ * @returns the new date with the ISO week set
+ *
+ * @example
+ * // Set the 53rd ISO week to 7 August 2004:
+ * const result = setISOWeek(new Date(2004, 7, 7), 53)
+ * //=> Sat Jan 01 2005 00:00:00
+ */
+export default function setISOWeek<DateType extends Date>(dirtyDate: DateType | number, isoWeek: number): DateType {
+  const date = toDate(dirtyDate);
+  const diff = getISOWeek(date) - isoWeek;
+  date.setDate(date.getDate() - diff * 7);
+  return date;
+}

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

@@ -0,0 +1,38 @@
+import constructFrom from '../constructFrom/index';
+import differenceInCalendarDays from '../differenceInCalendarDays/index';
+import startOfISOWeekYear from '../startOfISOWeekYear/index';
+import toDate from '../toDate/index';
+
+/**
+ * @name setISOWeekYear
+ * @category ISO Week-Numbering Year Helpers
+ * @summary Set the ISO week-numbering year to the given date.
+ *
+ * @description
+ * Set the ISO week-numbering year to the given date,
+ * saving the week number and the weekday number.
+ *
+ * ISO week-numbering year: http://en.wikipedia.org/wiki/ISO_week_date
+ *
+ * @param date - the date to be changed
+ * @param isoWeekYear - the ISO week-numbering year of the new date
+ * @returns the new date with the ISO week-numbering year set
+ *
+ * @example
+ * // Set ISO week-numbering year 2007 to 29 December 2008:
+ * const result = setISOWeekYear(new Date(2008, 11, 29), 2007)
+ * //=> Mon Jan 01 2007 00:00:00
+ */
+export default function setISOWeekYear<DateType extends Date>(
+  dirtyDate: DateType | number,
+  isoWeekYear: number,
+): DateType {
+  let date = toDate(dirtyDate);
+  const diff = differenceInCalendarDays(date, startOfISOWeekYear(date));
+  const fourthOfJanuary = constructFrom(dirtyDate, 0);
+  fourthOfJanuary.setFullYear(isoWeekYear, 0, 4);
+  fourthOfJanuary.setHours(0, 0, 0, 0);
+  date = startOfISOWeekYear(fourthOfJanuary);
+  date.setDate(date.getDate() + diff);
+  return date;
+}

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

@@ -0,0 +1,27 @@
+import toDate from '../toDate/index';
+
+/**
+ * @name setMilliseconds
+ * @category Millisecond Helpers
+ * @summary Set the milliseconds to the given date.
+ *
+ * @description
+ * Set the milliseconds to the given date.
+ *
+ * @param date - the date to be changed
+ * @param milliseconds - the milliseconds of the new date
+ * @returns the new date with the milliseconds set
+ *
+ * @example
+ * // Set 300 milliseconds to 1 September 2014 11:30:40.500:
+ * const result = setMilliseconds(new Date(2014, 8, 1, 11, 30, 40, 500), 300)
+ * //=> Mon Sep 01 2014 11:30:40.300
+ */
+export default function setMilliseconds<DateType extends Date>(
+  dirtyDate: DateType | number,
+  milliseconds: number,
+): DateType {
+  const date = toDate(dirtyDate);
+  date.setMilliseconds(milliseconds);
+  return date;
+}

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

@@ -0,0 +1,24 @@
+import toDate from '../toDate/index';
+
+/**
+ * @name setMinutes
+ * @category Minute Helpers
+ * @summary Set the minutes to the given date.
+ *
+ * @description
+ * Set the minutes to the given date.
+ *
+ * @param date - the date to be changed
+ * @param minutes - the minutes of the new date
+ * @returns the new date with the minutes set
+ *
+ * @example
+ * // Set 45 minutes to 1 September 2014 11:30:40:
+ * const result = setMinutes(new Date(2014, 8, 1, 11, 30, 40), 45)
+ * //=> Mon Sep 01 2014 11:45:40
+ */
+export default function setMinutes<DateType extends Date>(dirtyDate: DateType | number, minutes: number): DateType {
+  const date = toDate(dirtyDate);
+  date.setMinutes(minutes);
+  return date;
+}

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

@@ -0,0 +1,35 @@
+import constructFrom from '../constructFrom/index';
+import getDaysInMonth from '../getDaysInMonth/index';
+import toDate from '../toDate/index';
+
+/**
+ * @name setMonth
+ * @category Month Helpers
+ * @summary Set the month to the given date.
+ *
+ * @description
+ * Set the month to the given date.
+ *
+ * @param date - the date to be changed
+ * @param month - the month of the new date
+ * @returns the new date with the month set
+ *
+ * @example
+ * // Set February to 1 September 2014:
+ * const result = setMonth(new Date(2014, 8, 1), 1)
+ * //=> Sat Feb 01 2014 00:00:00
+ */
+export default function setMonth<DateType extends Date>(dirtyDate: DateType | number, month: number): DateType {
+  const date = toDate(dirtyDate);
+  const year = date.getFullYear();
+  const day = date.getDate();
+
+  const dateWithDesiredMonth = constructFrom(dirtyDate, 0);
+  dateWithDesiredMonth.setFullYear(year, month, 15);
+  dateWithDesiredMonth.setHours(0, 0, 0, 0);
+  const daysInMonth = getDaysInMonth(dateWithDesiredMonth);
+  // Set the last day of the new month
+  // if the original date was the last day of the longer month
+  date.setMonth(month, Math.min(day, daysInMonth));
+  return date;
+}

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

@@ -0,0 +1,26 @@
+import setMonth from '../setMonth/index';
+import toDate from '../toDate/index';
+
+/**
+ * @name setQuarter
+ * @category Quarter Helpers
+ * @summary Set the year quarter to the given date.
+ *
+ * @description
+ * Set the year quarter to the given date.
+ *
+ * @param date - the date to be changed
+ * @param quarter - the quarter of the new date
+ * @returns the new date with the quarter set
+ *
+ * @example
+ * // Set the 2nd quarter to 2 July 2014:
+ * const result = setQuarter(new Date(2014, 6, 2), 2)
+ * //=> Wed Apr 02 2014 00:00:00
+ */
+export default function setQuarter<DateType extends Date>(dirtyDate: DateType | number, quarter: number): DateType {
+  const date = toDate(dirtyDate);
+  const oldQuarter = Math.floor(date.getMonth() / 3) + 1;
+  const diff = quarter - oldQuarter;
+  return setMonth(date, date.getMonth() + diff * 3);
+}

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

@@ -0,0 +1,24 @@
+import toDate from '../toDate/index';
+
+/**
+ * @name setSeconds
+ * @category Second Helpers
+ * @summary Set the seconds to the given date.
+ *
+ * @description
+ * Set the seconds to the given date.
+ *
+ * @param date - the date to be changed
+ * @param seconds - the seconds of the new date
+ * @returns the new date with the seconds set
+ *
+ * @example
+ * // Set 45 seconds to 1 September 2014 11:30:40:
+ * const result = setSeconds(new Date(2014, 8, 1, 11, 30, 40), 45)
+ * //=> Mon Sep 01 2014 11:30:45
+ */
+export default function setSeconds<DateType extends Date>(dirtyDate: DateType | number, seconds: number): DateType {
+  const date = toDate(dirtyDate);
+  date.setSeconds(seconds);
+  return date;
+}

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

@@ -0,0 +1,53 @@
+import getWeek from '../getWeek/index';
+import toDate from '../toDate/index';
+import type { FirstWeekContainsDateOptions, LocaleOptions, WeekStartOptions } from '../types';
+
+/**
+ * The {@link setWeek} function options.
+ */
+export interface SetWeekOptions extends LocaleOptions, WeekStartOptions, FirstWeekContainsDateOptions {}
+
+/**
+ * @name setWeek
+ * @category Week Helpers
+ * @summary Set the local week to the given date.
+ *
+ * @description
+ * Set the local week to the given date, saving the weekday number.
+ * The exact calculation depends on the values of
+ * `options.weekStartsOn` (which is the index of the first day of the week)
+ * and `options.firstWeekContainsDate` (which is the day of January, which is always in
+ * the first week of the week-numbering year)
+ *
+ * Week numbering: https://en.wikipedia.org/wiki/Week#Week_numbering
+ *
+ * @param date - the date to be changed
+ * @param week - the week of the new date
+ * @param options - an object with options.
+ * @returns the new date with the local week set
+ *
+ * @example
+ * // Set the 1st week to 2 January 2005 with default options:
+ * const result = setWeek(new Date(2005, 0, 2), 1)
+ * //=> Sun Dec 26 2004 00:00:00
+ *
+ * @example
+ * // Set the 1st week to 2 January 2005,
+ * // if Monday is the first day of the week,
+ * // and the first week of the year always contains 4 January:
+ * const result = setWeek(new Date(2005, 0, 2), 1, {
+ *   weekStartsOn: 1,
+ *   firstWeekContainsDate: 4
+ * })
+ * //=> Sun Jan 4 2004 00:00:00
+ */
+export default function setWeek<DateType extends Date>(
+  dirtyDate: DateType | number,
+  week: number,
+  options?: SetWeekOptions,
+): DateType {
+  const date = toDate(dirtyDate);
+  const diff = getWeek(date, options) - week;
+  date.setDate(date.getDate() - diff * 7);
+  return date;
+}

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

@@ -0,0 +1,69 @@
+import constructFrom from '../constructFrom/index';
+import differenceInCalendarDays from '../differenceInCalendarDays/index';
+import startOfWeekYear from '../startOfWeekYear/index';
+import toDate from '../toDate/index';
+import type { FirstWeekContainsDateOptions, LocaleOptions, WeekStartOptions } from '../types';
+import { getDefaultOptions } from '../_lib/defaultOptions/index';
+
+/**
+ * The {@link setWeekYear} function options.
+ */
+export interface SetWeekYearOptions extends LocaleOptions, WeekStartOptions, FirstWeekContainsDateOptions {}
+
+/**
+ * @name setWeekYear
+ * @category Week-Numbering Year Helpers
+ * @summary Set the local week-numbering year to the given date.
+ *
+ * @description
+ * Set the local week-numbering year to the given date,
+ * saving the week number and the weekday number.
+ * The exact calculation depends on the values of
+ * `options.weekStartsOn` (which is the index of the first day of the week)
+ * and `options.firstWeekContainsDate` (which is the day of January, which is always in
+ * the first week of the week-numbering year)
+ *
+ * Week numbering: https://en.wikipedia.org/wiki/Week#Week_numbering
+ *
+ * @param date - the date to be changed
+ * @param weekYear - the local week-numbering year of the new date
+ * @param options - an object with options.
+ * @returns the new date with the local week-numbering year set
+ *
+ * @example
+ * // Set the local week-numbering year 2004 to 2 January 2010 with default options:
+ * const result = setWeekYear(new Date(2010, 0, 2), 2004)
+ * //=> Sat Jan 03 2004 00:00:00
+ *
+ * @example
+ * // Set the local week-numbering year 2004 to 2 January 2010,
+ * // if Monday is the first day of week
+ * // and 4 January is always in the first week of the year:
+ * const result = setWeekYear(new Date(2010, 0, 2), 2004, {
+ *   weekStartsOn: 1,
+ *   firstWeekContainsDate: 4
+ * })
+ * //=> Sat Jan 01 2005 00:00:00
+ */
+export default function setWeekYear<DateType extends Date>(
+  dirtyDate: DateType | number,
+  weekYear: number,
+  options?: SetWeekYearOptions,
+): DateType {
+  const defaultOptions = getDefaultOptions();
+  const firstWeekContainsDate =
+    options?.firstWeekContainsDate ??
+    options?.locale?.options?.firstWeekContainsDate ??
+    defaultOptions.firstWeekContainsDate ??
+    defaultOptions.locale?.options?.firstWeekContainsDate ??
+    1;
+
+  let date = toDate(dirtyDate);
+  const diff = differenceInCalendarDays(date, startOfWeekYear(date, options));
+  const firstWeek = constructFrom(dirtyDate, 0);
+  firstWeek.setFullYear(weekYear, 0, firstWeekContainsDate);
+  firstWeek.setHours(0, 0, 0, 0);
+  date = startOfWeekYear(firstWeek, options);
+  date.setDate(date.getDate() + diff);
+  return date;
+}