terrible-utils 使用文档

说明：在平时编写业务代码是常用到的一些工具类函数
使用方式：
``
import {amount} from 'terrible-utils';
const {parseCentToYuan} = amount;
console.log(parseCentToYuan(200)); //2
`

1. amount

$3

`
/**
*
* @desc 金额分转元
* @param {Number} amount 金额值（单位：分）
* @return {Number}
*/
function parseCentToYuan(amount){
if(typeof amount === "number"){
return (amount/100).toFixed(2);
}else if(typeof amount === "string"){
return (Number(amount)/100).toFixed(2);
}
console.warn('参数错误');
return 0;
}
`

$3

`
/**
*
* @desc 金额分转元
* @param {Number} amount 金额值（单位：分）
* @return {Number}
*/
function parseCentToYuan(amount){
if(typeof amount === "number"){
return (amount/100).toFixed(2);
}else if(typeof amount === "string"){
return (Number(amount)/100).toFixed(2);
}
console.warn('参数错误');
return 0;
}
`

$3

`
/**
*
* @desc 金额元转分
* @param {Number} amount 金额值（单位：元）
* 正常的思路：从右边开始数，每次数3位数字，如果左边还要数字，就添加一个逗号。
* 不过正则表达式总是从左到右开始工作的
* 因此可以进行思路转换：逗号应该加在『左边有数字，右边的数字正好是3的倍数的位置上』。
* @return {Number}
*/

function formatYuan(amount){
amount+="";
return amount.replace(/(\d)(?=(\d{3})+(?!\d))/g,'$1,');
}

`



2. dateTime

$3

`
/**
*
* @desc 时间格式化
* @param {Date} dateTime 时间值
* @param {String} fmtStr 格式 例如）
* 整体思路：根据正则表达是替换fmtStr中的匹配字符 例如以年份替换连续的'Y'
* @return {String} 以字符串的形式返回日期
*/

