函数: formatTime()

function formatTime(num?, format?): string;

定义于: date.ts:30

将时间戳 / 时间字符串 / Date 按指定模板格式化为「年月日时分秒」字符串。

参数

参数	类型	默认值	描述
num	string | number | Date	...	待格式化的时间，默认取当前时间 Date.now()。 支持三种形式： - number：时间戳，自动兼容 10 位（秒）与 13 位（毫秒）； - string：可被 new Date() 解析的时间字符串； - Date：时间对象。
format	string	''	格式模板，默认 'YYYY-mm-dd HH:MM:SS'。占位符含义： Y 年、m 月、d 日、H 时、M 分、S 秒。 同一字符重复多次会补零到对应长度（如 mm → 08），单个字符不补零（如 m → 8）； 非占位符字符原样保留，因此只需替换连接符即可自定义样式，如 'YYYY年mm月dd日 HH时MM分SS秒'。

返回值

string

格式化后的时间字符串；传入无法识别的类型时返回 ''。

备注

时间戳会根据字符串长度自动判断单位：10 位视为秒并乘以 1000，13 位视为毫秒。

示例

// js 获取的时间戳一般是 13 位，PHP 一般是 10 位
formatTime(1472048779952) // => '2016-08-24 22:26:19'（默认格式）
formatTime(1472048779952, 'YYYY年mm月dd日') // => '2016年08月24日'
formatTime(new Date(2016, 7, 24)) // => '2016-08-24 00:00:00'
formatTime(null as any) // => ''

参见

timeAgo 若只需「x分钟前」这类相对时间描述。