/**
 * Copyright 2024, SumUp Ltd.
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
import { type HTMLAttributes } from 'react';
import type { Locale } from '../../util/i18n.js';
export interface TimestampProps extends HTMLAttributes<HTMLTimeElement> {
    /**
     * A datetime in the [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601)
     * format (`YYYY-MM-DDThh:mm:ss.sss[time-zone-id]`). Must include an
     * [IANA time zone identifier](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
     * in brackets.
     */
    datetime: string;
    /**
     * Whether to include the time when displaying the datetime as an absolute
     * value.
     *
     * @default false
     */
    includeTime?: boolean;
    /**
     * The verbosity of the displayed datetime value. Longer formats are easier
     * to read for humans.
     *
     * @default 'short'
     */
    formatStyle?: 'long' | 'short' | 'narrow';
    /**
     * Display the datetime as a relative or absolute value. The auto variant
     * displays a relative value within 30 days of the datetime and an absolute
     * value otherwise.
     *
     * @default 'auto'
     */
    variant?: 'auto' | 'relative' | 'absolute';
    /**
     * One or more [IETF BCP 47](https://en.wikipedia.org/wiki/IETF_language_tag)
     * locale identifiers such as `'de-DE'` or `['GB', 'en-US']`.
     * When passing an array, the first supported locale is used.
     * Defaults to `navigator.language` in supported environments.
     */
    locale?: Locale;
}
/**
 * The Timestamp component displays a human readable date time.
 */
export declare const Timestamp: import("react").ForwardRefExoticComponent<TimestampProps & import("react").RefAttributes<HTMLTimeElement>>;