Yoko.Tool 1.5.5

懒人必备工具箱

💎 主要功能

❄ 雪花Id优化版

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

❄ 哈希加密与验证

❄ 计算经纬度之间的距离

❄ 文件操作

❄ 时间段判断

❄ ·········

💎 使用方法

❄ 包管理器 Install-Package Yoko.Tool -Version 版本号

❄ .Net命令行 dotnet add package Yoko.Tool --version 版本号

💎 雪花ID

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

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

💎 雪花参数设置

❄ WorkerIdBitLength，机器码位长，决定 WorkerId 的最大值，默认值6，取值范围 [1, 19]，实际上有些语言采用 无符号 ushort (uint16) 类型接收该参数，所以最大值是16，如果是采用 有符号 short (int16)，则最大值为15。

❄ 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时，取其为真实最大序列数，一般无需设置，除非多机共享WorkerId分段生成ID（此时还要正确设置最小序列数）。

❄ 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();

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

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

🔍 string 转 bool .ToBool()

🔍 string 转 long .ToLong()

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

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

🔍 字符串 转 时间 .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();

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

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

🔍 手机号验证 .IsPhoneNumber();

🔍 本月有多少天 GetDaysOfMonth()

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

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

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

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

🔍 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());