/**
 * @file 民用时间统一解析
 * @description 统一处理当地钟表时间、固定 UTC 偏移与 IANA 历史时区，供真太阳时、星盘和天文时间共用。
 */
import { type HistoricalTimezoneEvidence } from './historical-timezone';
export declare const MIN_FIXED_TIMEZONE_HOURS = -12;
export declare const MAX_FIXED_TIMEZONE_HOURS = 14;
export declare const DEFAULT_CHINA_TIMEZONE_HOURS = 8;
export declare const DEFAULT_CHINA_TIME_ZONE_ID = "Asia/Shanghai";
export interface CivilDateTimeParts {
    year: number;
    month: number;
    day: number;
    hour: number;
    minute: number;
    second: number;
}
export interface CivilTimeZoneInput {
    /** 已确认的法定 UTC 偏移；有 IANA 时区时仅用于重复时刻消歧和一致性核验。 */
    timezone?: number;
    /** IANA 历史时区，例如 Asia/Shanghai、America/New_York。 */
    timeZoneId?: string;
}
export interface CivilTimeResolutionInput extends CivilDateTimeParts, CivilTimeZoneInput {
}
export interface CivilTimeResolutionOptions {
    /** 没有提供任何时区时使用的固定偏移；省略表示必须显式提供时区。 */
    defaultTimezone?: number;
}
export interface CivilTimeResolution {
    localTime: CivilDateTimeParts;
    localDateTime: string;
    timezone: number;
    timeZoneId?: string;
    timezoneEvidence?: HistoricalTimezoneEvidence;
    timezoneSource: 'default-fixed-offset' | 'fixed-offset' | 'iana-time-zone';
    utcTimestamp: number;
    utcDateTime: string;
}
export declare function formatCivilDateTime(value: CivilDateTimeParts): string;
/** 将固定 UTC 偏移格式化为 ISO 8601 后缀，保留历史时区可能出现的秒级偏移。 */
export declare function formatFixedTimezoneOffset(timezone: number): string;
export declare function assertFixedTimezoneHours(value: number, label?: string): void;
/**
 * 将真实瞬时点按固定 UTC 偏移读取为当地钟表字段。
 *
 * 这里刻意不经过 IANA 时区规则；需要历史夏令时或其他地区规则时，调用方
 * 应显式提供 timeZoneId 并使用 resolveCivilTime。
 */
export declare function getCivilDateTimeAtFixedOffset(referenceDate: Date, timezone?: number): CivilDateTimeParts;
/**
 * 将当地钟表时间解析为唯一 UTC 时刻。
 *
 * 统一口径：IANA 时区优先；同时提供 timezone 时只用于回拨消歧和一致性核验；
 * 不存在的当地时刻、未消解的重复时刻及固定偏移冲突都拒绝继续计算。
 */
export declare function resolveCivilTime(input: CivilTimeResolutionInput, options?: CivilTimeResolutionOptions): CivilTimeResolution;
/** 按 IANA 当地公历日寻找首个真实瞬时点；固定偏移时沿用严格的 00:00 换算。 */
export declare function resolveCivilDayStart(input: Pick<CivilDateTimeParts, 'year' | 'month' | 'day'> & CivilTimeZoneInput): CivilTimeResolution;
/** 当前真实民用日的结束瞬时，即其后第一个实际存在的当地公历日首点。 */
export declare function resolveCivilDayEnd(input: Pick<CivilDateTimeParts, 'year' | 'month' | 'day'> & CivilTimeZoneInput): CivilTimeResolution;