Date 日期模块

日期相关操作方法。

getPrevMonths(date, num)

获取前 N 个月的日期，包含本月。

参数

参数	类型	必填	说明
date	Date/String	否	指定日期，默认今日
num	Number	否	月数，默认 1

返回值

Array<Date> - 日期数组

示例

Qilin.Date.getPrevMonths()                    // [当前月份的Date]
Qilin.Date.getPrevMonths('2024-06-01', 3)     // [6月, 5月, 4月的Date对象]

---

getNextMonths(date, num)

获取后 N 个月的日期，包含本月。

参数

参数	类型	必填	说明
date	Date/String	否	指定日期，默认今日
num	Number	否	月数，默认 1

返回值

Array<Date> - 日期数组

示例

Qilin.Date.getNextMonths()                    // [当前月份的Date]
Qilin.Date.getNextMonths('2024-06-01', 3)     // [6月, 7月, 8月的Date对象]

---

getDateAfterDays(date, num)

获取指定天数后的日期。

参数

参数	类型	必填	说明
date	Date/String	否	指定日期，默认今日
num	Number	否	天数，默认 0

返回值

Date - 计算后的日期

示例

Qilin.Date.getDateAfterDays()                      // 今日
Qilin.Date.getDateAfterDays('2024-01-01', 7)       // 2024-01-08

---

getDateBeforeDays(date, num)

获取指定天数前的日期。

参数

参数	类型	必填	说明
date	Date/String	否	指定日期，默认今日
num	Number	否	天数，默认 0

返回值

Date - 计算后的日期

示例

Qilin.Date.getDateBeforeDays()                     // 今日
Qilin.Date.getDateBeforeDays('2024-01-08', 7)      // 2024-01-01

---

getDays(year, month)

获取某年某月的总天数。

参数

参数	类型	必填	说明
year	Number	是	年份
month	Number	是	月份（1-12）

返回值

Number - 该月总天数

示例

Qilin.Date.getDays(2024, 1)     // 31
Qilin.Date.getDays(2024, 2)     // 29（2024是闰年）
Qilin.Date.getDays(2023, 2)     // 28

---

formatDate(date, type, separator)

获取指定格式的日期字符串。

参数

参数	类型	必填	说明
date	Date/String	否	日期，默认当前日期
type	String	否	格式类型，默认 yyyy-MM-dd hh:mm:ss
separator	String	否	分隔符，默认 -

支持的格式类型

type	输出示例
yyyy	2024
yyyy-MM	2024-01
yyyy-MM-dd	2024-01-15
yyyy-MM-dd hh	2024-01-15 10
yyyy-MM-dd hh:mm	2024-01-15 10:30
yyyy-MM-dd hh:mm:ss	2024-01-15 10:30:45
MM	01
MM-dd	01-15
dd	15
hh:mm	10:30
hh:mm:ss	10:30:45
chinese	2024年01月15日
chinese hh:mm:ss	2024年01月15日 10:30:45
week	一
weekDetail	星期一

返回值

String - 格式化后的日期字符串

示例

Qilin.Date.formatDate()                                  // '2024-01-15 10:30:45'
Qilin.Date.formatDate(new Date(), 'yyyy-MM-dd')          // '2024-01-15'
Qilin.Date.formatDate('2024-06-01', 'chinese')           // '2024年06月01日'
Qilin.Date.formatDate(new Date(), 'weekDetail')          // '星期一'
Qilin.Date.formatDate(new Date(), 'yyyy/MM/dd', '/')     // '2024/01/15'

---

compareDate(startDate, endDate)

比较两个日期的大小。

参数

参数	类型	必填	说明
startDate	Date/String	是	开始日期
endDate	Date/String	是	结束日期

返回值

Boolean - true 表示结束日期大于开始日期

示例

Qilin.Date.compareDate('2024-01-01', '2024-01-02')     // true
Qilin.Date.compareDate('2024-01-02', '2024-01-01')     // false