🚀 Quick Start

[dependencies]
ntp-client = { version="0.1", features=["sync-system"] }

Example: Get time from an NTP server and sync systemtime

fn main() -> e_utils::AnyResult<()> {
    let target = "0.pool.ntp.org:123";
    let res = ntp_client::Client::new()
        .target(target)?
        .format(Some("%Y/%m/%d %H:%M:%S"))
        .request()?;
    let res_str = res.get_datetime_str().ok_or("error")?;
    println!("UTC str -> {res_str}");
    let datetime = res.get_datetime_utc().ok_or("get datetime utc")?;
    ntp_client::sync_systemtime(datetime)?;
    Ok(())
}

Example: Get time from an NTP server and convert it to Shanghai time zone

use e_utils::chrono::FixedOffset;

fn main() -> e_utils::AnyResult<()> {
    let target = "0.pool.ntp.org:123";
    let res = ntp_client::Client::new()
        .target(target)?
        .format(Some("%Y/%m/%d %H:%M:%S"))
        .offset(FixedOffset::east_opt(8 * 3600))
        .request()?;
    let res_str = res.get_datetime_str().ok_or("error")?;
    println!("ShangHai str -> {res_str}");
    Ok(())
}

License

LICENSE COPYRIGHT

🤝 Contributing

We welcome contributions in any form!

• Submit an Issue to report bugs or propose new features.
• Submit a Pull Request to improve the code.
• Enhance the project documentation.
• Share your usage experience.

Before submitting a PR, please ensure that:

1. The code complies with the project's specifications.
2. Necessary tests are added.
3. Relevant documentation is updated.

📜 Open Source License

This project is dual-licensed under MIT and LICENSE.