time_duration_api 0.1.4

This crate provides a time/duration API for Rust
Documentation

Time Duration API

The Time Duration Library provides functionalities for handling time and durations in Rust. It offers features to manage specific points in time and durations, along with various formatting options and arithmetic operations.

Features

  • Create Time instances representing specific points in time.
  • Calculate durations between different time instances.
  • Format time according to custom patterns.
  • Easy-to-use API for integrating time-related functionality into your Rust applications.

Installation

Add the following line to your Cargo.toml file under [dependencies]:

time_duration_api = "0.1.4"

Time Duration API

The Time Duration API is a Rust library that provides functionality for working with time and durations. It allows you to easily manage time instances, calculate durations, and format time according to custom patterns.

Features

  • Time Management: Handle specific points in time, including retrieval of the current time.
  • Time Formatting: Format time according to custom date and time formats.
  • Time Zone Support: Format time with different time zones.
  • Duration Arithmetic: Perform arithmetic operations such as addition, subtraction, multiplication, and division on durations.
  • Error Handling: Improved error handling for better usability.
  • Comprehensive Documentation: Clear explanations and examples for easy integration.

Usage

Importing Required Types:

use time_duration_api::time_duration::{Time, CustomDuration};

Creating a Time Instance:

// Create a new Time instance representing the current time
let current_time = Time::now();

Formatting Time:

// Format the current time instance
let formatted_time = current_time.format("%Y-%m-%d %H:%M:%S");
println!("Current time: {}", formatted_time);

Creating Custom Time Instance:

// Create a new Time instance representing a specific time
let custom_time = Time {
    timestamp: std::time::SystemTime::now(),
};

Formatting Custom Time Instance:

// Format the custom time instance
let custom_formatted_time = custom_time.format("%A, %B %d, %Y %H:%M:%S");
println!("Custom time: {}", custom_formatted_time);

Calculating Duration Between Two Time Instances:

// Calculate the duration between two time instances
let duration = custom_time.timestamp.duration_since(current_time.timestamp).unwrap();
println!("Duration: {:?}", duration);

Converting Duration to Seconds:

// Convert the duration to seconds
let seconds = duration.as_secs();
println!("Duration in seconds: {}", seconds);

Example of Duration Arithmetic:

// Example of duration arithmetic
let duration1 = CustomDuration::from_secs(3600);
let duration2 = CustomDuration::from_secs(1800);
let added_duration = duration1.add(&duration2);
println!("Added duration: {:?}", added_duration);

author