Rust Persian Calendar
Rust Persian Calendar v0.1.1 provides functionality for conversion among Persian (Solar Hijri) and Gregorian calendars. A Julian calendar is used as an interface for all conversions. The crate name is ptime and it is compatible with the crate time. This source code is licensed under MIT license that can be found in the LICENSE file.
Installation
Add ptime = "0.1" to dependencies section of Cargo.toml:
[dependencies]
time = "0.1"
ptime = "0.1"
Getting started
1- Import the crate ptime. Most of the time you need to import time crate, too.
extern crate ptime;
extern crate time;
2- Convert Gregorian calendar to Persian calendar.
let p_tm = ptime::from_gregorian_date(2016, 2, 21).unwrap();
assert_eq!(p_tm.tm_year, 1395);
assert_eq!(p_tm.tm_mon, 0);
assert_eq!(p_tm.tm_mday, 2);
3- Convert Persian calendar to Gregorian calendar.
let g_tm = ptime::from_persian_date(1395, 0, 2).unwrap().to_gregorian();
assert_eq!(g_tm.tm_year, 2016);
assert_eq!(g_tm.tm_mon, 2);
assert_eq!(g_tm.tm_mday, 21);
4- Get the current time.
let p_tm = ptime::now();
println!("Current time: {}", p_tm);
let p_tm_utc = ptime::now_utc();
println!("Current time at UTC: {}", p_tm_utc);
5- Format the time.
let p_tm = ptime::from_gregorian(time::now());
println!("{}", p_tm.to_string("yyyy-MM-dd HH:mm:ss.ns"));
/// yyyy, yyy, y year (e.g. 1394)
/// yy 2-digits representation of year (e.g. 94)
/// MMM the Persian name of month (e.g. فروردین)
/// MM 2-digits representation of month (e.g. 01)
/// M month (e.g. 1)
/// DD day of year (starting from 1)
/// D day of year (starting from 0)
/// dd 2-digits representation of day (e.g. 01)
/// d day (e.g. 1)
/// E the Persian name of weekday (e.g. شنبه)
/// e the Persian short name of weekday (e.g. ش)
/// A the Persian name of 12-Hour marker (e.g. قبل از ظهر)
/// a the Persian short name of 12-Hour marker (e.g. ق.ظ)
/// HH 2-digits representation of hour [00-23]
/// H hour [0-23]
/// kk 2-digits representation of hour [01-24]
/// k hour [1-24]
/// hh 2-digits representation of hour [01-12]
/// h hour [1-12]
/// KK 2-digits representation of hour [00-11]
/// K hour [0-11]
/// mm 2-digits representation of minute [00-59]
/// m minute [0-59]
/// ss 2-digits representation of seconds [00-59]
/// s seconds [0-59]
/// ns nanoseconds
For more information, please check the test files in tests folder.
36 Jan 1, 2023
1.6k Dec 26, 2022
26 Nov 13, 2022
1 Jan 2, 2022
5 Dec 21, 2022
87 Dec 10, 2022
150 Jan 2, 2023
15 Dec 20, 2022
117 Apr 26, 2023
2.6k Jan 8, 2023
1 Apr 7, 2022
6 Oct 24, 2023
840 Dec 30, 2022
310 Dec 29, 2022
3 Oct 28, 2022
3 Nov 3, 2023
3 Dec 9, 2023
3 Sep 6, 2024
4.8k Jan 8, 2023
7 Dec 2, 2022
6 Nov 21, 2022
51 Dec 19, 2022
159 Jan 2, 2023
2 Sep 2, 2022
2 Oct 28, 2021
1 Aug 11, 2022
1 Feb 22, 2022
17 Dec 25, 2021
12 Sep 3, 2022