OneScript

DateText

使用原生系统格式显示日期。

在 Apple 平台上使用 SwiftUI 原生日期样式显示 JavaScript Date。

import { Color, DateText, DateTextStyle, Modifier } from "onescript/views"

<DateText
  date={lastUpdatedAt}
  style={DateTextStyle.relative}
  suffix="前更新"
  modifier={Modifier.foregroundStyle(Color.secondary)}
/>
PropType说明
dateDate需要显示的时间点。无效的 Date 会抛出异常。
styleDateTextStyle系统日期样式,详见日期样式。
prefixstring日期前的静态文本。
suffixstring日期后的静态文本。
也支持修饰符,包括 font、fontWeight、foregroundStyle 和 italic。prefix、动态日期和 suffix 会组成同一个文本视图,共享样式和换行行为。

日期样式

枚举值用途系统自动更新
DateTextStyle.relative显示时间差,例如“5 分钟”。是
DateTextStyle.offset显示带方向的时间偏移。是
DateTextStyle.timer显示倒计时或已经过的时间。是
DateTextStyle.date显示固定日期。否
DateTextStyle.time显示固定时间。否

格式、时间单位和本地化由系统决定。DateTextStyle.time 会格式化传入的固定时间点,用于实时时钟时需要通过 Widget Timeline 安排更新。

How is this guide?

最后更新于

本页目录