{\fn黑体\fs20\shad2\2ah82\3ah20\4ah33\fscx95\3ch592001\be1}时间戳 - 集装箱 - - {\fn黑体\fs20\shad2\2ah82\3ah20\4ah33\fscx95\3ch592001\be1} 
说明
psammead-timestamp-container 是反应容器,提供相对和绝对时间,有时区支持-使用时区. 相对时间目前被硬码为英语(例如3分钟前). psammead-timestamp-container 返回单个时间元素.
出口
/utilities - 处理时间戳的出口职能.
何时使用此组件
psammead-timestamp-container 用于需要具有不同时间格式和时区可能的一次性DOM元素.
安装
npm install @bbc/psammead-timestamp-container
道具
| 参数 | 类型 | 需求 | 默认 | 示例 |
|---|---|---|---|---|
| 时间戳 | 数字或字符串 | 对 | 不详 | 1530947227000, (中文(简体) ), '2012-03-08T12:17:24.000Z' |
| 日期时间格式 | 字符串 | 对 | 不详 | YYYY-MM-DD |
| 正态 | 布尔 | 没有 | false | true |
| 格式 | 字符串 | 没有 | null | D MMMM YYYY, HH:mm z |
| 时区 | 字符串 | 没有 | 'Europe/London' | 'Europe/London' |
| 粘贴 | 布尔 | 没有 | true | false |
| 前缀 | 字符串 | 没有 | null | Updated |
| 后缀 | 字符串 | 没有 | null | This is a suffix |
| 脚本 | 对象 | 对 | 不详 | { canon: { groupA: { fontSize: '28', lineHeight: '32',}, groupB: { fontSize: '32', lineHeight: '36', }, groupD: { fontSize: '44', lineHeight: '48', }, }, trafalgar: { groupA: { fontSize: '20', lineHeight: '24', }, groupB: { fontSize: '24', lineHeight: '28', }, groupD: { fontSize: '32', lineHeight: '36', }, }, } |
| 语言 | 字符串 | 没有 | null | en |
| 服务 | 字符串 | 对 | null | news |
| 阿尔特卡伦达 | 对象 | 没有 | null | 见 jalaali 日历在 沙米计数器 例如 |
locale 应该是一个瞬间的地方.
使用量
import { latin } from '@bbc/gel-foundations/scripts';
const WrappingContainer = () => (
<Timestamp
timestamp={1530947227000}
dateTimeFormat="YYYY-MM-DD"
isRelative={false}
format="D MMMM YYYY"
timezone="Europe/London"
prefix="Updated"
suffix="."
script={latin}
locale="en"
/>
);
公用事业
格式期限
import { formatDuration } from '@bbc/psammead-timestamp-container/utilities';
const localisedDuration = formatDuration({ duration: 'PTM30', locale: 'my' });
const customFormatDuration = formatDuration({
duration: 'PTM30',
format: 'mm,ss',
});
| 参数 | 类型 | 需求 | 默认 | 示例 |
|---|---|---|---|---|
| 会期 | 字符串 | 对 | 不详 | PTH1M29S30 由 ISO 8601 标准指定的期限字符串 . |
| 格式 | 字符串 | 没有 | mm:ss,或 h:mm:ss 如果数小时 | mm,ss |
| 语言 | 字符串 | 没有 | en-gb | fr |
本地化运动
import { localisedMoment } from '@bbc/psammead-timestamp-container/utilities';
const localisedMoment = localisedMoment({ locale, timestamp });
| 参数 | 类型 | 需求 | 默认 | 示例 |
|---|---|---|---|---|
| 时间戳 | 数字或字符串 | 对 | 不详 | 1539969006000 (Unix时间戳), '2012-03-08T12:17:24.000Z' (ISO8601字符串) (中文(简体) ) |
| 语言 | 字符串 | 对 | 不详 | fr |
格式Unix 时间戳
import { localiseTimestamp } from '@bbc/psammead-timestamp-container/utilities';
const formattedTime = formatUnixTimestamp({
format,
isRelative,
locale,
timestamp,
timezone,
});
| 参数 | 类型 | 需求 | 默认 | 示例 |
|---|---|---|---|---|
| 格式 | 字符串 | 没有 | "LL, LT Z" (英语) | 'D MMMM YYYY z' 瞬间格式字符串 |
| 正态 | 布尔 | 对 | 不详 | true 当真实时, 格式在相对时间 |
| 语言 | 字符串 | 对 | 不详 | fr 时间 |
| 时间戳 | 数字或字符串 | 对 | 不详 | 1539969006000 (Unix时间戳), '2012-03-08T12:17:24.000Z' (ISO8601字符串) (中文(简体) ) |
| 时区 | 字符串 | 对 | 不详 | 'GMT', (中文(简体) ), 'Asia/Seoul' 见(动态时区文件)[https://momentjs.com/timezone/ 页面存档备份,存于互联网档案馆[ . ] |
无障碍说明
语义的用法 time psammead-timestamp组件中的元素在使用VoiceOver等辅助技术用于iOS时会导致奇怪的行为. 具体来说,它导致了"文本分拆"的行为,前缀中的任何文本都会被读出,但语义中的值 time 元素在读出前需要再刷取.
然而,由于我们大力鼓励使用这种语义元素,并想确保其使用符合 w3C 实例我们觉得妥协是必要的.
路线图
目前,这个软件包只支持英语中的相对时间. 计划通过纳入以多种语言制作相对时间的逻辑,使这套软件更适合在世界服务站点使用.
捐款
Psammead完全开源. 我们感谢任何贡献,无论是新的组件、错误修正还是总体改进。 请参看我们的主要贡献指南,可查阅: psammead 仓库的根。 。 。 .
行为守则
我们欢迎对这项工作的反馈和帮助。 通过参与这个项目,你同意遵守 行为守则请稍候再读一下.
许可证
萨姆米德 Apache 2.0 许可。 。 。 .