diesel-chrono-duration

Crates.iodiesel-chrono-duration
lib.rsdiesel-chrono-duration
version1.1.0
sourcesrc
created_at2018-02-16 15:13:44.03516
updated_at2023-12-05 18:12:14.416955
descriptionAdds chrono::Duration support to the diesel
homepage
repositoryhttps://github.com/iddm/diesel-chrono-duration
max_upload_size
id51408
size8,430
Shockingly Good (iddm)

documentation

https://docs.rs/diesel-chrono-duration

README

diesel-chrono-duration

CI MIT licensed

This crate adds support for the chrono::Duration type into the diesel ORM.

Why

Diesel crate has a policy of including only such type implementations which can be represented as is in the SQL types. chrono::Duration does not have a direct 1-to-1 mapping in both the SQLite and PostgreSQL.

How

The chrono::Duration type stores its value as i64 number. This is exactly 8 bytes and such types are BigInteger and BigInt. So, the ToSql and FromSql traits implementation simply uses chrono::Duration's inner i64 value.

Usage

To implement this we added ChronoDurationProxy type which is just a strong type as defined as:

pub struct ChronoDurationProxy(pub chrono::Duration);

In your table model you use it instead of chrono::Duration:

extern crate diesel_chrono_duration;

use diesel_chrono_duration::ChronoDurationProxy;

#[derive(Debug, Clone, Queryable, Insertable)]
#[table_name = "sometable"]
pub struct SomeTable {
    /// The ID of the record in the table.
    pub id: i32,
    /// Some duration
    pub duration: ChronoDurationProxy,
}

Later, when you want to use it's value as chrono::Duration you have these options:

  • *duration returns a reference to the inner chrono::Duration object. It is done by the Deref trait.
  • &duration also returns a reference to the inner chrono::Duration object. It is done by the AsRef trait.
  • duration.0 as in usual rust.

Contribute

The project is very simple and small but all contributions are "please make a contribution". Thanks in advance.

License

This project is licensed under the MIT license.

Commit count: 10

cargo fmt