export type FormatDateParams = {
    /**
     * The format string using tokens.
     *
     * Tokens:
     * - YYYY: 4-digit year (e.g., 2024)
     * - YY: 2-digit year (e.g., 24)
     * - MMMM: Full month name (e.g., January)
     * - MMM: Short month name (e.g., Jan)
     * - MM: 2-digit month (01-12)
     * - M: Month number (1-12)
     * - DD: 2-digit day of month (01-31)
     * - D: Day of month (1-31)
     * - dddd: Full day of week (e.g., Monday)
     * - ddd: Short day of week (e.g., Mon)
     * - HH: 24-hour hour (00-23)
     * - H: 24-hour hour (0-23)
     * - hh: 12-hour hour (01-12)
     * - h: 12-hour hour (1-12)
     * - mm: 2-digit minute (00-59)
     * - m: minute (0-59)
     * - ss: 2-digit second (00-59)
     * - s: second (0-59)
     * - A: AM/PM
     * - a: am/pm
     * - [text]: Escaped literal text
     */
    format?: string;
    /** @deprecated Use MMMM or MMM tokens instead */
    monthFormat?: "short" | "long";
    /** @deprecated Use dddd or ddd tokens instead */
    dayFormat?: "short" | "long";
};
/**
 * Formats a given date object, string, or timestamp into a specified format.
 *
 * @param date The date to format (Date object, ISO string, or timestamp).
 * @param options Options object or format string. Defaults to "DD/MM/YYYY".
 * @returns A string representing the formatted date.
 *
 * @example
 * formatDate(new Date(), "YYYY-MM-DD HH:mm:ss") // "2024-01-25 14:30:05"
 * formatDate("2024-01-25", "MMMM DD, YYYY") // "January 25, 2024"
 * formatDate(Date.now(), "[Today is] dddd") // "Today is Thursday"
 */
export declare function formatDate(date?: Date | string | number | null, options?: string | FormatDateParams): string;