/**
 * Adjusts a given date by a specified amount of time.
 *
 * This function allows you to shift a date by a specific number of years, months, weeks, days, hours, minutes, and seconds.
 * You can specify any combination of these time units, and the function will return a new Date object with the adjustments applied.
 *
 * @param {Object} timeUnits - An object containing the time units to adjust.
 * @param {number} [timeUnits.years=0] - The number of years to add to the date.
 * @param {number} [timeUnits.months=0] - The number of months to add to the date.
 * @param {number} [timeUnits.weeks=0] - The number of weeks to add to the date.
 * @param {number} [timeUnits.days=0] - The number of days to add to the date.
 * @param {number} [timeUnits.hours=0] - The number of hours to add to the date.
 * @param {number} [timeUnits.minutes=0] - The number of minutes to add to the date.
 * @param {number} [timeUnits.seconds=0] - The number of seconds to add to the date.
 * @param {Date} [baseDate=new Date()] - The base date to adjust. Defaults to the current date and time.
 * @returns {Date} A new Date object with the specified time adjustments applied.
 */
export declare function shiftTime({ years, months, weeks, days, hours, minutes, seconds, }: Partial<Record<"years" | "months" | "weeks" | "days" | "hours" | "minutes" | "seconds", number>>, baseDate?: Date | string | number): Date;