import { type Locale } from "date-fns";
import { type AppTimeFormat } from "../../app/time-formats.js";
import type { AppLocale, AppDateFormat } from "../../app/types.js";
export type FormatDatetimeOptions = {
    locale?: Locale | AppLocale;
    timezone?: string;
    timeFormat?: AppTimeFormat;
    dateFormat?: AppDateFormat;
};
/** Date-only from calendar picker — uses Y/M/D in app timezone. */
export declare function formatCalendarDate(value: Date | null | undefined, options?: FormatDatetimeOptions): string;
/** Date-only from ISO instant or `yyyy-MM-dd` string — date part in app timezone. */
export declare function formatAppDate(value: string | Date | null | undefined, options?: FormatDatetimeOptions): string;
/** Date + time in app timezone. */
export declare function formatAppDateTime(value: string | Date | null | undefined, options?: FormatDatetimeOptions): string;
/** Time from ISO instant in app timezone. */
export declare function formatAppTime(value: string | Date | null | undefined, options?: FormatDatetimeOptions): string;
/** Long date (PPP) in app timezone. */
export declare function formatAppDateLong(value: string | Date | null | undefined, options?: FormatDatetimeOptions): string;
/** Relative time — instant-based; locale from context. */
export declare function formatAppRelative(value: string | Date | null | undefined, options?: Pick<FormatDatetimeOptions, "locale">): string;
/** Format canonical HH:mm (24h storage) for display per timeFormat + locale. */
export declare function formatTimeOfDay(hhmm: string | null | undefined, options?: FormatDatetimeOptions): string;