Yoko.Tool 1.6.0

懒人必备工具箱

💎 主要功能

❄ 雪花Id优化版

❄ 字符串拓展/效验(值类型转换、敏感信息掩码、效验、时间操作等)

❄ 值判断

❄ 随机数

❄ 哈希加密与验证

❄ 计算经纬度之间的距离

❄ 文件操作

❄ 时间段判断

❄ ·········

💎 雪花ID

❄ 基于一般雪花算法，优化后生成的ID更短（15位起）、是整数（占用空间最多8字节）、速度更快。

❄ 新增预留位，支持服务器时间回拨。（比如服务器时间回拨1秒，也能自动适应生成临界时间的唯一ID）

💎 雪花参数设置

❄ WorkerIdBitLength，机器码位长，决定 WorkerId 的最大值，默认值6，取值范围 [1, 19]

❄ WorkerId，机器码，最重要参数，无默认值，必须 全局唯一，必须 程序设定，缺省条件（WorkerIdBitLength取默认值）时最大值63，理论最大值 2^WorkerIdBitLength-1

特别提示：如果一台服务器部署多个独立服务，需要为每个服务指定不同的 WorkerId。

❄ SeqBitLength，序列数位长，默认值6，取值范围 [3, 21]（建议不小于4），决定每毫秒基础生成的ID个数。规则要求：WorkerIdBitLength + SeqBitLength 不超过 22。

❄ MinSeqNumber，最小序列数，默认值5，取值范围 [5, MaxSeqNumber]，每毫秒的前5个序列数对应编号0-4是保留位，其中1-4是时间回拨相应预留位，0是手工新值预留位。

❄ MaxSeqNumber，最大序列数，设置范围 [MinSeqNumber, 2^SeqBitLength-1]，默认值0，真实最大序列数取最大值（2^SeqBitLength-1），不为0时，取其为真实最大序列数

❄ BaseTime，基础时间，有默认值（2021年），是毫秒时间戳（是整数，DatetTime类型），作用是：用生成ID时的系统时间与基础时间的差值（毫秒数）作为生成ID的时间戳。

💎 调用示例

1、全局初始化

NetCore/Net5，引用using Yoko.Tool;在Startup.cs(ConfigureServices)中全局注入
//全局初始化IdGenerator
YokoId.SetIdGenerator(new IdGeneratorOptions(1));
// 初始化过程只需全局一次，且必须在第2步之前设置。

2、生成ID

var newId = YokoId.NextId();

💎 字符串拓展/效验：值类型转换、敏感信息掩码、效验、时间操作

🔍 object、string、decimal、double 转 int "123".ToInt32()

🔍 object、string 转 bool .ToBool()

🔍 object、string 转 long .ToLong()

🔍 object、string、decimal、int 转 double .ToDouble()

🔍 object、string 、double、int 转 decimal .ToDecimal()

🔍 object 转 float .ToFloat()

🔍 字符串 转 时间 .ToDateTime()

🔍 分割逗号的字符串为List[]、string[] .SplitCsv()

🔍 分割逗号的字符串为int[] .SplitCsvToInt()

🔍 string数组转int数组 .ToIntList()

🔍 过滤字符串中的/n,/t,/r .ToJsonString()

🔍 替换字符串中的"为'，一般用于写入数据库的json .ToDataBaseString()

🔍 去除图片地址中的不正常字符\n、\ .ToImgString()

🔍 DateTime转换成开始时间00:00:00 .ToStartTime()

🔍 DateTime转换成结束时间23:59:59 .ToEndTime()

🔍 DateTime时间转Unix时间戳（默认精确到毫秒13位） .ToUnixTime();

🔍 DateTime时间转Unix时间戳（默认精确到秒10位） .ToUnixTimeS();

🔍 Unix时间戳转DateTime本地时间（yyyy/MM/dd hh:MM:ss） .ToLocalTime();

🔍 转换成字节数组 .ToByteArray();

🔍 将一个对象转为Json格式字符串 .ToJson();

🔍 将Json转为一个动态类型（运行时解析） .ToDynamic();

🔍 普通字符串敏感信息掩码 .ToMask();

🔍 邮箱敏感信息掩码 .ToMaskEmail();

