date.js说明

文件说明：日期类操作集合

示例代码：

1 import $date from '@/common/js/date.js'
2 conslog.log('今天是：' + $date.weekDay())

方法列表：

 1 @name $date.isDate(value)
 2 @说明: 判断是否是日期类型，支持字符串日期格式
 3           字符串格式日期类型如下：
 4          yyyy-MM-dd hh:mm:ss | yyyy-MM-dd | hh:mm:ss | hh:mm
 5          yyyy/MM/dd hh:mm:ss | yyyy/MM/dd | hh:mm:ss | hh:mm
 6          yyyy年MM月dd日 hh:mm:ss | yyyy年MM月dd日 | hh:mm:ss | hh:mm
 7 
 8 @param: 
 9     value: [date 或 日期格式字符串]
10 
11 @return: [Boolean]

1 @name $date.now(rule)
2 @说明: 返回当前本机的日期
3 
4 @params:
5     rule [可选] 日期格式，默认值： yyyy-MM-dd hh:mm:ss
6 
7 @return: [String]

1 @name $date.getYear(value) 
2 @说明: 获取日期的年
3 
4 @params:
5     value [可选] 不设置时，表示获取当前日期的年
6 
7 @return: [Number]

1 @name $date.getMonth(value) 
2 @说明: 获取日期的月
3 
4 @params:
5     value [可选] 不设置时，表示获取当前日期的月
6 
7 @return: [Number]

@name $date.getDay(value) 
@说明: 获取日期的日

@params:
    value [可选] 不设置时，表示获取当前日期的日

@return: [Number]

@name $date.getHour(value) 
@说明: 获取日期的时

@params:
    value [可选] 不设置时，表示获取当前日期的时

@return: [Number]

@name $date.getMinutes(value) 
@说明: 获取日期的分钟

@params:
    value [可选] 不设置时，表示获取当前日期的分钟

@return: [Number]

@name $date.getSeconds(value) 
@说明: 获取日期的秒

@params:
    value [可选] 不设置时，表示获取当前日期的秒

@return: [Number]

@name $date.weekDay(value) 
@说明: 获取日期是星期几

@params:
    value [可选] 不设置时，表示获取当前日期

@return: [String]

@name $date.weekYear(value) 
@说明: 获取日期是当年的第几周

@params:
    value [可选] 不设置时，表示获取当前日期

@return: [Number]

@name $date.timestamp(value) 
@说明: 返回日期的时间戳

@params:
    value [可选] 不设置时，表示获取当前日期

@return: [Number]

@name:  $date.deTimestamp(timestamp, timeZone)
@说明: 把时间戳转换为时间

@params:
    timestamp [Number 必需] 时间戳
    timeZone [Number 可选] 时区，默认为北京时区8

@return: [String] 格式 yyyy-MM-dd hh:mm:ss

@name $date.isLeapYear(value) 
@说明: 返回日期所在年是否是闰年

@params:
    value [可选] 不设置时，表示获取当前日期

@return: [Boolean]

@name $date.format(value, rule)
@说明: 格式化输出日期

@params:
    value [Date|String 必需] 日期
    rule [String 必需] 规则，比如： yyyy-MM-dd hh:mm:ss 或 yyyy年MM月dd日 hh时mm分ss秒

@return: [String]

@name $date.changeYear(date, value, rule) 
@说明: 日期算法：在当前日期上进行年增加或减少

@params:
    date [Date|String 必需] 日期
    value [Number 必需] 正值表示加操作，负值表示减操作
    rule [String 必需] 规则，比如： yyyy-MM-dd hh:mm:ss 或 yyyy年MM月dd日 hh时mm分ss秒

@return: [String]

@name $date.changeMonth(date, value, rule) 
@说明: 日期算法：在当前日期上进行月增加或减少

@params:
    date [Date|String 必需] 日期
    value [Number 必需] 正值表示加操作，负值表示减操作
    rule [String 必需] 规则，比如： yyyy-MM-dd hh:mm:ss 或 yyyy年MM月dd日 hh时mm分ss秒

@return: [String]

