@3r/tool
🏃包含一些常用方法例如对象深克隆/数组交集、并集、差集/二维向量点乘、叉乘/股票KDJ、MACD、RSI、BOLL/验证为空、车牌号、邮箱、身份证、统一社会信用代码、手机号、版本对比/转换日期、星座、身份证解析、字节...持续更新整合
如何使用工具包 ?
👇Vue 小栗子 🐿
1.在工程下执行命令npm i @3r/tool安装依赖包
2.引用对应的工具类import { Maths } from "@3r/tool";
3.使用工具类的方法this.sum = Maths.sum([1, 2, 3]);
<template>
<div>
{{ sum }}
</div>
</template>
<script>
import { Maths } from "@3r/tool";
export default {
data() {
return {
sum: 0,
};
},
async created() {
this.sum = Maths.sum([1, 2, 3]);
},
};
</script>
👇HTML 小栗子 🐿
1.定义一个<script type="module"></script>标签
2.引用对应的工具类import { Maths } from "https://gcore.jsdelivr.net/npm/@3r/tool@0.0.14/index.js"注意版本
3.使用工具类的方法let sum = Maths.sum([1, 2, 3])
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
</head>
<body>
<script type="module">
import { Maths } from "https://gcore.jsdelivr.net/npm/@3r/tool@0.0.14/index.js";
let sum = Maths.sum([1, 2, 3]);
console.log(sum);
</script>
</body>
</html>
Animation 动画模块
包含一些动画的方法.
以下是相关示例:
let offset = 1 / 120 // 执行次数
let interval = 250; // 延迟
let minInterval = 50; // 最小延迟
// 影响我打包速度😅
// 这里不测试了
for (let i = 0; i <= 1; i += offset) {
// 延迟时间
// await waitTime(Math.max(Animation.easeIn(i) * interval, minInterval))
// await waitTime(Math.max(Animation.easeInOut(i) * interval))
// await waitTime(Math.max(Animation.ease(i) * interval))
// await waitTime(Math.max(Animation.easeOut(i) * interval))
// TODO 可以参考相关示例 34.抽奖页面
// https://linyisonger.github.io/H5.Examples/
}
Common 常用模块
包含一些常用的方法.
以下是相关示例:
let a = {
x: 1, y: '2', z: 33333333333333333333333333333, h: function () {
return this.y
},
isPoint: true,
count: NaN,
length: undefined,
child: [
{
x: 2,
}
],
time: new Date(),
test: /\d/g,
color: new Set(),
arrayBuffer: new Int8Array([12, 23, 33]).buffer,
int8Array: new Int8Array([12, 23, 33]),
int16Array: new Int16Array([22, 33, 13]),
int32Array: new Int32Array([22, 22, 13]),
}
a.color.add('222')
let b = cloneDeep(a)
console.log(b);
b.x = 2
b.color.delete('222')
console.log('深克隆', a, b);
let p1 = v2(1, 2)
let p2 = cloneDeep(p1);
p1.x = 2;
console.log(p1, p2, p2.plus(p1));
console.log('执行时间', executionTime(() => { cloneDeep(p1) }));
Convertor 转换模块
包含一些转换的方法.
以下是相关示例:
console.log('社会统一信用代码转换组织机构代码', Convertor.usciToOibc('91411100766237140X'));
// 76623714-0
console.log('日期转换', Convertor.timeFormat(new Date(), 'yyyy年MM月dd日 hh:mm:ss'));
// 例: 2022年12月27日 11:12:35
console.log('千分位处理', Convertor.thousands(10009992.12));
// 10,009,992.12
console.log('文本转base64', Convertor.textToBase64('1234'));
// MTIzNA==
console.log('base64转文本', Convertor.base64ToText('MTIzNA=='));
// 1234
console.log('json对象转换base64', Convertor.jsonToBase64({ a: 1 }));
// eyJhIjoxfQ==
console.log('base64转换json对象', Convertor.base64ToJson('eyJhIjoxfQ=='));
// { a: 1 }
console.log('颜色转换', Convertor.hexToRgb('f2a'));
// rgb(255,34,170)
console.log('颜色转换', Convertor.rgbToHex('rgb(255,34,170)'));
// #ff22aa
console.log('xml输出文本', Convertor.xmlToText('<div>总金额 <span>100,000.00</span></div>'));
// 总金额 100,000.00
console.log('数字转大写人民币', Convertor.numToAmountInWords(102030.00));
// 壹拾万贰仟零叁拾圆整
console.log('数字转中文', Convertor.numToChinese(102030));
// 十万二千三十
console.log('url query 转对象', Convertor.urlQueryToObject('http://example.com/user?id=1&age=2'));
// { "age": "2", "id": "1"
console.log('url object 转 query', Convertor.urlObjectToQuery({ id: 1, age: 3 }));
// '?id=1&age=3'
console.log('蛇形命名法 -> 大驼峰命名法', Convertor.snakeCaseToUpperCamelcase('lower_case_with_underscores'));
// LowerCaseWithUnderscores
console.log('蛇形命名法 -> 小驼峰命名法', Convertor.snakeCaseToLowerCamelcase('lower_case_with_underscores'));
// lowerCaseWithUnderscores
console.log('驼峰命名法 -> 蛇形命名法', Convertor.camelcaseToSnakeCase('LowerCaseWithUnderscores'));
// lower_case_with_underscores
console.log('通过日期获取星座', Convertor.getConstellationByDate('09/14'));
console.log('通过日期获取星座', Convertor.getConstellationByDate(new Date(1997, 2, 14)));
console.log('通过日期获取星座', Convertor.getConstellationByDate(new Date(1997, 2, 14)));
console.log('身份证号解析', '230504199607116664'.citizenIdentificationNumberParse);
console.log('字节转换',Convertor.byteFormat(1099511627776,2));
Map 地图模块
包含一些与地图的方法.
以下是相关示例:
// 引用
// import { Map } from '../index.js'
console.log(`获取地球的半径:${Map.EARTHRADIUS}米`);
console.log(`计算郑州市到杭州市的距离约:${Map.distance({ latitude: 34.16, longitude: 112.42 }, { latitude: 30.3, longitude: 120.2 })}米`)
Market 证券市场
包含一些股票的算法.
以下是相关示例:
// 恒生电子的日k值 ———— https://stock.9fzt.com/ 九方智投 文章篇幅有限通过github访问测试文件
console.log('恒生电子KDJ值', Market.kdj(hundsunDayK.map(format9fzt)).pop())
console.log('恒生电子MACD值', Market.macd(hundsunDayK.map(format9fzt)).pop())
console.log('恒生电子RSI值', Market.rsi(hundsunDayK.map(format9fzt)).pop())
console.log('恒生电子BOLL值', Market.boll(hundsunDayK.map(format9fzt)).pop())
Maths 数学模块
包含一些与数学的方法.
以下是相关示例:
console.log('获取整数12的所有因数', Maths.getFactors(12));
// [
// { a: 1, b: 12 },
// { a: 2, b: 6 },
// { a: 3, b: 4 },
// { a: 4, b: 3 },
// { a: 6, b: 2 }
// ]
console.log('获取整数12的所有因数通过接近程度排序', Maths.getFactorsByApproach(12)); // [ { a: 2, b: 5 }, { a: 5, b: 2 }, { a: 1, b: 10 } ]
// [
// { a: 3, b: 4 },
// { a: 4, b: 3 },
// { a: 2, b: 6 },
// { a: 6, b: 2 },
// { a: 1, b: 12 }
// ]
console.log('数组求和', Maths.sum([1, 2, 3, 4]))
// 10
console.log('判断a与b符号是否相同', Maths.sameSign(1, -1))
// false
console.log('角度转弧度', Maths.degreeToRad(45));
// 0.7853981633974483
console.log('弧度转角度', Maths.radToDegree(0.7853981633974483))
// 45
console.log('交集 A∩B', Maths.intersection([{ x: 1 }, { y: 2 }, { a: 2, z: 3 }, false, true, 1, 3, 5, { a: 2, c: [1, 2] }], [true, 5, 5, { z: 3, a: 2 }]));
// [ { a: 2, z: 3 }, true, 5, 5 ]
console.log('对象是否相等', Maths.equal({ a: 2, z: 3 }, { z: 3, a: 2 }));
// true
console.log('删除重复项', Maths.removeRepeat([{ x: 1, y: 2 }, 2, 3, { y: 2, x: 1 }, 1, 4, 5, 6, 2, 3, 4, 4, 45, 4, 31]));
// [ { x: 1, y: 2 }, 2, 3, 1, 4, 5, 6, 45, 31 ]
console.log('补集', Maths.complementarySet([{ x: 1 }, { y: 2 }, { a: 2, z: 3 }, false, true, 1, 3, 5, { a: 2, c: [1, 2] }], [true, 5, 5, { z: 3, a: 2 }, 8, { z: 3, a: 3 }]))
// [ 8, { z: 3, a: 3 } ]
console.log('并集', Maths.union([1, 23, 4, 556, 14, 124], [123, 452, 231, 1, 14]));
// [ 23, 4, 556, 124, 123, 452, 231, 1, 14]
console.log('数组 通过下标改变位置 从3的位置移到1的位置', Maths.interchange([1, 2, 3, 4], 3, 1));
// [ 1, 4, 2, 3 ]
console.log('阶乘 10!', Maths.iterationFactorial(10))
// 3628800
Randoms 随机模块
包含一些随机的方法.
以下是相关示例:
console.log('获取随机数(整数) [0~10)之间的数', Randoms.getRandomInt(0, 10))
console.log('打乱数组', Randoms.getDisorganizeArray([{ a: 1 }, { b: 1 }, { c: 1 }]));
console.log('随机一个长度为10的只有大小写的字母字符串', Randoms.getRandomStr(10, GetRandomStrEnum.LargeSmall))
console.log('全局唯一标识符(uuid)', Randoms.uuid());
// 数据格式 [{name:string,weight:number}] weight 支持自定义在第二个参数中
console.log('按权重获取随机索引', Randoms.getRandomIndexByWeight(prizes));
Verify 验证模块
包含一些验证的方法.
以下是相关示例:
// 像是
// 就是还有可能不是
// 效率
// 没有太多的逻辑判断
console.log('像是社会统一信用代码', Verify.likeUsci('92230900EUFUTJY536'));
console.log('是否是null或者""', Verify.isNullOrEmpty(''));
console.log('校验是否是11位手机号码', Verify.isPhoneNumber('13062627854'));
console.log('校验是否是固定电话', Verify.isTellPhoneNumber('0371-99882211'))
console.log('是否是邮箱', Verify.isEmail('linyisonger@qq.com'))
// 这个验证校验码是否正确
console.log('是否是统一社会信用代码', Verify.isUnifiedSocialCreditIdentifier('92230900EUFUTJY536'))
console.log('是否是车牌号', Verify.isVehicleNumber('青G04444'))
console.log('像身份证号', Verify.likeIDCardNumber('622924198810193427'));
console.log('是否是身份证号码', Verify.isCitizenIdentificationNumber('622924198810193427'));
console.log('密码规则校验', Verify.passwordRules('abc123', PasswordRuleEnum.SmallNumber, 6, 20));
// 字符串拓展使用
console.log('是否是null或者""', ''.isNullOrEmpty);
console.log('是否是{}', {}.isNullOrEmpty); // 无提示
console.log('像是社会统一信用代码', '92230900EUFUTJY536'.likeUsci);
console.log('校验是否是11位手机号码', '13062627854'.isPhoneNumber);
console.log('校验是否是固定电话', '0371-99882211'.isTellPhoneNumber)
console.log('是否是邮箱', 'linyisonger@qq.com'.isEmail)
// 这个验证校验码是否正确
console.log('是否是统一社会信用代码', '92230900EUFUTJY536'.isUnifiedSocialCreditIdentifier)
console.log('是否是车牌号', '青G04444'.isVehicleNumber)
console.log('像身份证号', '622924198810193427'.likeIDCardNumber);
console.log('是否是身份证号码', '622924198810193427'.isCitizenIdentificationNumber);
console.log('密码规则校验', 'abc123'.passwordRules(PasswordRuleEnum.SmallNumber, 6, 20));
console.log('判断版本是否相等', '1.0.0'.versionComparison('1.0.0'));
Vertor2 二维向量
包含一些与平面坐标系的方法.
以下是相关示例:
console.log('向量相加', v2(1, 1).plus(v2(2, 2)));
// Vertor2 { x: 3, y: 3 }
console.log('向量相减', v2(1, 1).subtract(v2(2, 2)));
// Vertor2 { x: -1, y: -1 }
console.log('向量相乘', v2(2, 3).multiply(v2(2, 2)));
// Vertor2 { x: 4, y: 6 }
console.log('向量相除', v2(2, 3).divide(v2(2, 2)));
// Vertor2 { x: 1, y: 1.5 }
console.log('叉乘', v2(2, 3).multiplicationCross(v2(2, 2)));
// -2
console.log('点乘', v2(2, 3).dotProduct(v2(2, 2)));
// 10
console.log('检测两线段是否交叉', Vector2.checkCross(v2(0, 1), v2(10, 1), v2(1, 0), v2(1, 10)))
// true
console.log('检测p点是否在点p1,p2,p3组成的三角形内', Vector2.checkInTriangle(v2(0, 1), v2(0, 0), v2(2, 0), v2(0, 2)));
// true
console.log('检测p点是否在点p1,p2,p3,p4组成的矩形内', Vector2.checkInRectangle(v2(0, 1), v2(0, 0), v2(1, 0), v2(1, 1), v2(0, 1)));
// true
console.log('p点绕o点旋转angle°', Vector2.rotateAroundPoint(v2(1, 0), v2(0, 0), 90));
// Vector2 { x: 0, y: -1 }
console.log('计算p1到p2两点之间的距离 保留3位小数', Vector2.distance(v2(0, 0), v2(1, 0)));
// 1
console.log('计算两直线的夹角角度', Vector2.includedAngle(v2(1, 0), v2(1, 1)))
// 45
🍻互助互利
如果代码上有什么问题、有什么好的想法欢迎将它提出来👇
https://github.com/linyisonger/3r.Tool/issues/new
感谢我的朋友们给提供需求建议🙇