function dateTimeFormat(dateTime, fmtStr = "YYYY-MM-DD") {
if (!dateTime) dateTime = new Date();
let result = fmtStr;
let dateValueMap = {
Y: dateTime.getFullYear(),
M: dateTime.getMonth() + 1,
D: dateTime.getDate(),
h: dateTime.getHours(),
m: dateTime.getMinutes(),
s: dateTime.getSeconds()
};
let markArray = ['Y', 'M', 'D', 'h', 'm', 's'];
markArray.map(function (item) {
if (~fmtStr.indexOf(item)) {
let rep = new RegExp("(" + item + "+" + ")");
// rep = /(Y+)/
result = result.replace(rep, function (match) {
if (!match)
return "";
// 如果有2个占位符的话就要补0，如：2012-09-09
return match.length === 2 ? dateValueMap[item].toString().padStart(2, "0") : dateValueMap[item];
});
}
});
return result;
}
`

$3


`
/**
*
* @desc 根据初始日期和偏移量获取新的日期
* @param {Number} offset 偏移量
* @param {String} type 偏移的类型 year, month, day, hours, minutes, seconds
* @param {Date} dateTime 初始的时间值
* @return {Date} 以字符串的形式返回日期
*/
function getOffsetDateTime(offset = 0, type="day", dateTime) {
if (!dateTime) dateTime = new Date();
switch (type) {
case 'year':
dateTime.setFullYear(dateTime.getFullYear() + offset);
break;
case 'month':
dateTime.setMonth(dateTime.getMonth() + offset);
break;
case 'day':
dateTime.setDate(dateTime.getDate() + offset);
break;
case 'hours':
dateTime.setHours(dateTime.getHours() + offset);
break;
case 'minutes':
dateTime.setMinutes(dateTime.getMinutes() + offset);
break;
case 'seconds':
dateTime.setSeconds(dateTime.getSeconds() + offset);
break;
default:
break;
}
return dateTime;
}
`

$3

`
/**
* @desc 计算现在时间相对于{targetTime}已过的时间
* @param {Date} targetTime 参考的时间
* @return {String}
*/
function formatPassTime(targetTime) {
// 根据相差的秒数来换算出当前相差的时间
let currentTime = Date.parse(new Date());
let time = currentTime - targetTime;
let isBefore = time > 0;
time = time > 0 ? time : time * -1;
let day = parseInt(time / (1000 60 60 * 24)),
hour = parseInt(time / (1000 60 60)),
min = parseInt(time / (1000 * 60)),
month = parseInt(day / 30),
year = parseInt(month / 12);
if (year) return ${year}年${isBefore ? "前" : "后"};
if (month) return ${month}个月${isBefore ? "前" : "后"};
if (day) return ${day}天${isBefore ? "前" : "后"};
if (hour) return ${hour}小时${isBefore ? "前" : "后"};
if (min) return ${min}分钟${isBefore ? "前" : "后"};
else return ${isBefore ? '刚刚' : '马上'};
}
`

$3

`
/**
*
* @desc 格式化现在距{deadline}的剩余时间
* @param {string} deadline 截止日期 "2012-12-20"
* @return {String}
*/
function formatRemainTime(deadline) {
let startDate = new Date(); //开始时间
let endDate = new Date(deadline); //结束时间
let t = endDate.getTime() - startDate.getTime(); //时间差
let d = 0,
h = 0,
m = 0,
s = 0;
if (t >= 0) {
d = Math.floor(t / 1000 / 3600 / 24);
h = Math.floor(t / 1000 / 60 / 60 % 24);
m = Math.floor(t / 1000 / 60 % 60);
s = Math.floor(t / 1000 % 60);
}
return d + "天 " + h + "小时 " + m + "分钟 " + s + "秒";
}
`

3. device

$3

`
/**
*
* @desc 获取浏览器类型和版本
* @return {String}
*/
function getExplore() {
let sys = {},
ua = navigator.userAgent.toLowerCase(),
s;
(s = ua.match(/rv:([\d.]+)\) like gecko/)) ? sys.ie = s[1]:
(s = ua.match(/msie ([\d\.]+)/)) ? sys.ie = s[1] :
(s = ua.match(/edge\/([\d\.]+)/)) ? sys.edge = s[1] :
(s = ua.match(/firefox\/([\d\.]+)/)) ? sys.firefox = s[1] :
(s = ua.match(/(?:opera|opr).([\d\.]+)/)) ? sys.opera = s[1] :
(s = ua.match(/chrome\/([\d\.]+)/)) ? sys.chrome = s[1] :
(s = ua.match(/version\/([\d\.]+).*safari/)) ? sys.safari = s[1] : 0;
// 根据关系进行判断
if (sys.ie) return ('IE: ' + sys.ie)
if (sys.edge) return ('EDGE: ' + sys.edge)
if (sys.firefox) return ('Firefox: ' + sys.firefox)
if (sys.chrome) return ('Chrome: ' + sys.chrome)
if (sys.opera) return ('Opera: ' + sys.opera)
if (sys.safari) return ('Safari: ' + sys.safari)
return 'Unkonwn'
}
`

$3

`
/**
*
* @desc 获取操作系统类型
* @return {String}
*/
function getOS() {
let userAgent = 'navigator' in window && 'userAgent' in navigator && navigator.userAgent.toLowerCase() || '';
let vendor = 'navigator' in window && 'vendor' in navigator && navigator.vendor.toLowerCase() || '';
let appVersion = 'navigator' in window && 'appVersion' in navigator && navigator.appVersion.toLowerCase() || '';

if (/mac/i.test(appVersion)) return 'MacOSX'
if (/win/i.test(appVersion)) return 'windows'
if (/linux/i.test(appVersion)) return 'linux'
if (/iphone/i.test(userAgent) || /ipad/i.test(userAgent) || /ipod/i.test(userAgent)) 'ios'
if (/android/i.test(userAgent)) return 'android'
if (/win/i.test(appVersion) && /phone/i.test(userAgent)) return 'windowsPhone'
}
`


$3


`
/**
*
* @desc 判断网页是否在微信的webView中运行
* @return {Boolean}
*/
function isWeichat() {
return !!navigator.userAgent.toLowerCase().match(/MicroMessenger/i);
return false;
}
`

$3

`
/**
*
* @desc 判断网页是否在支付宝的webView中运行
* @return {Boolean}
*/
function isAlipay() {
return !!navigator.userAgent.toLowerCase().match(/AlipayClient/i);
}
`

4. keycode

$3

`
let keyCodeMap = {
8: 'Backspace',
9: 'Tab',
13: 'Enter',
16: 'Shift',
17: 'Ctrl',
18: 'Alt',
19: 'Pause',
20: 'Caps Lock',
27: 'Escape',
32: 'Space',
33: 'Page Up',
34: 'Page Down',
35: 'End',
36: 'Home',
37: 'Left',
38: 'Up',
39: 'Right',
40: 'Down',
42: 'Print Screen',
45: 'Insert',
46: 'Delete',

48: '0',
49: '1',
50: '2',
51: '3',
52: '4',
53: '5',
54: '6',
55: '7',
56: '8',
57: '9',

65: 'A',
66: 'B',
67: 'C',
68: 'D',
69: 'E',
70: 'F',
71: 'G',
72: 'H',
73: 'I',
74: 'J',
75: 'K',
76: 'L',
77: 'M',
78: 'N',
79: 'O',
80: 'P',
81: 'Q',
82: 'R',
83: 'S',
84: 'T',
85: 'U',
86: 'V',
87: 'W',
88: 'X',
89: 'Y',
90: 'Z',

91: 'Windows',
93: 'Right Click',

96: 'Numpad 0',
97: 'Numpad 1',
98: 'Numpad 2',
99: 'Numpad 3',
100: 'Numpad 4',
101: 'Numpad 5',
102: 'Numpad 6',
103: 'Numpad 7',
104: 'Numpad 8',
105: 'Numpad 9',
106: 'Numpad *',
107: 'Numpad +',
109: 'Numpad -',
110: 'Numpad .',
111: 'Numpad /',

112: 'F1',
113: 'F2',
114: 'F3',
115: 'F4',
116: 'F5',
117: 'F6',
118: 'F7',
119: 'F8',
120: 'F9',
121: 'F10',
122: 'F11',
123: 'F12',

144: 'Num Lock',
145: 'Scroll Lock',
182: 'My Computer',
183: 'My Calculator',
186: ';',
187: '=',
188: ',',
189: '-',
190: '.',
191: '/',
192: '',
219: '[',
220: '\\',
221: ']',
222: '\''
};
/**
* @desc 根据keycode获得键名
* @param {Number} keycode
* @return {String}
*/
function getKeyName(keycode) {
if (keyCodeMap[keycode]) {
return keyCodeMap[keycode];
} else {
console.log('Unknow Key(Key Code:' + keycode + ')');
return '';
}
};
``
---

