WTIME

WTIME provides a variety of functions for obtaining the current UTC and local times, as well as generating customizable timestamps to suit your needs.

Table of Contents

• Installation
• Changelog
• Features
• Usage
• Documentation
• License
• Contributing
• Author

Installation

Run the following Cargo command in your project directory:

cargo add wtime

Or add wtime to your Cargo.toml file:

[dependencies]

wtime = "MAJOR.MINOR.PATCH" # Replace with the latest version

Changelog

Features

1. Current Time Retrieval

   • UTC and Local Time: WTIME offers seamless access to both current UTC and local times, making it easy to work with time zones and coordinate time-related functionalities.

2. Customizable Timestamps

   • Flexible Formatting: Generate timestamps in various formats to meet your specific requirements, whether for logging, database entries, or user interfaces.
   • Configuration Options: Tailor timestamp outputs to include or exclude specific components (e.g., date, time, time zone) based on your project needs.

3. Time Zone Support

   • Multiple Time Zones: Easily convert between different time zones, allowing for applications that require global time management.
   • Daylight Saving Time Adjustments: Automatic adjustments for daylight saving time ensure that your applications reflect accurate local time.

4. Easy Integration

   • User-Friendly API: The WTIME API is designed with simplicity in mind, allowing developers to implement time-related functions with minimal effort.
   • Comprehensive Documentation: Well-documented functions and examples help users quickly understand how to leverage the crate effectively.

5. High Performance

   • Efficiency: WTIME is optimized for performance, ensuring that time retrieval and manipulation operations are fast and resource-friendly.
   • Lightweight: The crate is designed to be lightweight, minimizing overhead while providing extensive functionality.

6. Unique ID (UID) Generation

   • Timestamp-Based UIDs: Generate unique identifiers derived from either the current UTC (uid_utc) or local server time (uid_local).
   • Alphanumeric Obfuscation: Digits within the timestamp are transformed into letters using a shifting alphabetical mapping, allowing for non-numeric, human-readable IDs.
   • Flexible Formatting: Control the output format by choosing whether to include hyphens as separators or generate a compact, continuous string of letters.
   • Configurable Indexing: Customize the alphabetical shift using an index parameter, providing control over the generated letter sequence while maintaining a time-based ID structure.

Usage

1. CALC

use wtime::calc::{calc_date, calc_week, get_day_name};
use wtime::utc::get_day;

fn main() {
    let (year, month, day) = calc_date(1728933069);
    println!("Date: {}-{}-{}", year, month, day); // Date: 2024-10-14

    let week_number = calc_week((2024, 10, 14));
    println!("Week number: {}", week_number); // 42

    let day = get_day();
    let day_name = get_day_name(1_670_000_000);
    println!("Day name: {}", day_name); // Day name: Friday
    println!("Day name: {}", get_day_name(day));
}

2. LOCAL

use wtime::local::{format_local_ts, local_ts_nanos};
use wtime::utc::utc_ts_nanos;

fn main() {
    let local_timestamp_nanos = local_ts_nanos();
    println!("Current Local Timestamp in Nanoseconds: {}", local_timestamp_nanos);

    let utc_timestamp_nanos = utc_ts_nanos();
    println!("Current UTC Timestamp in Nanoseconds: {}", utc_timestamp_nanos);
    
    let timestamp = format_local_ts();
    println!("Formatted Local Timestamp: {}", timestamp);
}

3. TZ

use wtime::tz::{tz_number, tz_string};

fn main() {
    let offset_number = tz_number();
    println!("Current timezone offset in hours: {}", offset_number);

    let offset_string = tz_string();
    println!("Current timezone offset: {}", offset_string);
}

4. UTC

use wtime::utc::{format_utc_ts, get_day};

