Marc Mintel
5397309103
Some checks failed
Build & Deploy / 🔍 Prepare (push) Successful in 20s
Build & Deploy / 🧪 QA (push) Failing after 34s
Build & Deploy / 🏗️ Build (push) Has started running
Build & Deploy / 🚀 Deploy (push) Has been cancelled
Build & Deploy / 🧪 Smoke Test (push) Has been cancelled
Build & Deploy / ⚡ Lighthouse (push) Has been cancelled
Build & Deploy / 🔔 Notify (push) Has been cancelled
40 lines
1.2 KiB
Plaintext
40 lines
1.2 KiB
Plaintext
import type { ContextFn, GenericDateConstructor } from "./types.js";
|
|
/**
|
|
* @name transpose
|
|
* @category Generic Helpers
|
|
* @summary Transpose the date to the given constructor.
|
|
*
|
|
* @description
|
|
* The function transposes the date to the given constructor. It helps you
|
|
* to transpose the date in the system time zone to say `UTCDate` or any other
|
|
* date extension.
|
|
*
|
|
* @typeParam InputDate - The input `Date` type derived from the passed argument.
|
|
* @typeParam ResultDate - The result `Date` type derived from the passed constructor.
|
|
*
|
|
* @param date - The date to use values from
|
|
* @param constructor - The date constructor to use
|
|
*
|
|
* @returns Date transposed to the given constructor
|
|
*
|
|
* @example
|
|
* // Create July 10, 2022 00:00 in locale time zone
|
|
* const date = new Date(2022, 6, 10)
|
|
* //=> 'Sun Jul 10 2022 00:00:00 GMT+0800 (Singapore Standard Time)'
|
|
*
|
|
* @example
|
|
* // Transpose the date to July 10, 2022 00:00 in UTC
|
|
* transpose(date, UTCDate)
|
|
* //=> 'Sun Jul 10 2022 00:00:00 GMT+0000 (Coordinated Universal Time)'
|
|
*/
|
|
export declare function transpose<
|
|
InputDate extends Date,
|
|
ResultDate extends Date,
|
|
>(
|
|
date: InputDate,
|
|
constructor:
|
|
| ResultDate
|
|
| GenericDateConstructor<ResultDate>
|
|
| ContextFn<ResultDate>,
|
|
): ResultDate;
|