العمل مع التواريخ والوقت في Swift: من الألف إلى الياء

مقدمة في العمل مع التواريخ والوقت في Swift

العمل مع التواريخ والوقت هو أحد المهام الأساسية عند تطوير التطبيقات لنظامي iOS و macOS. من عرض التاريخ الحالي ببساطة إلى الحسابات المعقدة للفترات الزمنية وإدارة المناطق الزمنية، توفر Swift مجموعة أدوات قوية ومرنة. في هذه المقالة، سنستعرض الفئات والهياكل الأساسية: Date و DateFormatter و Calendar و DateComponents و TimeInterval. ستتعلم كيفية إنشاء التواريخ وتنسيقها ومقارنتها والتعامل معها عمليًا.

الفئات والهياكل الأساسية

في Swift، يتم استخدام عدة أنواع أساسية للعمل مع التواريخ. دعنا نستعرض كلًا منها.

\n
• Date — هيكل يمثل لحظة زمنية محددة. وهو مستقل عن التقويم أو المنطقة الزمنية.
\n
• DateFormatter — فئة لتحويل التاريخ إلى نص والعكس.
\n
• Calendar — هيكل يصف التقويم (ميلادي، بوذي، إلخ) ويوفر طرقًا للعمل مع مكونات التاريخ.
\n
• DateComponents — هيكل لتخزين المكونات الفردية للتاريخ (السنة، الشهر، اليوم، الساعة، الدقيقة، إلخ).
\n
• TimeInterval — نوع (Double) يمثل عدد الثواني.
\n

العمل مع Date و DateFormatter

لنبدأ بالأبسط: الحصول على التاريخ الحالي وعرضه للمستخدم.

الحصول على التاريخ الحالي

import Foundation\n\nlet currentDate = Date()\nprint("التاريخ والوقت الحالي: \\(currentDate)")\n// الإخراج: التاريخ والوقت الحالي: 2025-04-05 12:30:00 +0000

تنسيق التاريخ

لجعل التاريخ يبدو مألوفًا، نستخدم DateFormatter:

let formatter = DateFormatter()\nformatter.dateFormat = "dd.MM.yyyy HH:mm"\nlet dateString = formatter.string(from: currentDate)\nprint("التاريخ المنسق: \\(dateString)")\n// الإخراج: التاريخ المنسق: 05.04.2025 12:30

تحويل نص إلى تاريخ

let dateString = "2025-04-05 14:00"\nformatter.dateFormat = "yyyy-MM-dd HH:mm"\nif let parsedDate = formatter.date(from: dateString) {\n    print("التاريخ المحول: \\(parsedDate)")\n} else {\n    print("خطأ في التحويل")\n}

هام: تأكد دائمًا من أن date(from:) لا يُرجع nil، وإلا فقد يتعطل التطبيق.

التلاعب بالتواريخ عبر Calendar و DateComponents

غالبًا ما نحتاج إلى إضافة أيام أو أشهر أو حساب الفرق بين التواريخ. هنا يأتي دور Calendar.

إضافة وطرح الوقت

let calendar = Calendar.current\nlet oneWeekLater = calendar.date(byAdding: .day, value: 7, to: currentDate)!\nlet oneMonthAgo = calendar.date(byAdding: .month, value: -1, to: currentDate)!\n\nprint("بعد أسبوع: \\(formatter.string(from: oneWeekLater))")\nprint("قبل شهر: \\(formatter.string(from: oneMonthAgo))")

استخراج مكونات التاريخ

let components = calendar.dateComponents([.year, .month, .day, .hour], from: currentDate)\nif let year = components.year, let month = components.month {\n    print("اليوم: \\(year)-\\(month)")\n}

إنشاء تاريخ من المكونات

var newComponents = DateComponents()\nnewComponents.year = 2025\nnewComponents.month = 12\nnewComponents.day = 25\nnewComponents.hour = 10\nnewComponents.minute = 0\n\nif let christmas = calendar.date(from: newComponents) {\n    print("عيد الميلاد: \\(formatter.string(from: christmas))")\n}

مقارنة التواريخ والعمل مع TimeInterval

تتيح Swift مقارنة التواريخ بسهولة وحساب الفترات الزمنية.

مقارنة التواريخ

let now = Date()\nlet futureDate = calendar.date(byAdding: .day, value: 10, to: now)!\n\nif futureDate > now {\n    print("