兼容C端IOS日期时间处理工具

257 阅读4分钟

一、功能

介绍

处理日期和时间,主要包括格式化日期和时间、一些在开发中一些经常对时间处理和判断、公历日期转换农历日期、 解决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返回包含时间信息的 stringV1.0.8
toArray返回将日期转换数组V1.0.8
toJSON返回序列化为 ISO 8601 格式的字符串V1.0.8
toObject返回包含时间信息的 ObjectV1.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

三、方法说明

文档地址www.npmjs.com/package/wh-…