stoicdreams_timestamp
| Crates.io | stoicdreams_timestamp |
| lib.rs | stoicdreams_timestamp |
| version | 0.1.2 |
| created_at | 2023-05-29 15:05:09.181634+00 |
| updated_at | 2024-05-27 00:10:00.196163+00 |
| description | Lightweight Rust library for storing and managing timestamps, dates, and times. |
| homepage | https://www.stoicdreams.com |
| repository | https://github.com/StoicDreams/timestamp |
| max_upload_size | |
| id | 877181 |
| size | 42,062 |
Erik Gassler (erikgassler)
documentation
README
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.2"
Use prelude for simple access to all structs and methods.
use stoicdreams_timestamp::prelude::*;
Other Recommended Tools
| Crate | Install Command | Example Run Command |
|---|---|---|
| rustfmt | rustup component add rustfmt | cargo fmt |
| clippy | rustup component add clippy | cargo clippy |
| cargo-audit | cargo install cargo-audit | cargo audit |
Other Resources
Author
Erik Gassler - Stoic Dreams - Forging solutions for tomorrow's software development.
Support - Visit Stoic Dreams' GitHub Sponsor page if you would like to provide support to Stoic Dreams.