Yoko.Tool 1.5.0

懒人必备工具箱

💎 主要功能

❄ 雪花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 "目标".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

💎 哈希加密与验证

• 生成密码由5部分组成 💧 标识头：cadre 💧 迭代：64000 💧 哈希大小：18 💧 salt值 💧 哈希值
• 值常表现为 cadre:64000:18:salt值:哈希值

🔍 生成加密密码 Create(password,IsText);

🔍 验证密码 PassWordIsTrue(password,goodHash,IsText);

💎 根据经纬度计算两点间距离

GetDistance(x1,y1,x2,y2);

💎 文件操作

🔍 解压rar文件

UnRar();