fn main() {
    let day = get_day();
    println!("Current day: {}", day);

    let timestamp = format_utc_ts();
    println!("Formatted UTC Timestamp: {}", timestamp);

    // Simulate generating a unique ID with a suffix
    let unique_id_with_suffix = format!("ID-{}-{}", format_utc_ts(), "random_suffix"); // Replace with actual random suffix function
    println!("Generated Unique ID with Suffix: {}", unique_id_with_suffix);

    // Simulate generating a unique ID without a suffix
    let unique_id_without_suffix = format!("ID-{}", format_utc_ts());
    println!("Generated Unique ID without Suffix: {}", unique_id_without_suffix);

    // Simulate generating a blog post UTC timestamp
    let blog_post_timestamp = format!("BlogPost Timestamp: {}", format_utc_ts());
    println!("Generated Blog Post UTC Timestamp: {}", blog_post_timestamp);
}

5. UID

use wtime::uid::{uid_utc, uid_local};

fn main() {
   let uid1 = uid_local(0, true);  // cacf-bc-ai-bf-de-af-hfc-efebaa
   let uid2 = uid_local(1, true);  // dbdg-cd-bj-cg-ef-bg-igd-gefbbb
   let uid3 = uid_utc(2, false);   // ecehdeckdefgchjhehhefcc
   let uid4 = uid_utc(3, false);   // fdfiefdlefghdikifijmedd
   let uid5 = uid_utc(4, false);   // gegjfgemfghiejljgjmkeee
   let uid6 = uid_utc(5, false);   // hfhkghfnghijfkmkhlfilff
   let uid7 = uid_utc(6, false);   // igilhigohijkglnlimihngg
   let uid8 = uid_utc(7, false);   // jhjmijhpijklhmomjnlhnhh
   let uid9 = uid_utc(8, false);   // kiknjkiqjklminpnkooilii
   let uid10 = uid_utc(9, false);  // ljlokljrklmnjoqolpqsnjj
   let uid11 = uid_utc(10, false); // mkmplmkslmnokprpmqttnkk
   let uid12 = uid_utc(11, false); // nlnqmnltmnoplqsqnsnmmll
   let uid13 = uid_utc(12, false); // omornomunopqmrtrotqtmmm
   let uid14 = uid_utc(13, false); // pnpsopnvopqrnsusputwonn
   let uid15 = uid_utc(14, false); // qoqtpqowpqrsotvtqvxqqoo
   let uid16 = uid_utc(15, false); // rpruqrpxqrstpuwurxqvqpp
   let uid17 = uid_utc(16, false); // sqsvrsqyrstuqvxvsyuquqq
   let uid18 = uid_utc(17, false); // trtwstrzstuvrwywtzxwwrr
   let uid19 = uid_utc(18, false); // usuxtusatuvwsxzxuaabxss
   let uid20 = uid_utc(19, false); // vtvyuvtbuvwxtyayvcuvytt
   let uid21 = uid_utc(20, false); // wuwzvwucvwxyuzbzwdxyyuu
   let uid22 = uid_utc(21, false); // xvxawxvdwxyzvacaxeazbvv
   let uid23 = uid_utc(22, false); // ywybxywexyzawbdbyfdzbww
   let uid24 = uid_utc(23, false); // zxzcyzxfyzabxceczggycxx
   let uid25 = uid_utc(24, false); // ayadzaygzabcydfdbyygayy
   let uid26 = uid_utc(25, false); // bzbeabzhabcdzegeczbdbzz
   let uid27 = uid_utc(26, false); // cacfbcaibcdeafhfdadjdaa
   let uid28 = uid_utc(27, false); // dbdgcdbjcdefbgigebgeebb

    println!("{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}\n{}", uid1, uid2, uid3, uid4, uid5, uid6, uid7, uid8, uid9, uid10, uid11, uid12, uid13, uid14, uid15, uid16, uid17, uid18, uid19, uid20, uid21, uid22, uid23, uid24, uid25, uid26, uid27, uid28);
}

Documentation

CALC

LOCAL

TZ

UTC

UID

License

This project is licensed under either of the following licenses:

• MIT License
• Apache License, Version 2.0

You may choose either license for your purposes.

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue for any feature requests or bug reports.

Author

Dr. Montasir Mirghani