ljs-tools 0.5.19 → 0.5.21
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/index.css +1 -1
- package/index.js +989 -981
- package/index.md +128 -0
- package/index.umd.cjs +8 -8
- package/package.json +1 -1
package/index.md
ADDED
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
# 日期（LJSdate）
|
|
2
|
+
## 说明
|
|
3
|
+
日期（LJSdate），V3JS框架中常用的基础库。
|
|
4
|
+
|
|
5
|
+
### 1.日期格式化
|
|
6
|
+
通过传入的时间戳获取固定格式日期
|
|
7
|
+
|
|
8
|
+
方法：formatTime(time: Date, pattern: string)
|
|
9
|
+
|
|
10
|
+
返回值（String）：返回指定格式的日期。
|
|
11
|
+
##### 示例
|
|
12
|
+
```js
|
|
13
|
+
this.$LJSdate.formatTime(new Date().getTime(), '{y}-{m}-{d} {h}:{i}:{s}') // 返回2021-12-22 09:56:58
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
#### 参数
|
|
17
|
+
|
|
18
|
+
| 参数 | 类型 | 必填项 | 默认值 | 说明 |
|
|
19
|
+
| ----- | :----: | :-----: | ----- | --- |
|
|
20
|
+
| time | Date | √ | | 时间。 |
|
|
21
|
+
| pattern | String | × | {y}-{m}-{d} {h}:{i}:{s} | 出格式，{y}-{m}-{d} {h}:{i}:{s}.{MS}。 |
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
### 2.定制日期
|
|
25
|
+
如前一天、前一个月、前一年
|
|
26
|
+
|
|
27
|
+
方法：customizedDate(time: Date, pattern: string, span: Number)
|
|
28
|
+
|
|
29
|
+
返回值（String）：返回指定格式的指定日期。
|
|
30
|
+
##### 示例
|
|
31
|
+
```js
|
|
32
|
+
// 日
|
|
33
|
+
this.$LJSdate.customizedDate(new Date().getTime(), '{y}-{m}-{d}', -1); // 当前日期：2024-03-28，返回：2024-03-27
|
|
34
|
+
// 月
|
|
35
|
+
this.$LJSdate.customizedDate(new Date().getTime(), '{y}-{m}', -1); // 当前日期：2024-03，返回：2024-02
|
|
36
|
+
// 年
|
|
37
|
+
this.$LJSdate.customizedDate(new Date().getTime(), '{y}', -1); // 当前日期：2024，返回：2023
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
#### 参数
|
|
41
|
+
|
|
42
|
+
| 参数 | 类型 | 必填项 | 默认值 | 说明 |
|
|
43
|
+
| ----- | :----: | :-----: | ----- | --- |
|
|
44
|
+
| time | Date | √ | | 时间。 |
|
|
45
|
+
| pattern | String | √ | | 输出格式，{y}-{m}-{d}，只处理年、月、日数据。
|
|
46
|
+
| span | Number | × | 0 | 步幅，正数为未来日期，负数为过去日期。默认为0。 |
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
### 3.时间处理函数
|
|
50
|
+
传入[开始日期, 结束日期]，期望返回数据为[2020-10-01 00:00:00, 2020-10-01 23:59:59]。
|
|
51
|
+
|
|
52
|
+
方法：dateQjChange(dates: [Date, Date], tag: Number)
|
|
53
|
+
|
|
54
|
+
返回值（String）：返回一个所需规格的[开始日期, 结束日期]。
|
|
55
|
+
##### 示例
|
|
56
|
+
```js
|
|
57
|
+
this.$LJSdate.dateQjChange(["2020-10-01", "2020-10-07"], 1) // 返回["2020-10-01 00:00:00", "2020-10-07 23:59:59"]
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
#### 参数
|
|
61
|
+
|
|
62
|
+
| 参数 | 类型 | 必填项 | 默认值 | 说明 |
|
|
63
|
+
| ----- | :----: | :-----: | ----- | --- |
|
|
64
|
+
| dates | Array | √ | | [开始日期, 结束日期]。 |
|
|
65
|
+
| tag | Number | × | 1 | 1，补时分秒；2，补分秒；3，补秒。 |
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
### 4.根据时间戳返回时长
|
|
69
|
+
我们想要获得这样一个数据：如3小时15分23秒。
|
|
70
|
+
|
|
71
|
+
方法：timeRunDistance({time: Number, showTag: Array, showAll: Boolean, onlyTime: Boolean})
|
|
72
|
+
|
|
73
|
+
返回值（Array）：返回3小时15分23秒。
|
|
74
|
+
##### 示例
|
|
75
|
+
```js
|
|
76
|
+
const runTime = this.$LJSdate.timeRunDistance({
|
|
77
|
+
time: 3600*1000*24 + 3600*1000*2 + 60*1000*4 + 1000* 21 + 876,
|
|
78
|
+
showAll: false
|
|
79
|
+
})
|
|
80
|
+
console.log(runTime); // 1天2小时4分钟21秒876毫秒
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
#### 参数
|
|
84
|
+
|
|
85
|
+
| 参数 | 类型 | 必填项 | 默认值 | 说明 |
|
|
86
|
+
| ----- | :----: | :-----: | ----- | --- |
|
|
87
|
+
| time | Number | √ | | 时长，毫秒数的时长。 |
|
|
88
|
+
| showTag | Array | × | ['天', '小时', '分钟', '秒', '毫秒'] | 展示的标签，['天', '小时', '分钟', '秒', '毫秒']。可根据需要修改时间单位，如：['d', 'h', 'm', 's', 'ms']。。 |
|
|
89
|
+
| showAll | Boolean | × | false | 是否完整展示，默认为false。true：0天2小时4分钟21秒876毫秒；false：2小时4分钟21秒876毫秒。 |
|
|
90
|
+
| onlyTime | Boolean | × | false | 是否只返回时间集合，默认为false，当为true时showAll参数无效。true：[0, 2, 4, 21, 876]；false：2小时4分钟21秒876毫秒。 |
|
|
91
|
+
|
|
92
|
+
|
|
93
|
+
### 5.区间日期
|
|
94
|
+
统一处理方法，常用于默认的区间日期表单。
|
|
95
|
+
|
|
96
|
+
方法：initSearchDate(day: Number, time: Boolean)
|
|
97
|
+
|
|
98
|
+
返回值（Array）：返回默认起止日期。
|
|
99
|
+
##### 示例
|
|
100
|
+
```js
|
|
101
|
+
this.$LJSdate.initSearchDate() // 返回["2020-10-11", "2020-10-20"]
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
#### 参数
|
|
105
|
+
|
|
106
|
+
| 参数 | 类型 | 必填项 | 默认值 | 说明 |
|
|
107
|
+
| ----- | :----: | :-----: | ----- | --- |
|
|
108
|
+
| day | Number | × | 10 | 跨度。 |
|
|
109
|
+
| time | Boolean | × | false | 是否开启时分秒。 |
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
### 6.区间日期2
|
|
113
|
+
获取当月，当年，近n年的区间。
|
|
114
|
+
|
|
115
|
+
方法：initSearchDateQj(type: String, n: Number)
|
|
116
|
+
|
|
117
|
+
返回值（String）：返回默认起止日期。
|
|
118
|
+
##### 示例
|
|
119
|
+
```js
|
|
120
|
+
this.$LJSdate.initSearchDateQj() // 返回["2020-10-01", "2020-10-20"]
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
#### 参数
|
|
124
|
+
|
|
125
|
+
| 参数 | 类型 | 必填项 | 默认值 | 说明 |
|
|
126
|
+
| ----- | :----: | :-----: | ----- | --- |
|
|
127
|
+
| type | String | × | date | 类型：datetime,date,month,year。 |
|
|
128
|
+
| n | Number | × | 0 | type为year时，年的跨度。 |
|