العمل المتقدم مع التواريخ والأوقات في Rust: chrono و time

العمل المتقدم مع التواريخ والأوقات في Rust

في التطوير الحديث باستخدام Rust، يتجاوز العمل مع التواريخ والأوقات بكثير مجرد الحصول على اللحظة الحالية. عند إنشاء أنظمة عالية التحميل، أو تطبيقات مالية، أو خدمات موزعة، يلزم حساب دقيق للمناطق الزمنية، وتحليل فعال، وتسلسل، وحسابات زمنية معقدة. في هذه المقالة، سنستعرض التقنيات المتقدمة للعمل مع التواريخ والأوقات باستخدام الكريتات chrono و time.

1. مكتبة chrono: أساس العمل المتقدم

كريت chrono هو المعيار الفعلي للعمل مع التواريخ والأوقات في Rust. يوفر تجريدين رئيسيين: NaiveDateTime (تاريخ-وقت بدون منطقة زمنية) و DateTime<Tz> (تاريخ-وقت مرتبط بمنطقة زمنية).

مثال: العمل مع المناطق الزمنية

use chrono::{DateTime, Utc, Local, FixedOffset, NaiveDateTime};\nuse chrono::format::ParseError;\n\nfn main() -> Result<(), ParseError> {\n    // الوقت الحالي في UTC\n    let utc_now: DateTime<Utc> = Utc::now();\n    println!("UTC now: {}", utc_now);\n\n    // الوقت المحلي الحالي\n    let local_now: DateTime<Local> = Local::now();\n    println!("Local now: {}", local_now);\n\n    // التحويل إلى منطقة زمنية أخرى (موسكو، UTC+3)\n    let moscow_offset = FixedOffset::east_opt(3 * 3600).unwrap();\n    let moscow_time = utc_now.with_timezone(&moscow_offset);\n    println!("Moscow time: {}", moscow_time);\n\n    // تحليل سلسلة نصية مع منطقة زمنية\n    let parsed = DateTime::parse_from_rfc3339("2024-03-15T14:30:00+05:00")?;\n    println!("Parsed with offset: {}", parsed);\n\n    Ok(())\n}

هام: استخدم Utc للتخزين في قواعد البيانات و API، وقم بالتحويل إلى المناطق المحلية فقط على مستوى العرض.

2. الحسابات الزمنية المعقدة والفواصل الزمنية

تدعم مكتبة chrono العمليات الحسابية على التواريخ باستخدام النوع Duration والعمليات الأكثر تعقيدًا عبر trait TimeDelta. للعمل مع الفواصل والفترات الزمنية (مثل "الشهر التالي")، استخدم Months و Weeks.

مثال: الحسابات مع التواريخ

use chrono::{NaiveDate, Duration, Months, Datelike, Weekday};\n\nfn main() {\n    let start = NaiveDate::from_ymd_opt(2024, 1, 15).unwrap();\n\n    // إضافة أيام\n    let plus_10_days = start + Duration::days(10);\n    println!("+10 days: {}", plus_10_days);\n\n    // إضافة أشهر (تراعي اختلاف أطوال الأشهر)\n    let plus_2_months = start.checked_add_months(Months::new(2)).unwrap();\n    println!("+2 months: {}", plus_2_months);\n\n    // البحث عن يوم الاثنين التالي\n    let next_monday = start.iter_days()\n        .skip(1)\n        .find(|d| d.weekday() == Weekday::Mon)\n        .unwrap();\n    println!("Next Monday: {}", next_monday);\n\n    // الفرق بين التواريخ بالأيام\n    let end = NaiveDate::from_ymd_opt(2024, 12, 31).unwrap();\n    let days_diff = end.signed_duration_since(start).num_days();\n    println!("Days between: {}", days_diff);\n}

نصيحة: للحسابات المالية، استخدم checked_add_months بدلاً من مجرد جمع الأيام، لمعالجة نهايات الأشهر بشكل صحيح (مثل 31 يناير + شهر واحد = 28/29 فبراير).

3. التسلسل وتحليل التواريخ باستخدام serde

عند العمل مع JSON أو YAML أو قواعد البيانات، يعد التسلسل الصحيح للتواريخ أمرًا بالغ الأهمية. يتكامل كريت chrono مع serde عبر الميزة serde. للتنسيقات المخصصة، استخدم السمات #[serde(with = "...")].

مثال: التسلسل بتنسيق ISO 8601 والتنسيقات المخصصة

use chrono::{DateTime, Utc, NaiveDateTime};\nuse serde::{Serialize, Deserialize};\n\n#[derive(Debug, Serialize, Deserialize)]