5. object

$3

`
/**
*
* @desc 判断obj是否为空
* @param {Object} obj
* @return {Boolean}
*/
function isEmptyObject(obj) {
if (!obj || typeof obj !== 'object' || Array.isArray(obj))
return false;
return !Object.keys(obj).length
}
`

$3

`
/**
* @desc 深拷贝，支持常见类型
* @param {Any} values
*/
function deepClone(values) {
let copy;

// handle the 3 simple types, and null or undefined
if (!values || "object" !== typeof values) return values;

// handle Date
if (values instanceof Date) {
copy = new Date();
copy.setTime(values.getTime());
return copy;
}

// Handle Array
if (values instanceof Array) {
copy = [];
for (let i = 0, len = values.length; i < len; i++) {
copy[i] = deepClone(values[i]);
}
return copy;
}

// Handle Object
if (values instanceof Object) {
copy = {};
for (let attr in values) {
if (values.hasOwnProperty(attr)) copy[attr] = deepClone(values[attr]);
}
return copy;
}

//不能解决有环的问题

throw new Error("Unable to copy values! Its type isn't supported.");
}

`

6.url

$3

`
/**
*
* @desc 根据参数名获取url中对应的参数值
* @param {String} name url 中的参数名
* @param {String} url 链接的url地址 www.hahaha.com?name=abc&value=aaa
* @return {String} g返回链接里的参数值
*/

function getQueryStringRegExp(name,url) {
url = decodeURIComponent(url);
//检测name是否是这个链接的参数，并且只出现一次
if (url.match(new RegExp(^(.*[?|&]${name}=){1}, "i"))){
let result = "";
url.replace(new RegExp([?!&]${name}=(.*)&?),(match,p1)=>{
result = p1;
});
return result;
}
return "";
}
`


