stoicdreams_timestamp: TimeStamp, StopWatch, DateTime, and Time

About

This project was created after discovering a security vulnerability exists (found using cargo audit) in the commonly used chrono cargo crate as of the then current version 0.4.24. The only actual functionality we wanted at the time was to be able to get a time stamp of the current date and time in UTC for the purposes of saving to a SurrealDB database, and the ability to format our time stamps when displaying in various UI applications.

Goals / Features

• Store times down to the millisecond.
• Store data as 64 bit integer to ensure date storage within the range of humanities lifetime.
• Store data as signed integer to allow potential for supporting BC dates and times.
• Store DateTime values with 0 representing midnight 0 AD instead of the more commonly used Unix Epoch at midnight 1970 AD.
• Default string rendering for date and time is in UTC and follows the ISO 8601 standard.
• Added StopWatch and PreciseTime for tracking precise timings - typically for measuring and tracking performance.

Future Goals / Features

• Implement support for BC dates and times.
• Implement support for 128bit storage - using feature flag to enable.

Getting Started

Update your Cargo.toml file to add the stoicdreams_timestamp crate as a dependency.

[package]
name = "name_of_your_app"
version = "0.1.0"
edition = "2021"

[dependencies]
stoicdreams_timestamp = "0.1.1"

Use prelude for simple access to all structs and methods.

use stoicdreams_timestamp::prelude::*;

Other Recommended Tools

Other Resources

Rust Docs Yew Docs

Author

Erik Gassler - Stoic Dreams - Just a simpleton who likes making stuff with bits and bytes.

Support - Visit Stoic Dreams' GitHub Sponsor page if you would like to provide support to Stoic Dreams.

License

MIT