/** * XYTime 类 * 提供各种时间格式化和计算方法 */ export declare class XYTime { /** * 默认日期时间格式 */ static readonly DEFAULT_DATETIME_FORMAT = "YYYY-MM-DD HH:mm:ss"; static readonly DEFAULT_DATE_FORMAT = "YYYY-MM-DD"; static readonly DEFAULT_TIME_FORMAT = "HH:mm:ss"; /** * 内部工具方法:填充数字 * @param { number } num - 要填充的数字 * @param { number } length - 填充后的长度 * @param { string } char - 填充字符 * @returns { string } - 填充后的字符串 */ private static padNumber; /** * 通用时间格式化函数 * * @param { Object } options - 可选配置参数 * @param { Date } options.date - 日期对象,默认为当前日期 * @param { string } options.format - 时间格式,支持 'YYYY-MM-DD HH:mm:ss', 'YYYY-MM-DD', 'HH:mm:ss' * @param { string } options.dateSeparator - 日期分隔符 * @param { string } options.timeSeparator - 时间分隔符 * @param { boolean } options.includeSeconds - 是否包含秒 * @param { boolean } options.includeMilliseconds - 是否包含毫秒 * @returns { string } - 格式化的时间字符串 */ static formatTime(options?: { date?: Date; format?: string; dateSeparator?: string; timeSeparator?: string; includeMilliseconds?: boolean; }): string; /** * 获取当前时间 YYYY-MM-DD HH:mm:ss 格式 * * @returns { string } - 当前时间 YYYY-MM-DD HH:mm:ss 格式 */ static getCurrentDateTime(): string; /** * 获取当前时间 HH:mm:ss 格式 * * @returns { string } - 当前时间 HH:mm:ss 格式 */ static getCurrentTime(): string; /** * 计算两个时间的差值 * * @param { Object } options - 配置参数 * @param { number|Date } options.startTime - 开始时间戳或日期对象 * @param { number|Date } options.endTime - 结束时间戳或日期对象,默认为当前时间 * @param { string } options.unit - 返回的单位,可选值:'milliseconds', 'seconds', 'minutes', 'hours', 'days' * @param { number } options.precision - 精度,小数点后的位数 * @returns { number } - 计算后的时间差值 */ static diff(options: { startTime: number | Date; endTime?: number | Date; unit?: 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days'; precision?: number; }): number; /** * 将时间戳格式化为指定格式 * * @param { number } timestamp - 时间戳 * @param { string } format - 格式字符串,支持:YYYY-MM-DD HH:mm:ss * @returns { string } - 格式化后的字符串 */ static formatTimestamp(timestamp: number, format?: string): string; /** * 检查日期是否有效 * * @param { any } date - 要检查的日期 * @returns { boolean } - 日期是否有效 */ static isValidDate(date: any): boolean; }