/**
 * 将数字格式化为指定位数的字符串，不足时前补零
 * @internal
 * @since @ray-js/panel-sdk 1.0.0
 * @param n - 需要格式化的数字
 * @param c - 目标字符串位数，默认为 2
 * @returns 格式化后的字符串，负数会保留负号前缀
 * @example 基础用法
 * ```ts
 * import { utils } from '@ray-js/panel-sdk';
 *
 * const { numberToFixed } = utils;
 *
 * numberToFixed(5);      // '05'
 * numberToFixed(5, 3);   // '005'
 * numberToFixed(-3, 2);  // '-03'
 * numberToFixed(123, 2); // '23'
 * ```
 */
export declare const numberToFixed: (n: number, c?: number) => string;
/**
 * 将秒数解析为 [时, 分, 秒] 的字符串数组
 * @public
 * @since @ray-js/panel-sdk 1.0.0
 * @param t - 总秒数
 * @returns 包含三个两位字符串的数组，分别表示 [小时, 分钟, 秒]
 * @example 基础用法
 * ```ts
 * import { utils } from '@ray-js/panel-sdk';
 *
 * const { parseSecond } = utils;
 *
 * parseSecond(111);     // ['00', '01', '51']
 * parseSecond(3661);    // ['01', '01', '01']
 * parseSecond(3333333); // ['25', '55', '33']
 * ```
 */
export declare const parseSecond: (t: number) => string[];
/**
 * 将秒数格式化为 'HH:MM' 时间字符串
 * @public
 * @since @ray-js/panel-sdk 1.0.0
 * @param second - 总秒数，超过一天（86400 秒）的部分会取余
 * @returns 格式为 'HH:MM' 的时间字符串
 * @example 基础用法
 * ```ts
 * import { utils } from '@ray-js/panel-sdk';
 *
 * const { parseTimer } = utils;
 *
 * parseTimer(111);     // '00:01'
 * parseTimer(3661);    // '01:01'
 * parseTimer(3333333); // '13:55'
 * ```
 */
export declare const parseTimer: (second: number) => string;
/**
 * 将秒数格式化为 'HH:MM:SS' 时间字符串
 * @public
 * @since @ray-js/panel-sdk 1.0.0
 * @param second - 总秒数，超过一天（86400 秒）的部分会取余
 * @returns 格式为 'HH:MM:SS' 的时间字符串
 * @example 基础用法
 * ```ts
 * import { utils } from '@ray-js/panel-sdk';
 *
 * const { parseTimers } = utils;
 *
 * parseTimers(111);     // '00:01:51'
 * parseTimers(3661);    // '01:01:01'
 * parseTimers(3333333); // '13:55:33'
 * ```
 */
export declare const parseTimers: (second: number) => string;
/**
 * 将秒数格式化为 12 小时制时间字符串
 * @public
 * @since @ray-js/panel-sdk 1.0.0
 * @param second - 总秒数，超过一天（86400 秒）的部分会取余
 * @returns 格式为 'HH:MM AM/PM' 的 12 小时制时间字符串
 * @example 基础用法
 * ```ts
 * import { utils } from '@ray-js/panel-sdk';
 *
 * const { parseHour12 } = utils;
 *
 * parseHour12(111);     // '12:01 AM'
 * parseHour12(3333333); // '01:55 PM'
 * parseHour12(43200);   // '12:00 PM'
 * ```
 */
export declare const parseHour12: (second: number) => string;
/**
 * 将时间字符串解析为总秒数
 * @public
 * @since @ray-js/panel-sdk 1.0.0
 * @param timeStr - 冒号分隔的时间字符串，支持 'HH:MM' 或 'HH:MM:SS' 格式
 * @returns 对应的总秒数
 * @example 基础用法
 * ```ts
 * import { utils } from '@ray-js/panel-sdk';
 *
 * const { stringToSecond } = utils;
 *
 * stringToSecond('11:30');    // 690
 * stringToSecond('22:11:30'); // 79890
 * stringToSecond('01:00');    // 60
 * ```
 */
export declare const stringToSecond: (timeStr: string) => number;
/**
 * 将日期字符串转换为 Unix 时间戳（秒）
 * @public
 * @since @ray-js/panel-sdk 1.0.0
 * @param dateString - 日期字符串，格式为 'YYYYMMDD' 或 'YYYYMMDD HH:MM:SS'
 * @returns 对应的 Unix 时间戳（秒，10 位）
 * @example 基础用法
 * ```ts
 * import { utils } from '@ray-js/panel-sdk';
 *
 * const { dateToTimer } = utils;
 *
 * dateToTimer('20110801');          // 1312128000（取决于时区）
 * dateToTimer('20110801 12:11:11'); // 1312171871（取决于时区）
 * ```
 */
export declare const dateToTimer: (dateString: string) => number;
/**
 * 将 Date 对象格式化为指定格式的日期字符串
 * @public
 * @since @ray-js/panel-sdk 1.0.0
 * @param fmt - 格式化模板字符串，支持 y(年)、M(月)、d(日)、h(时)、m(分)、s(秒)、q(季度)、S(毫秒) 占位符
 * @param date - 要格式化的 Date 对象
 * @returns 格式化后的日期字符串
 * @remarks 月(M)、日(d)、小时(h)、分(m)、秒(s)、季度(q) 可用 1-2 个占位符；年(y) 可用 1-4 个占位符；毫秒(S) 只能用 1 个占位符。
 * @example 基础用法
 * ```ts
 * import { utils } from '@ray-js/panel-sdk';
 *
 * const { dateFormat } = utils;
 *
 * const date = new Date('2026-07-02 08:09:04.423');
 * dateFormat('yyyy-MM-dd hh:mm:ss.S', date); // '2026-07-02 08:09:04.423'
 * dateFormat('yyyy-M-d h:m:s.S', date);      // '2026-7-2 8:9:4.423'
 * dateFormat('MM/dd/yyyy', date);             // '07/02/2026'
 * ```
 */
export declare const dateFormat: (fmt: string, date: Date) => string;
/**
 * 获取当前系统时区偏移字符串
 * @public
 * @since @ray-js/panel-sdk 1.0.0
 * @returns 时区偏移字符串，格式为 '+HH:MM' 或 '-HH:MM'
 * @example 基础用法
 * ```ts
 * import { utils } from '@ray-js/panel-sdk';
 *
 * const { timezone } = utils;
 *
 * const tz = timezone(); // 例如 '+08:00'（中国标准时间）
 * ```
 */
export declare const timezone: () => string;