الرئيسية / Date/Time / Instant بدقة النانو ثانية
Date/Time متوسط

Instant بدقة النانو ثانية

احصل على طوابع زمنية بدقة الميكرو ثانية أو النانو ثانية.

مقارنة الكود
✕ Java 8 
// Millisecond precision only
long millis =
    System.currentTimeMillis();
// 1708012345678
✓ Java 9+ 
// Microsecond/nanosecond precision
Instant now = Instant.now();
// 2025-02-15T20:12:25.678901234Z
long nanos = now.getNano();
هل ترى مشكلة في هذا الكود؟ أخبرنا.
لماذا يتفوق الأسلوب الحديث
🎯

دقة أعلى

طوابع زمنية بدقة الميكرو/النانو ثانية مقابل الميلي ثانية.

📐

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

يحمل Instant دقته — لا أعداد طويلة غامضة.

🌐

مبني على UTC

Instant دائماً بـ UTC — لا التباس في المنطقة الزمنية.

الأسلوب القديم
ميلي ثانية
الأسلوب الحديث
نانو ثانية
منذ JDK
9
الصعوبة
متوسط
دعم JDK
Instant بدقة النانو ثانية
متاح

متاح على نطاق واسع منذ JDK 9 (سبتمبر 2017)

كيف يعمل

حسّن Java 9 دقة الساعة بحيث يلتقط Instant.now() دقة الميكرو ثانية على معظم المنصات (النانو ثانية على بعضها). تُعطي currentTimeMillis() القديمة ميلي ثانية فحسب.

توثيق ذو صلة
Instant ↗ Clock ↗
أنماط ذات صلة
Date/Time متوسط

HexFormat

Java 8
// Pad to 2 digits, uppercase
String hex = String.format(
    "%02X", byteValue);
// Parse hex string
int val = Integer.parseInt(
    "FF", 16);
Java 17+
var hex = HexFormat.of()
    .withUpperCase();
String s = hex.toHexDigits(
    byteValue);
byte[] bytes =
    hex.parseHex("48656C6C6F");
مرر للرؤية الحديث ←
JDK 17+ →
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 مبتدئ

Duration and 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);
مرر للرؤية الحديث ←
JDK 8+ →
مشاركة 𝕏 🦋 in ⬡