rust-carbon

rust-carbon is thin wrapper of rust-time. Utility for handling date and time.

Usage

Add rust-carbon to your Cargo.toml.

toml [dependencies] carbon = "0.1.*"

And put this in your crate root.

rust extern crate carbon;

Overview

rust-carbon provides start_of() and end_of() to get datetime. And you can modify datetime by second,minute,hour,day, and month.

```rust // import carbon first use carbon::*;

// now assume that it is 2015-01-15 01:30:30.500000000

DateTime::now().startof().second(); // => return carbon::DateTime for 2015-01-15 01:30:30.000000000 DateTime::now().startof().minute(); // => return carbon::DateTime for 2015-01-15 01:30:00.000000000 DateTime::now().startof().hour(); // => return carbon::DateTime for 2015-01-15 01:00:00.000000000 DateTime::now().startof().day(); // => return carbon::DateTime for 2015-01-15 00:00:00.000000000 DateTime::now().start_of().month(); // => return carbon::DateTime for 2015-01-01 00:00:00.000000000

DateTime::now().endof().second(); // => return carbon::DateTime for 2015-01-15 01:30:30.999999999 DateTime::now().endof().minute(); // => return carbon::DateTime for 2015-01-15 01:30:59.999999999 DateTime::now().endof().hour(); // => return carbon::DateTime for 2015-01-15 01:59:59.999999999 DateTime::now().endof().day(); // => return carbon::DateTime for 2015-01-15 23:59:59.999999999 DateTime::now().end_of().month(); // => return carbon::DateTime for 2015-01-31 23:59:59.999999999 ```

More sample codes

Chaining method calls

```rust // now assume that it is 2015-01-15 01:30:30.500000000

DateTime::now().startof().day().endof().hour(); // => return carbon::DateTime for 2015-01-15 00:59:59.999999999 ```

Directly specify time and set now the time. It is useful for testing.

```rust // carbon::DateTime for 2015-01-01 00:00:00 let tm = time::Tm { tmsec: 0, tmmin: 0, tmhour: 0, tmmday: 1, tmmon: 0, tmyear: 115, tmwday: 4, tmyday: 0, tmisdst: 0, tmutcoff: 0, tm_nsec: 0 }; }

let testnow = DateTime::createfromtm(tm); DateTime::settestnow(testnow); DateTime::now(); // => return carbon::DateTime for 2015-01-01 00:00:00 ```

rust-carbon is thin wrapper of rust-time. You can access time::Tm easily.

```rust // now assume that it is 2015-01-15 01:30:30.500000000

DateTime::now().tm.strftime("%Y-%m-%d %H:%M:%S").ok().unwrap().to_string(); // => return string "2015-01-15 01:30:30"

use std::ops::{Add, Sub};

let hour = time::Duration::hours(1); DateTime::now().tm.add(hour) // return time::Tm for 2015-01-15 02:30:30.500000000 ```

Known Issue