更新记录

1.0.0（2026-07-03） 下载此版本

初始版本

平台兼容性

uni-app(4.0)

zv-dateformat

时间戳格式化组件，支持多种显示模式：日期格式化、周几、相对日期、倒计时、多久之前/之后等。

默认用法

<zv-dateformat :date="timestamp" />

参数说明

mode 显示模式

precision 精度说明

仅 mode="datetime" 时生效。由 Y（年）、M（月）、D（日）、h（时）、m（分）、s（秒）组合而成：

使用示例

<template>
    <view>
        <!-- 完整日期时间（默认） -->
        <zv-dateformat :date="timestamp" />

        <!-- 只显示年月日 -->
        <zv-dateformat :date="timestamp" precision="YMD" />

        <!-- 只显示时分 -->
        <zv-dateformat :date="timestamp" precision="hm" />

        <!-- 显示周几 -->
        <zv-dateformat :date="timestamp" mode="weekday" />

        <!-- 昨天 / 今天 / 明天 -->
        <zv-dateformat :date="timestamp" mode="relativeDay" />

        <!-- 倒计时 -->
        <zv-dateformat :date="timestamp" mode="countdown" />

        <!-- 多久之前 -->
        <zv-dateformat :date="timestamp" mode="ago" />

        <!-- 多久之后 -->
        <zv-dateformat :date="timestamp" mode="after" />
    </view>
</template>

<script>
export default {
    data() {
        return {
            timestamp: Date.now()
        }
    }
}
</script>

补充说明

• ago、after、countdown 模式会每秒自动更新。
• 相对时间不足 1 分钟时显示「刚刚」。
• relativeDay 模式下，前天 / 昨天 / 今天 / 明天 / 后天之外的时间会回退为 YYYY-MM-DD 格式显示。