Crate libtad_rs

Time and Date Rust API

libtad-rs is a Rust library for accessing Time and Date API services.

An access key and a secret key is required to use the API. For more information, see our API Services page.

Cargo features

• “sync-client”: Enabled by default.
• “async-client”: Disabled by default.

“async-client” can be enabled by disabling default features and adding “async-client” as a feature.

Astronomy API

Astro Event Service

Get astronomical events for multiple places and objects:

let client = ServiceClient::new("access_key".into(), "secret_key".into());
let request = AstroEventRequest::new()
    .with_object(AstronomyObjectType::Sun)
    .with_object(AstronomyObjectType::Saturn)
    .with_placeid("3")
    .with_placeid("4")
    .set_startdt(DateTime::from("2021-08-18"));

let response = client.get_astro_events(&request);

Astro Position Service

Get astronomical data for multiple places and objects:

let request = AstroPositionRequest::new()
    .with_object(AstronomyObjectType::Sun)
    .with_placeid("3")
    .with_placeid("norway/oslo")
    .with_interval(DateTime::from("2021-08-18"))
    .with_interval(DateTime::from("2021-08-25"));

let response = client.get_astro_position(&request);

Date Calculator API

Business Date Service

Calculate a business date by adding days to a given date:

let request = BusinessDateRequest::new()
	.set_placeid("norway/stavanger")
	.set_startdt(DateTime::from("2021-04-04"))
	.with_days(4);

let response = client.calculate_business_date(&request);

Calculate a business date by subtracting days to a given date:

let request = BusinessDateRequest::new()
	.set_placeid("norway/stavanger")
	.set_startdt(DateTime::from("2021-04-04"))
	.with_days(4)
	.set_subtraction();

let response = client.calculate_business_date(&request);

Business Duration Service

Calculate duration between two timestamps:

let request = BusinessDurationRequest::new()
	.set_placeid("norway/stavanger")
	.set_startdt(DateTime::from("2021-04-04"))
	.set_enddt(DateTime::from("2021-04-21"));

let response = client.calculate_business_duration(&request);

Holidays API

Get all holidays for a year and one or multiple countries:

let request = HolidaysRequest::new()
	.with_country("no")
	.with_country("us")
	.set_year(2022);

let response = client.get_holidays(&request);

On This Day API

Get events on this day:

let request = OnThisDayRequest::new();

let response = client.get_events_on_this_day(&request);

Get events for a given month and day:

let request = OnThisDayRequest::new()
	.set_month(4)
	.set_day(24);

let response = client.get_events_on_this_day(&request);

Filter events by event type:

let request = OnThisDayRequest::new()
	.with_type(EventType::Events)
	.with_type(EventType::Births);

let response = client.get_events_on_this_day(&request);

Places API

Get all places:

let request = PlacesRequest::new();

let response = client.get_places(&request);

Query for a place:

let request = PlacesRequest::new()
	.set_query("new york")
	.set_qlimit(10);

let response = client.get_places(&request);

Tides API

Get tidal data for one or multiple places:

let request = TidesRequest::new()
	.with_placeid("norway/sola")
	.with_placeid("norway/oslo");

let response = client.get_tidal_data(&request);

Time API

ConvertTime Service

Convert time from a location to multiple locations:

let request = ConvertTimeRequest::new()
    .set_fromid("norway/oslo")
    .with_toid("usa/chicago")
    .with_toid("179")
    .set_datetime(DateTime::from("2021-04-05T16:45:02"));

let response = client.convert_time(&request);

DSTList Service

Get all daylight saving times:

let request = DSTListRequest::new();

let response = client.get_daylight_savings_time(&request);

Get daylight saving times for a specific year:

let request = DSTListRequest::new().set_year(2021);

let response = client.get_daylight_savings_time(&request);

Timeservice Service

Get current time for a place:

let request = TimeserviceRequest::new()
	.set_placeid("norway/oslo");

let response = client.get_current_time(&request);

Modules

models

Service-related models.

service

Available Time and Date services.

Structs

ApiError

Error returned from the API. Error returned from the API.

ServiceClient

Client for accessing the Time and Date APIs.

Enums

Error

Internal error. Internal library errors.