快速精确的 Rust 字符串到 Duration 的 gnu 相对时间解析器

目录

• 目录
  • 概述
  • 受众
  • 安装
  • 格式描述
  • 基准测试
  • 许可证

概述

此crate提供了一个简单易用且快速的基于 fundu 的解析器，旨在与 gnu 日期字符串格式中的相对项完全兼容，如其在 文档 中指定。

fundu-gnu 可以使用 RelativeTimeParser::parse 和其他或全局的 parse 方法解析 Rust 字符串

fundu 解析为它自己的 Duration，这是其他 Durations，如 std::time::Duration、chrono::Duration 和 time::Duration 的超集。有关如何轻松处理这些持续时间之间的转换的说明，请参阅 文档！

受众

如果您需要以下内容，这款软件包就适合您：

• 寻找一个快速且精确的与 GNU 兼容的持续时间解析器
• 希望它只需简单配置即可使用，无需进行大量自定义
• 需要相对于儒略格历日期解析持续时间。由于在儒略格历中，年和月并不都是相同长度，因此解析的持续时间是相对于该日期计算的。
• 类似于 GNU 格式
• ...

如果您想要自定义解析器以适应与 gnu 不兼容的格式，那么这款软件包可能不适合您。如果您需要针对您需求的解析器，请参阅主 fundu 项目。

安装

将以下内容添加到 Cargo.toml

[dependencies]
fundu-gnu = "0.3.0"

或者使用以下命令安装：cargo add fundu-gnu。

激活 chrono 或 time 功能将为 chrono::Duration 或 time::Duration 提供 fundu 的 Duration 的 TryFrom 和 SaturatingInto 实现。这些功能还启用了 chrono::DateTime 或 time::OffsetDateTime 的 time::PrimitiveDateTime 的 std::time::Duration 实现。激活 serde 功能允许某些结构体和枚举使用 serde 进行序列化和反序列化。

格式描述

支持的时间单位

• seconds、second、secs、sec
• minutes、minute、mins、min
• hours、hour
• days、day
• weeks、week
• fortnights、fortnight（2 周）
• months、month（模糊）
• years、year（模糊）

模糊时间单位长度不均，取决于特定日期。如果在解析时未提供日期，则假定 UTC +0 的系统时间 now。

支持的数量词

• 下一个 (=1)
• 上一个 (=-1)
• 这个 (=0)
• first（=1）、third（=3）...、twelfth（=12）（注意缺少的第二个，这是一个时间单位）

特殊关键词 yesterday 值为 -1 天，tomorrow 值为 +1 天，today 和 now 每个都代表零时长，也是允许的。这些关键词计为一个完整时长，不接受数字、时间单位或 ago 时间单位后缀。

格式的其余部分摘要

• 时间单位、关键词（包括 ago）和数字均不区分大小写
• 只允许像 "123 days" 这样的数字以及没有指数（如 "3e9 days"）的情况。只有秒时间单位允许分数（如 "1.123456 secs"）
• 在源字符串中，多个时长如 "1sec 2min" 或 "1week2secs" 会累积
• 允许没有数字的时间单位（如 "second"），默认值为 1
• 解析的时长代表源字符串中指定的值（没有四舍五入错误，如浮点运算中可能出现的错误）
• 支持的最大时长（Duration::MAX）为 u64::MAX 秒（18_446_744_073_709_551_615）和 999_999_999 纳秒
• 大于最大时长的解析时长将饱和于最大时长
• 允许负时长，如 "-1min" 或 "1 week ago"
• 任何前导、尾随空白或数字和时间单位之间的空白（如 "1 \n sec"）和多个时长（如 "1week \n 2minutes"）都将被忽略，并遵循 POSIX 对空白的定义，即
  • 空格（' '）
  • 水平制表符（'\x09'）
  • 换行符（'\x0A'）
  • 垂直制表符（'\x0B'）
  • 换页符（'\x0C'）
  • 回车符（'\x0D'）

git clone https://github.com/fundu-rs/fundu.git
cd fundu

cargo bench --package fundu-gnu