mingyang_text 2022.10.3 → 2023.1.28

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mingyang_text",
-    "version": "2022.10.03",
+    "version": "2023.01.28",
     "description": "MingYang Packet",
     "main": "text.js",
     "scripts": {
@@ -9,11 +9,16 @@
     "keywords": [
         "mingyang",
         "mingyang/text",
-        "text/Bin_with",
+        "text/bin_with",
         "text/end_with",
         "string/format",
+        "datetime/format",
         "timeid",
-        "time/uuid"
+        "timeno",
+        "time/uuid",
+        "base62",
+        "baseX",
+        "any base system"
     ],
     "author": "wang.fu.jun@qq.com,wang.ming.yang@126.com",
     "license": "ISC"

package/text.js

@@ -1,9 +1,9 @@
 
 /**
  * 对【数字】或【字符】进行【左侧补齐】操作
- * @param {"数字或字符"} args_Input 
- * @param {"目标长度"} args_Length 
- * @param {"占位符"} args_PlaceHolder 
+ * @param {"数字或字符"} args_Input
+ * @param {"目标长度"} args_Length
+ * @param {"占位符"} args_PlaceHolder
  */
 function func_StringFormat(args_Input, args_Length, args_PlaceHolder) {
     if (args_Input.toString().length > args_Length) {
@@ -17,10 +17,12 @@ module.exports.do_StringFormat = func_StringFormat;
 
 
 
+
+
 /**
  * 生成随机数
- * @param {"最小值，随机数可以选中最小值"} args_Min 
- * @param {"最大值，随机数不会选中最大值"} args_Max 
+ * @param {"最小值，随机数可以选中最小值"} args_Min
+ * @param {"最大值，随机数不会选中最大值"} args_Max
  */
 function func_Random(args_Min, args_Max) {
     let temp_Val = Math.floor(Math.random() * (args_Max - args_Min)) + args_Min;
@@ -30,9 +32,12 @@ function func_Random(args_Min, args_Max) {
 module.exports.do_Random = func_Random;
 
 
+
+
+
 /**
  * 格式化时间
- * @param {"时间对象，如果传入空，那么将使用当前时间"} args_Date 
+ * @param {"时间对象，如果传入空，那么将使用当前时间"} args_Date
  * @param {"时间格式，例如【yyyy-MM-dd HH:mm:ss.fff】【yyyyMMddHHmmssfff】"} args_Format
  */
 function func_DateTimeToString(args_Date, args_Format) {
@@ -65,11 +70,14 @@ function func_DateTimeToString(args_Date, args_Format) {
 module.exports.do_DateTimeToString = func_DateTimeToString;
 
 
+
+
+
 /**
  * 根据给定的左右标签，提取父串中的子串
- * @param {"输入文本"} args_Text 
- * @param {"左侧标记"} args_Bin 
- * @param {"右侧标记"} args_End 
+ * @param {"输入文本"} args_Text
+ * @param {"左侧标记"} args_Bin
+ * @param {"右侧标记"} args_End
  */
 function func_Filter(args_Text, args_Bin, args_End) {
 
@@ -119,6 +127,10 @@ function func_Filter(args_Text, args_Bin, args_End) {
 }
 module.exports.do_Filter = func_Filter;
 
+
+
+
+
 /**
  * 返回一个36位的时间在左侧的UUID
  */
@@ -189,7 +201,7 @@ module.exports.do_TimeID = func_TimeID;
 
 /**
  * 从【16进制文本】转换为【普通文本】
- * @param {"16进制文本"} args_Hex 
+ * @param {"16进制文本"} args_Hex
  */
 function func_Hex_goto_Plain(args_Hex) {
     let t_Buffer = Buffer.from(args_Hex, 'hex');
@@ -197,10 +209,9 @@ function func_Hex_goto_Plain(args_Hex) {
 }
 module.exports.do_Hex_goto_Plain = func_Hex_goto_Plain;
 
-
 /**
  * 从【普通文本】转换为【16进制文本】
- * @param {"普通文本"} args_Hex 
+ * @param {"普通文本"} args_Hex
  */
 function func_Hex_from_Plain(args_Plain) {
     let t_Buffer = Buffer.from(args_Plain, "utf8");
@@ -210,10 +221,12 @@ module.exports.do_Hex_from_Plain = func_Hex_from_Plain;
 
 
 
+
+
 /**
  * 【主字符串】是否以【从字符串】开头
- * @param {"主字符串"} args_Subject 
- * @param {"从字符串"} args_Compare 
+ * @param {"主字符串"} args_Subject
+ * @param {"从字符串"} args_Compare
  */
 function func_Bin_With(args_Subject, args_Compare) {
     if (args_Subject == null || args_Compare == null) {
@@ -232,12 +245,10 @@ function func_Bin_With(args_Subject, args_Compare) {
 }
 module.exports.do_Bin_With = func_Bin_With;
 
-
-
 /**
  * 【主字符串】是否以【从字符串】结尾
- * @param {"主字符串"} args_Subject 
- * @param {"从字符串"} args_Compare 
+ * @param {"主字符串"} args_Subject
+ * @param {"从字符串"} args_Compare
  */
 function func_End_With(args_Subject, args_Compare) {
     if (args_Subject == null || args_Compare == null) {
@@ -260,11 +271,12 @@ module.exports.do_End_With = func_End_With;
 
 
 
+
 /**
  * KeyValue解码
- * @param {"源字符串"} args_Plain 
- * @param {"分割字符"} args_Split 
- * @param {"等于字符"} args_Equal 
+ * @param {"源字符串"} args_Plain
+ * @param {"分割字符"} args_Split
+ * @param {"等于字符"} args_Equal
  */
 function func_KeyValue_Decode(args_Plain, args_Split, args_Equal) {
 
@@ -285,12 +297,11 @@ function func_KeyValue_Decode(args_Plain, args_Split, args_Equal) {
 }
 module.exports.do_KeyValue_Decode = func_KeyValue_Decode;
 
-
 /**
  * KeyValue编码
- * @param {"源数据包"} args_Datas 
- * @param {"分割字符"} args_Split 
- * @param {"等于字符"} args_Equal 
+ * @param {"源数据包"} args_Datas
+ * @param {"分割字符"} args_Split
+ * @param {"等于字符"} args_Equal
  */
 function func_KeyValue_Encode(args_Datas, args_Split, args_Equal) {
 
@@ -311,4 +322,113 @@ function func_KeyValue_Encode(args_Datas, args_Split, args_Equal) {
 
     return temp_Line;
 }
-module.exports.do_KeyValue_Encode = func_KeyValue_Encode;
+module.exports.do_KeyValue_Encode = func_KeyValue_Encode;
+
+
+
+
+
+/**
+ * 【十进制数字】转成【它进制数字】
+ * @param {"来源十进制数，例如：110715"} args_DecimalNumber
+ * @param {"目标进制基数，例如：62"} args_NumberSystem
+ * @param {"目标记号字符，例如：0123456789ABCDEF"} args_VisibleChar
+ */
+function func_DecimalToOther(args_DecimalNumber, args_NumberSystem, args_VisibleChar = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz") {
+
+    {//通用的验证部分
+        if (args_NumberSystem < 2 || args_NumberSystem > 62) {
+            throw new Error(`the numberSystem must be between 2 and 62`);
+        }
+
+        if (args_VisibleChar.length < args_NumberSystem) {
+            throw new Error(`numberSystem can't above to length of visibleChar`);
+        }
+    }
+
+    if (args_DecimalNumber < 1) {
+        return "0";
+    }
+
+    let temp_Result = "";
+    for (; args_DecimalNumber > 0;) {
+        temp_Result = args_VisibleChar[args_DecimalNumber % args_NumberSystem] + temp_Result;
+        args_DecimalNumber = Math.floor(args_DecimalNumber / args_NumberSystem);
+    }
+
+    return temp_Result;
+}
+module.exports.do_DecimalToOther = func_DecimalToOther;
+
+/**
+ * 【它进制数字】转成【十进制数字】
+ * @param {"来源进制数值，例如：TO80HHL"} args_OtherNumber
+ * @param {"来源进制基数，例如：62"} args_NumberSystem
+ * @param {"来源记号字符，例如：0123456789ABCDEF"} args_VisibleChar
+ */
+function func_DecimalFromOther(args_OtherNumber, args_NumberSystem, args_VisibleChar = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz") {
+
+    {//通用的验证部分
+        if (args_NumberSystem < 2 || args_NumberSystem > 62) {
+            throw new Error(`the numberSystem must be between 2 and 62`);
+        }
+
+        if (args_VisibleChar.length < args_NumberSystem) {
+            throw new Error(`NumberSystem can't above to length of VisibleChar`);
+        }
+    }
+
+    if (args_OtherNumber == null || args_OtherNumber.trim() == "") {
+        return NaN;
+    }
+
+    let temp_Char = "";
+    let temp_Idex = 0;
+    let temp_Result = 0;
+    let temp_Leng = args_OtherNumber.length;
+    for (let i = 0; i < temp_Leng; i++) {
+        temp_Char = args_OtherNumber[i];
+        // console.log(temp_Char);
+        temp_Idex = args_VisibleChar.indexOf(temp_Char);
+        // console.log(temp_Idex);
+        temp_Result += temp_Idex * Math.pow(args_NumberSystem, (temp_Leng - i - 1));
+    }
+
+    return temp_Result;
+}
+module.exports.do_DecimalFromOther = func_DecimalFromOther;
+
+/**
+ * 【10进制数字】转成【62进制数字】
+ * @param {"10进制数"} args_Base10Number
+ */
+function func_Base62Encode(args_Base10Number) {
+    return func_DecimalToOther(args_Base10Number, 62);
+}
+module.exports.do_Base62Encode = func_Base62Encode;
+
+/**
+ * 【62进制数字】转成【10进制数字】
+ * @param {"62进制数"} args_Base62Number
+ */
+function func_Base62Decode(args_Base62Number) {
+    return func_DecimalFromOther(args_Base62Number, 62);
+}
+module.exports.do_Base62Decode = func_Base62Decode;
+
+
+/**
+ * 按照字节长度截取字符串
+ * @param {"原始字符"} args_InputString
+ * @param {"目标长度"} args_ByteLength
+ * @param {"编码方式"} args_Encoding
+*/
+module.exports.do_Byte_Truncate = (args_InputString, args_ByteLength, args_Encoding = "utf8") => {
+    let temp_Description = args_InputString.substring(0, args_ByteLength);
+    let temp_Buffer = Buffer.from(temp_Description, args_Encoding);
+    while (temp_Buffer.length > args_ByteLength) {
+        temp_Description = temp_Description.substring(0, temp_Description.length - 1);
+        temp_Buffer = Buffer.from(temp_Description, args_Encoding);
+    }
+    return temp_Description;
+}