import type { LocalTimeRange, LuckCycle, SolarDateTimeInfo } from './baziTypes';
/**
 * 用 UTC 时间戳编码民用墙上时间。
 *
 * 这种 Date 只作为跨运行环境传递年月日时分秒的稳定容器，并不代表当地
 * 时区中的真实瞬时点；读取时必须使用 UTC getter。
 */
export declare function createCivilDate(year: number, month: number, day: number, hour?: number, minute?: number, second?: number): Date;
/** 将真实瞬时点转换成八字采用的中国时区民用时间容器。 */
export declare function toChinaCivilDate(referenceDate: Date): Date;
/** 读取 UTC 编码的民用时间容器，仅供内部 civil 入口使用。 */
export declare function fromCivilDate(time: Date): SolarDateTimeInfo;
/**
 * 将中国民用时间字段解析为真实瞬时点；传入 Date 时只复制原瞬时点，不重新解释其时区。
 */
export declare function toNativeDate(time: SolarDateTimeInfo | Date): Date;
/** 将真实瞬时点按固定 UTC+8 还原为八字使用的中国民用时间字段。 */
export declare function fromNativeDate(time: Date): SolarDateTimeInfo;
/** 以真实 UTC 瞬时点建立范围，同时保存对应的中国民用起止字段。 */
export declare function createLocalTimeRange(start: Date, end: Date): LocalTimeRange;
export declare function getLuckCycleTimeRange(cycle: LuckCycle): LocalTimeRange;
export declare function intersectLocalTimeRanges(left: LocalTimeRange, right: LocalTimeRange): LocalTimeRange | null;
export declare function toSolarDateTimeInfo(time: {
    getYear(): number;
    getMonth(): number;
    getDay(): number;
    getHour(): number;
    getMinute(): number;
    getSecond(): number;
}): SolarDateTimeInfo;
export declare function shiftSolarDateTimeYears(time: SolarDateTimeInfo, years: number): SolarDateTimeInfo;
export declare function isCivilDateWithinLuckCycle(cycle: LuckCycle, civilDate: Date): boolean;
/** 按真实瞬时点定位大运；瞬时点按中国时区还原后再与民用运限比较。 */
export declare function isDateWithinLuckCycle(cycle: LuckCycle, referenceDate?: Date): boolean;
export declare function getLuckCycleForCivilDate(cycles: LuckCycle[], civilDate: Date): LuckCycle | null;
export declare function getLuckCycleForDate(cycles: LuckCycle[], referenceDate?: Date): LuckCycle | null;
export declare function formatSolarDateTime(time: SolarDateTimeInfo, withYear?: boolean): string;