UI视图
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)}
/>| Prop | Type | 说明 |
|---|---|---|
date | Date | 需要显示的时间点。无效的 Date 会抛出异常。 |
style | DateTextStyle | 系统日期样式,详见日期样式。 |
prefix | string | 日期前的静态文本。 |
suffix | string | 日期后的静态文本。 |
也支持修饰符,包括 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?
最后更新于