mirror of
https://gitee.com/baidu/amis.git
synced 2024-12-16 01:40:53 +08:00
4ed784b660
Co-authored-by: liudan21 <liudan21@baidu.com>
4.4 KiB
Executable File
4.4 KiB
Executable File
title | description | type | group | menuName | icon | order |
---|---|---|---|---|---|---|
Date 日期时间 | 0 | ⚙ 组件 | Date | 39 |
用于展示日期
基本使用
{
"type": "page",
"body": {
"type": "date",
"value": "1591326307"
}
}
用作 Field 时
当用在 Table 的列配置 Column、List 的内容、Card 卡片的内容和表单的 Static-XXX 中时,可以设置name
属性,映射同名变量
Table 中的列类型
{
"type": "table",
"data": {
"items": [
{
"id": "1",
"date": "1591326307"
},
{
"id": "2",
"date": "1591321307"
},
{
"id": "3",
"date": "1591322307"
}
]
},
"columns": [
{
"name": "id",
"label": "Id"
},
{
"name": "date",
"label": "日期",
"type": "date"
}
]
}
List 的内容、Card 卡片的内容配置同上
Form 中静态展示
{
"type": "form",
"data": {
"now": "1591322307"
},
"body": [
{
"type": "static-date",
"name": "now",
"label": "日期",
"format": "YYYY年MM月DD日 HH时mm分ss秒"
}
]
}
配置展示格式
例如你想将某一个时间值,以 xxxx年xx月xx日 xx时xx分xx秒
这样的格式输出,那么查找 moment 文档 可知配置格式应为 YYYY年MM月DD日 HH时mm分ss秒
,即:
{
"type": "page",
"data": {
"now": 1586865590
},
"body": {
"type": "date",
"value": "1586865590",
"format": "YYYY年MM月DD日 HH时mm分ss秒"
}
}
配置数据格式
如果你的数据值默认不是X
格式(时间戳秒格式),那么需要配置 valueformat
参数用于解析当前时间值,比如毫秒是配置 "valueformat": "x"
。
除此之外还支持各种自定义日期格式,例如下面value
值为:"2020/4/14 19:59:50"
,查阅 moment 文档 可知,需要配置数据格式为 "YYYY/MM/DD HH:mm:ss"
,然后我们配置输出格式format
,输出指定格式日期:
{
"type": "page",
"body": {
"type": "date",
"value": "2020/4/14 19:59:50",
"valueFormat": "YYYY/MM/DD HH:mm:ss",
"format": "YYYY年MM月DD日 HH时mm分ss秒"
}
}
属性表
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
type | string |
如果在 Table、Card 和 List 中,为"date" ;在 Form 中用作静态展示,为"static-date" |
|
className | string |
外层 CSS 类名 | |
value | string |
显示的日期数值 | |
name | string |
在其他组件中,时,用作变量映射 | |
placeholder | string |
- |
占位内容 |
format | string |
YYYY-MM-DD |
展示格式, 更多格式类型请参考 文档 |
valueFormat | string |
X |
数据格式,默认为时间戳。更多格式类型请参考 文档 |
fromNow | boolean |
false |
是否显示相对当前的时间描述,比如: 11小时前、3天前、1年前等,fromNow 为 true 时,format 不生效。 |
updateFrequency | number |
60000 |
更新频率, 默认为1分钟 |