cargo install dtt

然后，您可以通过运行帮助命令来查看可用选项

dtt --help

要求

目前支持的最小 Rust 工具链版本是 Rust 1.60 或更高版本（稳定版）。建议您安装最新的稳定版 Rust。

平台支持

DateTime (DTT) 已在包括各种 Linux 发行版、macOS 和 Windows 在内的广泛平台上得到支持和测试。

文档

ℹ️ 信息：请访问我们的网站获取更多信息。您可以在 docs.rs、lib.rs 和 crates.io 上找到我们的文档。

使用 📖

要在您的项目中使用 DateTime (DTT) 库，请在您的 Cargo.toml 文件中添加以下内容

[dependencies]
dtt = "0.0.6"

在您的 main.rs 文件中添加以下内容

extern crate dtt;
use dtt::*;

然后您可以在应用程序代码中使用这些函数。

示例和测试用例

该库提供了几个示例和测试用例，以帮助您入门。您可以在项目的 examples 和 tests 目录中找到这些。

示例 1：创建一个新的 DateTime 对象并打印它

// Import the DateTime struct and the dtt_print macro
use dtt::DateTime;
use dtt::dtt_print;

#[test]
fn example_1() {
    // Create a new DateTime object and print it
    let now = DateTime::new();
    dtt_print!(now);
}

示例 2：验证各种日期和时间组件的验证方法

// Import the DateTime struct and the validation macros
use dtt::DateTime;
use dtt::{
    is_valid_day,
    is_valid_hour,
    is_valid_minute,
    is_valid_month,
    is_valid_second,
    is_valid_microsecond,
    is_valid_ordinal,
    is_valid_time,
    is_valid_iso_8601
};

// Validate microsecond values
assert!(DateTime::is_valid_microsecond("999999"));
assert!(!DateTime::is_valid_microsecond("1000000"));

// Validate second values
assert!(DateTime::is_valid_second("59"));
assert!(!DateTime::is_valid_second("60"));

// Validate minute values
assert!(DateTime::is_valid_minute("59"));
assert!(!DateTime::is_valid_minute("60"));

// Validate hour values
assert!(DateTime::is_valid_hour("23"));
assert!(!DateTime::is_valid_hour("24"));

// Validate month values
assert!(DateTime::is_valid_month("12"));
assert!(!DateTime::is_valid_month("13"));

// Validate year values
assert!(DateTime::is_valid_ordinal("366"));
assert!(!DateTime::is_valid_ordinal("367"));

// Validate time values
assert!(DateTime::is_valid_time("23:59:59"));
assert!(!DateTime::is_valid_time("24:00:00"));

// Validate ISO 8601 values
assert!(DateTime::is_valid_iso_8601("2023-05-11T17:30:00Z"));
assert!(DateTime::is_valid_iso_8601("2023-05-11T17:30:00+01:00"));

示例 3：验证字符串到 DateTime 的转换

use dtt::DateTime;
use std::str::FromStr;

let date_str = "2022-01-01T12:00:00+01:00";
let mut result: Result<DateTime, dtt::DateTimeError> = DateTime::from_str(date_str);

assert_eq!(result.as_mut().unwrap().iso_8601, date_str);
assert_eq!(result.as_mut().unwrap().year, 2022);
assert_eq!(result.as_mut().unwrap().month, "01");
assert_eq!(result.as_mut().unwrap().day, 1);
assert_eq!(result.as_mut().unwrap().hour, 12);
assert_eq!(result.as_mut().unwrap().minute, 0);
assert_eq!(result.as_mut().unwrap().second, 0);
assert_eq!(result.as_mut().unwrap().offset, "+01:00");
assert_eq!(result.as_mut().unwrap().time, "12:00:00");
assert_eq!(result.as_mut().unwrap().tz, "CET");
assert_eq!(result.as_mut().unwrap().iso_week, 52);
assert_eq!(result.as_mut().unwrap().weekday, "Saturday");
assert_eq!(result.as_mut().unwrap().ordinal, 1);
assert_eq!(result.as_mut().unwrap().microsecond, 0);

语义版本控制策略 🚥

为了使我们的发布周期透明，并努力保持向后兼容性，DateTime (DTT) 遵循 语义版本控制。

许可证 📝

本项目根据 MIT 许可证和 Apache 许可证（版本 2.0）的条款进行许可。

• Apache 许可证，版本 2.0
• MIT 许可证

贡献 🤝

我们欢迎所有想要贡献的人。有关更多信息，请参阅贡献说明。

对本项目的任何形式的贡献（问题、拉取请求等）都必须遵守Rust 的行为准则。

除非您明确表示，否则您有意提交的任何贡献，根据 Apache-2.0 许可证的定义，将根据上述方式双重许可，不附加任何额外条款或条件。

故障排除

如果在使用 DateTime (DTT) 库时遇到任何问题，请检查以下内容

1. 确保您已安装正确的 Rust 工具链，并且它满足最低版本要求。
2. 验证您是否已正确将库添加到项目的依赖项中。
3. 检查文档和示例，以了解您想要使用的特定功能。
4. 如果问题仍然存在，请报告错误，以便项目维护者能够协助您。

致谢 💙

向所有DateTime (DTT) Library的杰出贡献者表示感谢，感谢他们的帮助和支持。

特别感谢Rust Reddit 社区，他们提供了大量有关如何改进此项目的有用建议。