$3

`
/**
*
* @desc 获取url中的所有参数以对象的形式返回
* @param {String} url 链接的url地址 www.hahaha.com?name=abc&value=aaa
* @return {Object} 将链接里的参数以键值对的形式返回
*/

function urlParamsToObject(url){
url = url ? url : window.location.href;
var paramsString = url.replace(/(.+)\?/,""),
paramsArray = paramsString.split('&'),
result = {};
paramsArray.map(function(item){
var name = item.replace(/(.+)=.+/,"$1");
var value = window.decodeURIComponent(item.replace(/.+=(.+)/,"$1"));
result[name] = value;
});
return result;
}
`

$3

`
/**
*
* @desc 对象系列化成url参数的形式
* @param {String} domain 域名地址 www.hahaha.com
* @param {Object} data 对象数据{key:value}
* @return {String} 返回一个完整的url地址，即域名加参数
*/

function objectToUrlParams(url,data){
let result = "";
for(let key in data) {
let value = data[key];
if(Object.prototype.toString.call(value) === '[object Object]' || Object.prototype.toString.call(value) === '[object Array]'){
value = JSON.stringify(value);
}
result+=${key}=${value}&;
}
return url + "?" + result.replace(/.$/,"");
}
`

---


7. validate

$3

`
/**
*
* @desc 判断是否为邮箱地址
* @param {String} str
* @return {Boolean}
*/
function isEmail(str) {
return /\w+([-+.]\w+)@\w+([-.]\w+)\.\w+([-.]\w+)*/.test(str);
}
`

$3

`
/**
*
* @desc 判断是否为身份证号
* @param {String|Number} str
* @return {Boolean}
*/
function isIdCard(str) {
return /^(^[1-9]\d{7}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])\d{3}$)|(^[1-9]\d{5}[1-9]\d{3}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])((\d{4})|\d{3}[Xx])$)$/.test(str);
}
`

$3

`
/**
*
* @desc 判断是否为手机号
* @param {String|Number} str
* @return {Boolean}
*/
function isPhoneNum(str) {
return /^(0|86|17951)?(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$/.test(str)
}
`

$3

`
/**
*
* @desc 判断是否为URL地址
* @param {String} str
* @return {Boolean}
*/
function isUrl(str) {
return /[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&//=]*)/i.test(str);
}

`


$3


`
/**
*
* @desc 判断是否为IP地址
* @param {String} str
* @return {Boolean}
*/
function isIP(str) {
return /(?:(?:25[0-5]|2[0-4]\d|[01]?\d?\d)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d?\d)/i.test(str);
}
`

$3

`
/**
*
* @desc 判断是否为金额的格式
* @param {String} str
* @return {Boolean}
*/
function isMoneyAmount(str) {
return /^(([1-9]{1,9})|0)(\.\d{0,2})?$/.test(str);
}
`

其他

$3

`
/**
*
* @desc 函数节流
* @param {Function} fn 执行的目标函数
* @param {Number} delay 节流的的时间间隔
* @param {Number} maxDelay 触发行数执行的最大时间
* @return {Function} 返回节流过的函数
*/
function throttle(fn, delay, maxDelay) {
let timer = null;
let startTime;
return function () {
let context = this, args = arguments, currentTime = +new Date();
//先清理上一次的调用触发（上一次调用触发事件不执行）
clearTimeout(timer);
//如果不存触发时间，那么当前的时间就是触发时间
if (!startTime) {
startTime = currentTime;
}
//如果当前时间-触发时间大于最大的间隔时间（maxDelay），触发一次函数运行函数
if (currentTime - startTime >= maxDelay) {
fn.apply(context, args);
startTime = currentTime;
}
//否则延迟执行
else {
timer = setTimeout(function () {
fn.apply(context, args);
}, delay);
}
};
}
``