Skip to content

formatTime

格式化数字千分位(支持正数、负数、小数、零、空值、非法值)

引入版本

0.30.0

Demo

ts
import { formatTime } from '@wyfex/iutils'

/**
 * ================== 默认格式 ==================
 */
console.log(formatTime(new Date())) // 2026-06-09 21:36:17

/**
 * ================== 不补0 ==================
 */
console.log(formatTime(new Date(), '{y}-{m}-{d} {h}:{i}:{s}', false)) // 2026-6-9 22:11:1

/**
 * ================== 13位时间戳 ==================
 */
console.log(formatTime(1735128659000)) // 2025-12-25 15:17:39

/**
 * ================== 10位时间戳 ==================
 */
console.log(formatTime(1735128659)) // 2025-12-25 15:17:39

/**
 * ================== 字符串时间戳 ==================
 */
console.log(formatTime('1735128659')) // 2025-12-25 15:17:39

/**
 * ================== 标准日期字符串 ==================
 */
console.log(formatTime('2025-12-25 15:17:39')) // 2025-12-25 15:17:39

/**
 * ================== 横杠日期(兼容 Safari) ==================
 */
console.log(formatTime('2025-01-01')) // 2025-01-01 00:00:00

/**
 * ================== 自定义格式 ==================
 */
console.log(formatTime(new Date(), '{y}年{m}月{d}日 {h}时{i}分{s}秒')) // 2026年06月09日 21时43分16秒

/**
 * ================== 斜杠日期 ==================
 */
console.log(formatTime(new Date(), '{y}/{m}/{d}')) // 2026/06/09

/**
 * ================== 只取时分秒 ==================
 */
console.log(formatTime(new Date(), '{h}:{i}:{s}')) // 21:36:37

/**
 * ================== 带星期 ==================
 */
console.log(formatTime(new Date(), '{y}-{m}-{d} 星期{a}')) // 2026-06-09 星期二

/**
 * ================== 空值 ==================
 */
console.log(formatTime(null)) // null
console.log(formatTime(undefined)) // null
console.log(formatTime('')) // null

/**
 * ================== 非法日期 ==================
 */
console.log(formatTime('abc')) // null
console.log(formatTime('2025-13-01')) // null

基于 MIT 许可发布