Adding `worldtimeapi` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add worldtimeapi

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

worldtimeapi = "0.5.3"

The worldtimeapi library will be automatically available globally. Read the worldtimeapi library documentation.

Back to the crate overview.

Readme

World Time Wrapper

This is a simple wrapper for the World Time API. This crate is based on the WorldTimeAPI wrapper by Dulatr.

Usage

To use this crate, add worldtimeapi to your Cargo.toml:

[dependencies]
worldtimeapi = "0.5.3"

Then create a client for an endpoint (currently they only offer "ip" and "timezone"):

use std::collections::HashMap;

use worldtimeapi::service::{Client, Endpoint};

#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
   let client = Client::new(Endpoint::Timezone).await?;

   let mut payload = HashMap::new();
   payload.insert("area", "America");
   payload.insert("location", "New_York");

   let result = client.get(payload).await?;
   println!("{}", result.datetime());
   Ok(())
}

To get a list of regions and locations, use the regions method:

use worldtimeapi::service::{Client, Endpoint};

#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
   let client = Client::new(Endpoint::Timezone).await?;
   let regions = client.regions();
   println!("{:?}", regions);
   Ok(())
}

Adding worldtimeapi library as a dependency

Adding `worldtimeapi` library as a dependency