| 12345678910111213141516171819202122232425262728293031323334353637383940 |
- "use strict";
- exports.constructFrom = constructFrom;
- /**
- * @name constructFrom
- * @category Generic Helpers
- * @summary Constructs a date using the reference date and the value
- *
- * @description
- * The function constructs a new date using the constructor from the reference
- * date and the given value. It helps to build generic functions that accept
- * date extensions.
- *
- * It defaults to `Date` if the passed reference date is a number or a string.
- *
- * @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).
- *
- * @param date - The reference date to take constructor from
- * @param value - The value to create the date
- *
- * @returns Date initialized using the given date and value
- *
- * @example
- * import { constructFrom } from 'date-fns'
- *
- * // A function that clones a date preserving the original type
- * function cloneDate<DateType extends Date(date: DateType): DateType {
- * return constructFrom(
- * date, // Use contrustor from the given date
- * date.getTime() // Use the date value to create a new date
- * )
- * }
- */
- function constructFrom(date, value) {
- if (date instanceof Date) {
- return new date.constructor(value);
- } else {
- return new Date(value);
- }
- }
|