🔍 本月有多少天 GetDaysOfMonth()

🔍 返回当前日期的星期名称 GetWeekNameOfDay()

🔍 返回时间差（N小时前，N分钟前···） DateDiff()

🔍 计算2个时间差（相差多少年月日时分秒） GetDiffTime()

💎 值判断

🔍 在范围? IsInRange 、 IsInRange 、 IsIn 、IsContainsIn

int num = 50;
if (num.IsInRange(100, 1000)) { }

string value = "a";
if (value.IsIn("a", "b", "c")) { }

🔍 是null或""? IsNullOrEmpty

🔍 有值?(与IsNullOrEmpty相反) IsValuable

🔍 是零? IsZero

🔍 是Int? IsInt

🔍 不是Int? IsNoInt

🔍 是金钱? IsMoney

🔍 是时间? IsDate

🔍 是邮箱? IsDate

🔍 是手机号? IsMobile 、 IsPhoneNumber 、

🔍 是座机? IsTelephone

🔍 是身份证? IsIDcard

🔍 是传真? IsFax

🔍 是适合正则匹配? IsMatch

🔍 是true?false? IsTrue 、 IsFalse

💎 随机数

🔍 按照年月时分秒随机数生成的文件名 YokoRandom.GetFileRndName();

🔍 生成随机数字 YokoRandom.GetFormatedNumeric(1, 100);

🔍 生成随机汉字 YokoRandom.GetRandChinese(6);

🔍 根据指定的样式生成："?"代表一个字符，"#"代表一个一位数字，"*"代表一个字符串或一个一位数字 YokoRandom.GetRandStringByPattern(@"##??*");

🔍 获取指定长度的纯字母随机字符串 YokoRandom.GetRandWord(10);

🔍 获取指定长度的随机字符串 YokoRandom.GetRandomString(10);

💎 一般密码加密解密、验证

🔍 MD5加密 "123456".ToMD5();

🔍 MD5加密加盐 "123456".ToMD5("yoko123");

🔍 MD5两次加密 "123456".ToMD5Double();

🔍 MD5两次加密加盐 "123456".ToMD5Double("yoko123");

🔍 AES加密（密钥） "123456".ToAES();

🔍 AES解密（密钥） "123456".ToAESDecrypt();

🔍 DES加密（密钥） "123456".ToDES();

🔍 DES解密（密钥） "123456".ToDESDecrypt();

🔍 RSA加密解密

//生成RSA密钥对
RsaKey rsaKey = RsaCrypt.GenerateRsaKeys();
//公钥加密
string encrypt = "123456".RSAEncrypt(rsaKey.PublicKey);
//私钥解密
string s = encrypt.RSADecrypt(rsaKey.PrivateKey);

🔍 生成加密密码 "123456".ToPassWord("是否明文");

🔍 验证密码 "目标比对密码".IsTrue("输入的密码");

* MD5+哈希。生成密码由5部分组成

 💧  标识头：cadre
 💧  迭代：64000
 💧  哈希大小：18
 💧  salt值
 💧  哈希值

*  值表现为 ` cadre:64000:18:salt值:哈希值 ` 

💎 经纬度操作

🔍 根据经纬度计算两点间距离 YokoLngLat.GetDistance(x1,y1,x2,y2);

💎 文件操作

🔍 解压rar文件 YokoFile.UnRar('rar文件','解压到哪？')

💎 时间段判断

🔍 判断是否在某个时间段内、是否包含某个时间段、两个时间段是否相交、连接两个时间段

var range = new DateTimeRange("2021-9-3", "2021-9-5".ToDateTime());

//连接两个时间段，结果：2021-9-3~2021-9-6
range.Union("2021-9-4".ToDateTime(), "2021-9-6".ToDateTime()); 

//判断是否在某个时间段内，true
range.In("2021-9-3".ToDateTime(), "2021-9-6".ToDateTime());

//两个时间段是否相交，(true,2021-9-3~2021-9-4)
var (intersected,range2) = range.Intersect("2021-9-4".ToDateTime(), "2021-9-6".ToDateTime());

//判断是否包含某个时间段，true
range.Contains("2021-9-3".ToDateTime(), "2021-9-4".ToDateTime());

·····等等