import { TemporalFormat } from "@trackunit/date-and-time-utils";
import { CommonProps, Refable, type Styleable } from "@trackunit/react-components";
import { TimeZone } from "../TimeZone";
export interface DateTimeProps extends CommonProps, Refable<HTMLTimeElement>, Styleable {
    /**
     * The date/time value to display. Accepts a `Date` object, an ISO 8601 string, or a Unix timestamp in milliseconds.
     * When `null` or `undefined`, the current date/time is used.
     */
    value: Date | string | number | null | undefined;
    /**
     * Display format using a `TemporalFormat` configuration object. Use presets from `DateTimeFormat`
     * (e.g., `DateTimeFormat.DATE`, `DateTimeFormat.DATE_LONG_TIME`, `DateTimeFormat.TIME_SHORT`).
     */
    format?: TemporalFormat;
    /**
     * When true, displays a relative time string (e.g., "3 hours ago") instead of the formatted date.
     *
     * @default false
     */
    fromNow?: boolean;
    /**
     * When true, adds a native HTML `title` attribute with the formatted date so the full value is shown on hover.
     *
     * @default false
     */
    withTitle?: boolean;
    /**
     * Custom `TemporalFormat` for the hover `title` attribute. Only used when `withTitle` is true.
     */
    titleFormat?: TemporalFormat;
    /**
     * When true, renders the text in a muted neutral color for less visual emphasis.
     *
     * @default false
     */
    subtle?: boolean;
    /**
     * Explicit timezone override. When provided, this takes precedence over the automatically resolved
     * timezone from the user's preference context. Useful for showing a date in a fixed timezone
     * regardless of user settings (e.g. a contract's original timezone).
     *
     * In most cases you do not need this — the component resolves the correct timezone automatically
     * via `AssetTimezoneProvider` and user preference context.
     */
    timezone?: TimeZone;
}
export declare const MS_PER_HOUR: number;
/**
 * DateTime renders a locale-aware, formatted date and/or time inside a semantic `<time>` element.
 * It supports absolute formatting via `TemporalFormat` presets (e.g., `DateTimeFormat.DATE`, `DateTimeFormat.DATE_LONG_TIME`)
 * and relative "time ago" display via the `fromNow` prop. Timezone-aware formatting is handled automatically via the user's preferred timezone.
 *
 * ### When to use
 * Use DateTime whenever you need to display a date, time, or relative timestamp in the UI — for example, "Last seen 3 hours ago" or "Feb 17, 2026".
 *
 * ### When not to use
 * Do not use DateTime for date input or selection — use `DayRangePicker` or `TimeRangeField`.
 * Do not use for duration formatting (e.g., "2h 30m") — use dedicated duration utilities instead.
 *
 * @example Displaying a formatted date
 * ```tsx
 * import { DateTime } from "@trackunit/react-date-and-time-components";
 * import { DateTimeFormat } from "@trackunit/shared-utils";
 *
 * const AssetLastService = () => (
 *   <DateTime value="2026-01-15T10:30:00Z" format={DateTimeFormat.DATE_LONG} />
 * );
 * ```
 * @example Showing relative time
 * ```tsx
 * import { DateTime } from "@trackunit/react-date-and-time-components";
 *
 * const LastSeenLabel = ({ lastSeen }: { lastSeen: Date }) => (
 *   <DateTime value={lastSeen} fromNow />
 * );
 * ```
 * @param {DateTimeProps} props - The props for the DateTime component
 */
export declare const DateTime: ({ value, format, className, style, fromNow, withTitle, titleFormat, timezone: timezoneProp, "data-testid": dataTestId, subtle, ref, ...rest }: DateTimeProps) => import("react/jsx-runtime").JSX.Element;