import type { Result } from '@chzky/core';
import { SerializeError } from '@chzky/core';
import { dayjs } from '../mod.js';
/** ## `time_format` : 时间格式化
内部调用`dayjs.format`实现 , 会校验`时间格式是否合法` , 如不合法则返回错误`SerializeError`
@example Normal
```ts
    // 测试字符串时间格式化
    const result1 = time_format('2023-05-15 10:30:00', DayFormat.FULL)
    assert(result1.is_ok)
    assert.equal(result1.unwrap(), '2023-05-15 10:30:00')
    // 测试数字时间戳格式化
    const timestamp = 1684139400000 // 2023-05-15 10:30:00
    const result2 = time_format(timestamp, DayFormat.DAY)
    assert(result2.is_ok)
    assert.equal(result2.unwrap(), '2023-05-15')
    // 测试Date对象格式化
    const date = new Date('2023-05-15T10:30:00Z')
    const result3 = time_format(date, DayFormat.TIME)
    assert(result3.is_ok)
    // biome-ignore lint/performance/useTopLevelRegex: <>
    assert.match(result3.unwrap(), /18:30:00/) //东八区
    // 测试dayjs对象格式化
    const dayjs_obj = dayjs('2023-05-15 10:30:00')
    const result4 = time_format(dayjs_obj, 'MM-DD')
    assert(result4.is_ok)
    assert.equal(result4.unwrap(), '05-15')
```
@example ErrorFormat
```ts
    const result1 = time_format('invalid-date-string')
    assert.every(
        result1.is_err,
        SerializeError.new(`Time invalid-date-string is not valid`).eq(result1.unwrap_err())
    )
```
@category format
 */
export declare function time_format(time: string | number | Date | ReturnType<typeof dayjs> | null | undefined, fmtopt?: string | 'iso' | 'timestamp'): Result<string, SerializeError>;
//# sourceMappingURL=time.d.ts.map