@name $date.changeDay(date, value, rule) 
@说明: 日期算法：在当前日期上进行天增加或减少

@params:
    date [Date|String 必需] 日期
    value [Number 必需] 正值表示加操作，负值表示减操作
    rule [String 必需] 规则，比如： yyyy-MM-dd hh:mm:ss 或 yyyy年MM月dd日 hh时mm分ss秒

@return: [String]

@name $date.changeHour(date, value, rule) 
@说明: 日期算法：在当前日期上进行小时增加或减少

@params:
    date [Date|String 必需] 日期
    value [Number 必需] 正值表示加操作，负值表示减操作
    rule [String 必需] 规则，比如： yyyy-MM-dd hh:mm:ss 或 yyyy年MM月dd日 hh时mm分ss秒

@return: [String]

@name $date.changeMinutes(date, value, rule) 
@说明: 日期算法：在当前日期上进行分钟增加或减少

@params:
    date [Date|String 必需] 日期
    value [Number 必需] 正值表示加操作，负值表示减操作
    rule [String 必需] 规则，比如： yyyy-MM-dd hh:mm:ss 或 yyyy年MM月dd日 hh时mm分ss秒

@return: [String]

@name $date.changeSeconds(date, value, rule) 
@说明: 日期算法：在当前日期上进行秒增加或减少

@params:
    date [Date|String 必需] 日期
    value [Number 必需] 正值表示加操作，负值表示减操作
    rule [String 必需] 规则，比如： yyyy-MM-dd hh:mm:ss 或 yyyy年MM月dd日 hh时mm分ss秒

@return: [String]

@name $date.betweenYear(startDate, endDate)
@说明: 日期算法：计算两个日期相差的年

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number]

@name $date.betweenMonth(startDate, endDate)
@说明: 日期算法：计算两个日期相差的月

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number]

@name $date.betweenDay(startDate, endDate)
@说明: 日期算法：计算两个日期相差的天

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number]

@name $date.betweenHour(startDate, endDate)
@说明: 日期算法：计算两个日期相差的小时

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number]

@name $date.betweenMinutes(startDate, endDate)
@说明: 日期算法：计算两个日期相差的分钟

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number]

@name $date.betweenSeconds(startDate, endDate)
@说明: 日期算法：计算两个日期相差的秒

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number]

@name $date.compare(startDate, endDate)
@说明: 日期比较。compare(...) 是精确到秒

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number -1|0|1]
    返回0表示两个日期相同
    返回1表示endDate大于startDate
    返回-1表示endDate小于startDate

@name $date.compareYear(startDate, endDate)
@说明: 日期比较。compare(...) 是精确到年

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number -1|0|1]
    返回0表示两个日期年份相同
    返回1表示endDate年份大于startDate
    返回-1表示endDate年份小于startDate

@name $date.compareMonth(startDate, endDate)
@说明: 日期比较。compare(...) 是精确到月

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number -1|0|1]
    返回0表示两个日期年月相同
    返回1表示endDate年月大于startDate
    返回-1表示endDate年月小于startDate

@name $date.compareDay(startDate, endDate)
@说明: 日期比较。compare(...) 是精确到日

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number -1|0|1]
    返回0表示两个日期年月日相同
    返回1表示endDate年月日大于startDate
    返回-1表示endDate年月日小于startDate

@name $date.compareHour(startDate, endDate)
@说明: 日期比较。compare(...) 是精确到时

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number -1|0|1]
    返回0表示两个日期年月日 + 时相同
    返回1表示endDate年月日 + 时大于startDate
    返回-1表示endDate年月日+ 时小于startDate

@name $date.compareMinutes(startDate, endDate)
@说明: 日期比较。compare(...) 是精确到分钟

@params:
    startDate [Date|String 必需] 起始日期
    endDate [Date|String 必需] 结束日期

@return: [Number -1|0|1]
    返回0表示两个日期年月日 + 时分 相同
    返回1表示endDate年月日 + 时分大于startDate
    返回-1表示endDate年月日+ 时分小于startDate

posted @ 2022-09-07 15:28 1024记忆阅读(354) 评论(0) 收藏举报

刷新页面返回顶部