Skip to content

t-text-date

TextDate 日期文本

组件介绍

t-text-date 是用于格式化显示日期时间的文本组件,支持自定义日期格式,适用于需要显示格式化日期的场景。

平台兼容

HarmonyH5AndroidiOS小程序UTS

基础用法

基础用法参考 demo/text-date/text-date.uvue

vue
<template>
  <view class="text-date-demo">
    <!-- 默认格式 -->
    <t-text-date text="2026-03-20 14:30:00"></t-text-date>
    
    <!-- 自定义格式 -->
    <t-text-date text="2026-03-20 14:30:00" format="yyyy-mm-dd"></t-text-date>
    
    <!-- 仅显示时间 -->
    <t-text-date text="2026-03-20 14:30:00" format="hh:MM:ss"></t-text-date>
    
    <!-- 完整格式 -->
    <t-text-date text="2026-03-20 14:30:00" format="yyyy年mm月dd日 hh时MM分ss秒"></t-text-date>
  </view>
</template>

<style scoped>
.text-date-demo {
  padding: 40rpx;
}
</style>

Props

属性名说明类型默认值
text需要格式化的日期文本string''
format日期格式化格式string'yyyy-mm-dd hh:MM:ss'
path点击组件后跳转的页面路径;为空时仅响应事件string''
hover是否启用点击效果booleantrue
type组件主题类型,可选 infoprimaryerrorwarningsuccessstring''
disabled是否禁用booleanfalse
effect组件显示主题,可选 normaldarklightplainstring''
size组件尺寸,可选 largemediumsmallministring'medium'

日期格式说明

占位符说明示例
yyyy四位年份2026
mm两位月份03
dd两位日期20
hh两位小时(24小时制)14
MM两位分钟30
ss两位秒00

Events

事件名说明回调参数
click点击时触发event
initFinished组件初始化完成触发组件节点信息
touchstart触摸开始时触发event
touchend触摸结束时触发event
touchmove触摸移动时触发event
touchcancel触摸取消时触发event