You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
5 years ago | |
|---|---|---|
| .. | ||
| components/uni-dateformat | 5 years ago | |
| changelog.md | 5 years ago | |
| package.json | 5 years ago | |
| readme.md | 5 years ago | |
readme.md
DateFormat 日期格式化
代码块:
uDateformat
日期格式化组件。
安装方式
本组件符合easycom规范,HBuilderX 2.5.5起,只需将本组件导入项目,在页面template中即可直接使用,无需在页面中import和注册components。
如需通过npm方式使用uni-ui组件,另见文档:https://ext.dcloud.net.cn/plugin?id=55
基本用法
在 template 中使用组件
<!-- 一般用法 -->
<uni-dateformat date="2020/10/20 20:20:20"></uni-dateformat>
<!-- 不显示刚刚/马上/xx分钟前 -->
<uni-dateformat date="2020/10/20 20:20:20" :threshold="[0,0]"></uni-dateformat>
API
Dateformat Props
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| date | Object|String|Number | Date.now() | 要格式化的日期对象/日期字符串/时间戳 |
| threshold | Array | [0, 0] | 转化类型阈值 |
| format | String | 'yyyy/MM/dd hh:mm:ss' | 格式字符串 |
| locale | String | zh | 格式化使用的语言,目前支持zh(中文)、en(英文) |
Threshold Options
格式化组件会对时间进行用户友好转化,threshold就是用来控制转化的时间阈值的。
以[60000, 3600000]为例,将传入时间与当前时间差的绝对值记为delta(单位毫秒)
delta < 60000时,时间会被转化为“刚刚|马上”delta >= 60000 && delta < 3600000时,时间会被转化为“xx分钟前|xx分钟后”,如果超过1小时会显示成“xx小时前|xx小时后”,以此类推delta >= 3600000时,会按照format参数传入的格式进行格式化
如果不想转化为“马上|刚刚”可以传入:threshold = "[0,3600000]"。默认值[0,0]既不会转换为“马上|刚刚”也不会转化为“xx分钟前|xx分钟后”
Format Options
format接收字符以及含义如下:
| 字符 | 说明 |
|---|---|
| yyyy | 四位年份 |
| yy | 两位年份 |
| MM | 两位月份(不足两位在前面补0) |
| M | 月份,不自动补0 |
| dd | 两位天(不足两位在前面补0) |
| d | 天,不自动补0 |
| hh | 两位小时(不足两位在前面补0) |
| h | 小时,不自动补0 |
| mm | 两位分钟(不足两位在前面补0) |
| m | 分钟,不自动补0 |
| ss | 两位秒(不足两位在前面补0) |
| s | 秒,不自动补0 |
| SSS | 三位毫秒(不足三位在前面补0) |
| S | 毫秒,不自动补0 |