الرئيسية / Date/Time / Duration و Period
Date/Time مبتدئ

Duration و Period

احسب فوارق الوقت بـ Duration و Period الآمنَين من حيث النوع.

مقارنة الكود
✕ Pre-Java 8 
// How many days between two dates?
long diff = date2.getTime()
    - date1.getTime();
long days = diff
    / (1000 * 60 * 60 * 24);
// ignores DST, leap seconds
✓ Java 8+ 
long days = ChronoUnit.DAYS
    .between(date1, date2);
Period period = Period.between(
    date1, date2);
Duration elapsed = Duration.between(
    time1, time2);
هل ترى مشكلة في هذا الكود؟ أخبرنا.
لماذا يتفوق الأسلوب الحديث
🎯

آمن من حيث النوع

Duration للوقت و Period للتواريخ — لا التباس.

🛡️

حساب صحيح

يتعامل مع انتقالات التوقيت الصيفي والسنوات الكبيسة والثواني الكبيسة.

📖

مقروء

ChronoUnit.DAYS.between() يُقرأ كاللغة الطبيعية.

الأسلوب القديم
حساب الميلي ثانية
الأسلوب الحديث
Duration / Period
منذ JDK
8
الصعوبة
مبتدئ
دعم JDK
Duration و Period
متاح

متاح على نطاق واسع منذ JDK 8 (مارس 2014)

كيف يعمل

Duration للكميات الزمنية (ساعات ودقائق وثوان). Period للكميات المبنية على التاريخ (سنوات وأشهر وأيام). ChronoUnit.between() للفروق البسيطة. جميعها تتعامل مع الحالات الطرفية بشكل صحيح.

توثيق ذو صلة
Duration ↗ Period ↗
أنماط ذات صلة
Date/Time مبتدئ

java.time API basics

Pre-Java 8
// Mutable, confusing, zero-indexed months
Calendar cal = Calendar.getInstance();
cal.set(2025, 0, 15); // January = 0!
Date date = cal.getTime();
// not thread-safe
Java 8+
LocalDate date = LocalDate.of(
    2025, Month.JANUARY, 15);
LocalTime time = LocalTime.of(14, 30);
Instant now = Instant.now();
// immutable, thread-safe
مرر للرؤية الحديث ←
JDK 8+ →
Date/Time مبتدئ

Date formatting

Pre-Java 8
// Not thread-safe!
SimpleDateFormat sdf =
    new SimpleDateFormat("yyyy-MM-dd");
String formatted = sdf.format(date);
// Must synchronize for concurrent use
Java 8+
DateTimeFormatter fmt =
    DateTimeFormatter.ofPattern(
        "uuuu-MM-dd");
String formatted =
    LocalDate.now().format(fmt);
// Thread-safe, immutable
مرر للرؤية الحديث ←
JDK 8+ →
Date/Time مبتدئ

Math.clamp()

Java 8
// Clamp value between min and max
int clamped =
    Math.min(Math.max(value, 0), 100);
// or: min and max order confusion
Java 21+
int clamped =
    Math.clamp(value, 0, 100);
// value constrained to [0, 100]
مرر للرؤية الحديث ←
JDK 21+ →
مشاركة 𝕏 🦋 in ⬡