From a165f3223e9362e5cececdc963dab30e8ca8e657 Mon Sep 17 00:00:00 2001
From: Tevin <tingquanren@163.com>
Date: Fri, 07 Mar 2025 13:01:10 +0800
Subject: [PATCH] 知识库文档，改写控制层基类主要方法列表
---
common/Tools.js | 215 ++++++++++++++++++++++++++++++++++++++++++++++-------
1 files changed, 185 insertions(+), 30 deletions(-)
diff --git a/common/Tools.js b/common/Tools.js
index 251ef03..2f0635d 100644
--- a/common/Tools.js
+++ b/common/Tools.js
@@ -6,8 +6,9 @@
import moment from 'moment';
import Taro from '@tarojs/taro';
-export class Tools {
+moment.locale('zh-cn');
+export class Tools {
/**
* 显示消息
* @param msg
@@ -49,8 +50,8 @@
*/
static createGUID() {
return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
- let r = Math.random() * 16 | 0,
- v = c === 'x' ? r : ((r & 0x3) | 0x8);
+ let r = (Math.random() * 16) | 0,
+ v = c === 'x' ? r : (r & 0x3) | 0x8;
return v.toString(16);
});
}
@@ -342,9 +343,13 @@
if (/^\d+$/.test(timestamp)) {
// 8位视为无连接符日期
if (timestamp.length === 8) {
- const day = timestamp.substr(0, 4) + '-' +
- timestamp.substr(4, 2) + '-' + timestamp.substr(6, 2);
- timestamp = (new Date(timestamp)).getTime();
+ const day =
+ timestamp.substr(0, 4) +
+ '-' +
+ timestamp.substr(4, 2) +
+ '-' +
+ timestamp.substr(6, 2);
+ timestamp = new Date(timestamp).getTime();
}
// 超过8位，视为时间戳
else if (timestamp.length > 8) {
@@ -354,19 +359,19 @@
// 日期
else {
try {
- timestamp = (new Date(timestamp)).getTime();
- } catch (e) {
- }
+ timestamp = new Date(timestamp).getTime();
+ } catch (e) {}
}
}
// 数值转换：8位整型日期 转 时间戳
if (timestamp < 9 * 10e6) {
const timeStr = timestamp + '';
- const dateStr = timeStr.slice(0, 4) + '-' + timeStr.slice(4, 6) + '-' + timeStr.slice(6);
+ const dateStr =
+ timeStr.slice(0, 4) + '-' + timeStr.slice(4, 6) + '-' + timeStr.slice(6);
if (type === 'date') {
return dateStr;
}
- timestamp = (new Date(dateStr)).getTime();
+ timestamp = new Date(dateStr).getTime();
}
// 数值转换：时间戳 秒 转 毫秒
else if (timestamp < 9 * 10e8) {
@@ -375,12 +380,22 @@
// 数值转换：14位整型日期 转 时间戳
else if (/^2[012]\d{2}[01]\d[0123]\d[012]\d[0-5]\d[0-5]\d/.test(timestamp + '')) {
const timeStr = timestamp + '';
- const dateStr = timeStr.slice(0, 4) + '-' + timeStr.slice(4, 6) + '-' + timeStr.slice(6, 8)
- + ' ' + timeStr.slice(8, 10) + ':' + timeStr.slice(10, 12) + ':' + timeStr.slice(12, 14);
+ const dateStr =
+ timeStr.slice(0, 4) +
+ '-' +
+ timeStr.slice(4, 6) +
+ '-' +
+ timeStr.slice(6, 8) +
+ ' ' +
+ timeStr.slice(8, 10) +
+ ':' +
+ timeStr.slice(10, 12) +
+ ':' +
+ timeStr.slice(12, 14);
if (type === 'dateTimeFull') {
return dateStr;
}
- timestamp = (new Date(dateStr)).getTime();
+ timestamp = new Date(dateStr).getTime();
}
const curMoment = moment(timestamp);
if (type === 'date') {
@@ -423,16 +438,88 @@
/**
* 数值转换为金钱格式
* @param {Number|String} number
+ * @param {String} [forRead=''] 便于阅读财务金额模式
* @return {string}
*/
- static moneyFormat(number) {
+ static moneyFormat(number, forRead = '') {
if (!number && typeof number !== 'number' && typeof number !== 'string') {
return '';
}
if (typeof number === 'string') {
number = Number(number) || 0;
}
- return number.toFixed(2);
+ if (forRead === 'forRead') {
+ return number.toLocaleString('zh-cn', {
+ minimumFractionDigits: 2,
+ maximumFractionDigits: 2,
+ });
+ } else {
+ return number.toFixed(2);
+ }
+ }
+
+ /**
+ * 数值转换为千分位格式
+ * @param {Number|String} number - 传入的值
+ * @param {String} decimalFormat - 处理小数的方式 - notRetain（不保留小数,有小数时也会去掉小数位），keepTwo（保留两位小数），keepThree（保留三位小数）
+ * @return {string}
+ */
+ static thousandFormat(number, decimalFormat = 'keepTwo') {
+ if (!number && typeof number !== 'number' && typeof number !== 'string') {
+ return '';
+ }
+ // 原始数据
+ let num = number.toString();
+ // 需要进千分位的数,小数点前的数才需要进行千分位计算，即整数位
+ let needThousand = '';
+ // 小数位
+ let decimals = '';
+ // 没有小数位
+ if (!(num.indexOf('.') > -1)) {
+ needThousand = num.toString();
+ if (decimalFormat === 'keepTwo') {
+ decimals = '00';
+ } else if (decimalFormat === 'keepThree') {
+ decimals = '000';
+ }
+ }
+ // 存在小数位时
+ else if (num.indexOf('.') > -1) {
+ needThousand = num.split('.')[0].toString();
+ if (decimalFormat === 'keepTwo') {
+ decimals = Number(num).toFixed(2).split('.')[1] || '';
+ } else if (decimalFormat === 'keepThree') {
+ decimals = Number(num).toFixed(3).split('.')[1] || '';
+ }
+ }
+ // 计算整数位长度
+ let len = needThousand.length;
+ // 如果整数位小于3，直接返回
+ if (len <= 3) {
+ return decimals ? needThousand + '.' + decimals : needThousand;
+ }
+ // 整数位大于3
+ else {
+ // 小数位后的值
+ let temp = '';
+ // 对整数取余
+ let remainder = len % 3;
+ if (decimals) {
+ temp = '.' + decimals;
+ }
+ if (remainder > 0) {
+ // 不是3的整数倍
+ return (
+ needThousand.slice(0, remainder) +
+ ',' +
+ needThousand.slice(remainder, len).match(/\d{3}/g)?.join(',') +
+ temp
+ );
+ } else {
+ // 3的整数倍
+ return needThousand.slice(0, len).match(/\d{3}/g)?.join(',') + temp;
+ }
+ }
}
/**
@@ -492,8 +579,7 @@
let t = 0;
try {
t = num.toString().split('.')[1].length;
- } catch (e) {
- }
+ } catch (e) {}
return t;
}
@@ -514,30 +600,99 @@
* @return {String}
*/
static transWeekIndexToDate(year, week, weekDay) {
- const yearStart = moment([year, 0, 1]);
- const dayLong = 24 * 60 * 60 * 1000;
- const firstWeekLong = (7 - yearStart.day()) * dayLong;
- const weeksLong = (week - 1) * 7 * dayLong;
- const weekDayLong = weekDay * dayLong;
- const dayTimestamp = yearStart.valueOf() + firstWeekLong + weeksLong + weekDayLong;
- return moment(dayTimestamp).format('YYYY-MM-DD');
+ if (weekDay < 1 && weekDay > 7) {
+ return '';
+ }
+ const weekDate = moment(year + '-' + week, 'YYYY-WW');
+ const firstDay = weekDate.startOf('week');
+ return firstDay.add(weekDay - 1, 'day').format('YYYY-MM-DD');
}
+ /**
+ * 防抖函数（一段时间周期内，仅执行最后一次回调）
+ * 当持续触发事件时，只在事件最后一次触发后的一段时间内执行回调函数
+ * 如果在这个时间内再次触发事件，就重新计算时间
+ * @param {Function} fnc
+ * @param {Number} wait
+ * @returns {Function}
+ * @tutorial Tools.debounce(<fnc>, <wait>)(<DebounceKey>)
+ */
+ static debounce(fnc, wait = 200) {
+ return key => {
+ if (!key || !Tools.isString(key)) {
+ throw 'Debounce function need a key!';
+ }
+ const timer = Tools.debounce['dKey-' + key];
+ if (timer) {
+ clearTimeout(timer);
+ }
+ Tools.debounce['dKey-' + key] = setTimeout(fnc, wait);
+ };
+ }
+
+ /**
+ * 节流函数（本段时间内，仅执行第一次回调）
+ * 在一定时间内只能触发一次函数执行
+ * 如果这个时间内再次触发，则忽略，直到下一个时间段再次触发
+ * @param {Function} fnc
+ * @param {Number} wait
+ * @returns {function(key):void}
+ * @tutorial Tools.throttle(<fnc>, <wait>)(<ThrottleKey>)
+ */
+ static throttle(fnc, wait = 200) {
+ return key => {
+ if (!key || !Tools.isString(key)) {
+ throw 'Throttle function need a key!';
+ }
+ const previous = Tools.throttle['tKey-' + key] || 0;
+ const now = Date.now();
+ if (now - previous > wait) {
+ Tools.throttle['tKey-' + key] = now;
+ fnc();
+ }
+ };
+ }
+ /**
+ * 精确保留小数点几位数, 自动补零, 四舍五入
+ * 修复 toFixed 四舍六入五讨论的问题
+ * @param {Number|String} num 数值
+ * @param {Number} [digit=0] 小数点后位数
+ * @returns {String|NaN}
+ */
+ static accFixed(num, digit = 0) {
+ const number = parseFloat(num);
+ if (isNaN(number)) {
+ return NaN;
+ }
+ if (number >= 0) {
+ return (
+ Math.round((number + Number.EPSILON) * Math.pow(10, digit)) / Math.pow(10, digit)
+ ).toFixed(digit);
+ } else {
+ return (
+ '-' +
+ (
+ Math.round((Math.abs(number) + Number.EPSILON) * Math.pow(10, digit)) /
+ Math.pow(10, digit)
+ ).toFixed(digit)
+ );
+ }
+ }
}
// h5 中，实现 rem 转换 px
if (process.env.NODE_ENV === 'development' && process.env.TARO_ENV === 'h5') {
window.rem = val => {
const p1 = {
- x: parseFloat(Taro.pxTransform(10, 750)), y: 10,
+ x: parseFloat(Taro.pxTransform(10, 750)),
+ y: 10,
};
const p2 = {
- x: parseFloat(Taro.pxTransform(1000, 750)), y: 1000,
+ x: parseFloat(Taro.pxTransform(1000, 750)),
+ y: 1000,
};
const value = typeof val === 'number' ? val : parseFloat(val);
- const px = (value - p1.x) * (p2.y - p1.y) / (p2.x - p1.x) + p1.y;
+ const px = ((value - p1.x) * (p2.y - p1.y)) / (p2.x - p1.x) + p1.y;
console.info(Math.round(px) + 'px');
};
}
-
-global.Tools = Tools;
\ No newline at end of file
--
Gitblit v1.9.1