chrono-lc/README.md

40 lines
1.2 KiB
Markdown
Raw Normal View History

2018-12-02 13:38:33 +00:00
# chrono-locale
2023-08-23 14:20:02 +01:00
This crate allows to format [chrono](https://github.com/chronotope/chrono) dates with localized months and week days. Backwards comptible fork of [Alex-PK/chrono-locale](https://github.com/Alex-PK/chrono-locale), now works with the latest version of chrono.
2018-12-14 08:35:56 +00:00
## Usage
Put this in your Cargo.toml:
2023-08-23 14:20:02 +01:00
```toml
2018-12-14 08:35:56 +00:00
[dependencies]
2023-08-23 14:20:02 +01:00
chrono = "0.4.56"
2023-08-23 14:40:07 +01:00
chrono_locale = { git = "https://github.com/0x5eal/chrono-locale.git", rev = "2a7ebcc" }
2018-12-14 08:35:56 +00:00
```
Then put this in your `lib.rs` or `main.rs`:
```rs
2018-12-14 08:35:56 +00:00
use chrono::prelude::*;
use chrono_locale::LocaleDate;
```
You can choose to import just parts of chrono instead of the whole prelude.
Please see ['chrono`'s documentation](https://docs.rs/chrono/).
To format a chrono `Date` or `DateTime` object, you can use the `formatl` method:
```rs
let dt = FixedOffset::east_opt(34200)
.unwrap()
.with_ymd_and_hms(2001, 7, 8, 0, 34, 59)
.unwrap()
.with_nanosecond(1_026_490_708)
.unwrap();
2018-12-14 08:35:56 +00:00
println!("{}", dt.formatl("%c", "fr"));
```
All of [chrono's formatting placeholders](https://docs.rs/chrono/latest/chrono/format/strftime/index.html)
2018-12-14 08:35:56 +00:00
work except for `%3f`, `%6f` and `%9f` (but `%.3f`, `%.6f` and `%.9f` work normally)