一、功能
介绍:
处理日期和时间,主要包括格式化日期和时间、一些在开发中一些经常对时间处理和判断、公历日期转换农历日期、 解决C端苹果时间显示兼容问题【实例化参数为时间戳、-横杠、/斜杠日期字符串】
安装:
npm install wh-date
实例化方式:
const Wdate = require('wh-date')
const newData = new Wdate(); // 默认本地时间
const newData = new Wdate(milliseconds/seconds);
const newData = new Wdate(dateString);
用法:
const Wdate = require('wh-date')
const newData = new Wdate() // 系统当前时间
const newData = new Wdate('2022-01-26 10:00:00')
const newData = new Wdate('2022-01-26') // 日期格式1
const newData = new Wdate('2022-01-26 10:10') // 日期格式2
const newData = new Wdate('2022-01-26 10:10:01') // 日期格式3
const newData = new Wdate('2022/01/26 10:10:01') // 日期格式4
const newData = new Wdate(1645586844) // 时间戳10位
const newData = new Wdate(1645586880682) // 时间戳13位
注意: C端苹果手机兼容性问题,方式三:仅支持参数为-横杠2022-02-25 10:02:10、/斜杠2022/02/25 10:02:10表示日期方法
format格式化日期字符说明
传入字符串,更新指定字符串替换相应的值进行显示
| 参数字符串 | 说明 |
|---|---|
| yy | 年 |
| MM | 月 |
| dd | 天 |
| HH | 小时 24小时制 |
| hh | 小时 12小时制 |
| mm | 分钟 |
| ss | 秒 |
| ww | 星期 |
二、方法列表
| 方法 | 功能说明 | 版本 |
|---|---|---|
| 常规方法 | ||
| getYear | 返回年份 | |
| getMonth | 返回月份(1-12) | |
| getDate | 返回月中的第几天(1-31) | |
| getHours | 返回小时(1-12/1-24小时制) | |
| getMinutes | 返回分钟(1-59) | |
| getSeconds | 返回秒(1-59) | |
| getMilliseconds | 返回毫秒(1-999) | |
| getTime | 返回自 1970 年 1 月 1 日午夜以来与指定日期的毫秒数/秒数 | |
| getDay | 返回星期(0-6) | |
| get | 返回年月日时分秒毫秒【根据参数返回】 | |
| 扩展方法 | ||
| getMonthCountDay | 返回当月最后一天数 | |
| getQuarter | 返回季节(1-4) | V1.0.4 |
| getAge | 返回年龄(大于等0的整数) | V1.0.5 |
| getCconstellation | 返回星座 | V1.0.5 |
| getDayOfYear | 返回日期是当年的多少天 | V1.0.6 |
| getAdd | 返回日期相加的新日期 | V1.0.8 |
| getSubtract | 返回日期相减的新日期 | V1.0.8 |
| getDateDiff | 返回日期相差天、时、总小时、分、秒、时间戳 | V1.0.8 |
| getDiffDay | 返回日期相差天数(自然天数) | V1.0.8 |
| 格式化数据方法 | ||
| getTimeFrame | 返回不同时间段特定文案,默认AM(上午0-12点) , PM(下午12-24点) | |
| getAllDate | 返回格式化日期,默认返回yyy-MM-dd格式 | |
| getAllTime | 返回格式化时间,默认返回hh:mm:ss格式 | |
| getFormat | 返回格式化日期,默认返回yyy-MM-dd hh:mm:ss格式 | V1.0.8 |
| getFormatOne | 返回格式化日期: 当天日期:显示hh:ss 7天内:显示星期ww 7天前:显示yyy-MM-dd hh:mm:ss | |
| getFuture | 返回传入时间戳有多少天、时、分、秒、时间戳 | |
| 农历日期方法 | ||
| getLunarZodiac | 返回农历生肖鼠、牛、虎、兔、龙、蛇、马、羊、猴、鸡、狗、猪 | V1.0.5 |
| getLunar | 返回农历日期数字/汉字/干支/润月信息 | V1.0.5 |
| 日期判断方法 | ||
| isValid | 判断日期是否合法 | V1.0.4 |
| isLeapYear | 判断是否是闰年 | |
| isBefore | 判断日期在指定日期前 | V1.0.4 |
| isSame | 判断日期是否相同 | V1.0.4 |
| isAfter | 判断日期在指定日期后 | V1.0.4 |
| isBetween | 判断指定日期是否在传入日期之间 | V1.0.8 |
| isThisYear | 判断是否是当年 | V1.0.6 |
| isThisMonth | 判断是否是当月 | V1.0.6 |
| isThisWeek | 判断是否是当前周 | V1.0.6 |
| isToday | 判断是否是当天 | V1.0.6 |
| isWorkDay | 判断是否是工作日/周末 | V1.0.6 |
| 日期转换方法 | ||
| toString | 返回包含时间信息的 string | V1.0.8 |
| toArray | 返回将日期转换数组 | V1.0.8 |
| toJSON | 返回序列化为 ISO 8601 格式的字符串 | V1.0.8 |
| toObject | 返回包含时间信息的 Object | V1.0.8 |
| 日期设置方法 | ||
| setYear | 设置日期的年份 | V1.0.8 |
| setMonth | 设置日期的月份 | V1.0.8 |
| setDate | 设置日期中月的某一天 | V1.0.8 |
| setHours | 设置日期的小时 | V1.0.8 |
| setMinutes | 设置日期的分钟数 | V1.0.8 |
| setSeconds | 设置日期的秒数 | V1.0.8 |
| setMilliseconds | 设置日期的毫秒数 | V1.0.8 |
| set | 设置年月日时分秒毫秒【根据参数设置】 | V1.0.8 |
| setStartOf | 设置到一个时间的开始 | V1.0.8 |
| setEndOf | 设置到一个时间的结束 | V1.0.8 |