التاريخ و الوقت في جافا | Java date and time

صدام العويري

اخر تحديث :

معرفة التاريخ و الوقت الحالي في جافا

معرفة التاريخ و الوقت الحالي سهلة جداً في جافا. كل ما عليك فعله هو إنشاء كائن من الكلاس Date, ثم عرض قيمة هذا الكائن.

مثال

Main.java

import java.util.Date;
 
public class Main {
 
    public static void main(String[] args) {
 
        // date هنا قمنا بإنشاء تاريخ و وضعناه في الكائن
        Date date = new Date();
 
        // date هنا قمنا بعرض التاريخ الذي تم تخزينه في الكائن
        System.out.println( date );
 
    }
 
}

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

Tue Dec 22 11:20:42 EET 2015

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك.

الكلاس `Date` في جافا

الكلاس Date هو كلاس جاهز في جافا يستخدم لمعرفة التاريخ و الوقت. و يحتوي على عدة دوال للتعامل مع الوقت سواء لمقارنة وقت مع وقت أو لمعرفة وقت معين إلخ..

الكلاس Date يحتوي على إثنين كونستركتور ذكرناهما في الجدول التالي.

الكونستركتور مع تعريفه

الكونستركتور مع تعريفه
`public Date()` هذا الكونستركتور يمهد الكائن الذي قام باستدعائه, بالوقت الحالي.
`public Date(long millisec)` هذا الكونستركتور يستخدم لتمهيد الكائن الذي يمثل الوقت بعدد بالـ milliseconds ( أي كل ثانية واحدة تساوي 1000 ). العدد الذي نضعه يمثل عدد الـ milliseconds الذي سيضاف على هذا التاريخ `1/1/1970 00:00:00 GMT` أي إذا وضعت 0 ستحصل على هذا التاريخ كما هو. و إذا وضعت 1000 ستضيف ثانية على هذا التاريخ. و إذا وضعت 2000 ستضيف ثانيتين على هذا التاريخ و هكذا.

public Date() هذا الكونستركتور يمهد الكائن الذي قام باستدعائه, بالوقت الحالي.

public Date(long millisec) هذا الكونستركتور يستخدم لتمهيد الكائن الذي يمثل الوقت بعدد بالـ milliseconds ( أي كل ثانية واحدة تساوي 1000 ).
العدد الذي نضعه يمثل عدد الـ milliseconds الذي سيضاف على هذا التاريخ 1/1/1970 00:00:00 GMT
أي إذا وضعت 0 ستحصل على هذا التاريخ كما هو.
و إذا وضعت 1000 ستضيف ثانية على هذا التاريخ.
و إذا وضعت 2000 ستضيف ثانيتين على هذا التاريخ و هكذا.

شاهد المثال »

دوال الكلاس `Date` في جافا

إسم الدالة مع تعريفها
`public boolean after(Date when)` ترجع `true` إذا كان كائن الـ `Date` الذي قام باستدعائها يحتوي على تاريخ أحدث من تاريخ الـ `Date` الذي نضعه كـ argument. تابع القراءة »
`public boolean before(Date when)` ترجع `true` إذا كان كائن الـ `Date` الذي قام باستدعائها يحتوي على تاريخ أقدم من تاريخ الـ `Date` الذي نضعه كـ argument. تابع القراءة »
`public Object clone()` ترجع نسخة ثانية من كائن الـ `Date` الذي قام باستدعائها. تابع القراءة »
`public int compareTo(Date anotherDate)` تقارن كائن الـ `Date` الذي قام باستدعائها مع كائن الـ `Date` الذي نضعه كـ argument. تابع القراءة »
`public boolean equals(Object obj)` ترجع `true` إذا كان كائن الـ `Date` الذي قام باستدعائها يحتوي على نفس قيمة الكائن الذي نضعه كـ argument. تابع القراءة »
`public long getTime()` ترجع عدد الـ milliseconds من تاريخ `1/1/1970` إلى تاريخ الوقت الذي تم به استدعاء هذه الدالة. تابع القراءة »
`public void setTime(long millisec)` تستخدم لتحديد الوقت إعتباراً من تاريخ `1/1/1970`, العدد الذي نضعه يمثل عدد الثواني بالـ milliseconds. تابع القراءة »
`public int hashCode()` ترجع hash code لكائن الـ `Date` الذي قام باستدعائها. تابع القراءة »
`public String toString()` تحول قيمة الـ `Date` لقيمة نوعها `String` و ترجعها. تابع القراءة »

الكلاس `SimpleDateFormat` في جافا

الكلاس SimpleDateFormat يستخدم للحصول على التاريخ و الوقت بالشكل الذي تريده, بمعنى أنه يسمح لك بتخصيص طريقة ظهور التاريخ و الوقت.
يتم تحديد شكل التاريخ و الوقت في كونستركتور الـ SimpleDateFormat بواسطة الأحرف الأبجدية. هنا يقال لهذه الأحرف user-defined patterns.

عند تعاملك مع الكلاس SimpleDateFormat يمكنك إستخدام جميع الأحرف من a ← z و من A ← Z.

عندما تقوم بتحديد طريقة ظهور التاريخ و الوقت فأنت بذلك تقوم بتحديد الـ format للتاريخ و الوقت.
بمعنى آخر الأحرف التي تضعها في كونستركتور الـ SimpleDateFormat مع بعضها تشكل الـ format.

هذا الجدول يحتوي على جميع الأحرف المستخدمة لتحديد الـ format في الكلاس SimpleDateFormat.

الحرف	إستخدامه	مثال
`G`	لإظهار عصر التسمية	`AD`
`Y`	لإظهار السنة, وتكون مؤلفة من أربع أرقام	`2005`
`M`	لإظهار رقم الشهر من السنة	`07`
`d`	لإظهار رقم اليوم من الشهر	`9`
`h`	لإظهار الساعة, بنظام 12 ساعة `(1~12) A.M./P.M.`	`12`
`H`	لإظهار الساعة في اليوم بنظام 24 ساعة `(0~23)`	`23`
`m`	لإظهار الدقائق في الساعة	`45`
`s`	لإظهار الثواني في الدقيقة	`36`
`S`	لإظهار الأجزاء في الثانية Millisecond	`458`
`E`	لإظهار إسم اليوم في الأسبوع	`Saturday`
`D`	لإظهار رقم اليوم في السنة	`360`
`F`	لإظهار عدد تكرار اليوم في الشهر	`3 (third Mon. in May)`
`w`	لإظهار رقم الأسبوع في السنة	`34`
`W`	لإظهار رقم الأسبوع في الشهر	`1`
`a`	لإظهار إذا كان الوقت الآن `A.M/P.M`	`AM`
`k`	لإظهار الساعة في اليوم بنظام 24 ساعة `(1~24)`	`23`
`K`	لإظهار الساعة في اليوم بنظام 12 ساعة `(0~11)`	`9`
`z`	لإظهار المنطقة الزمنية	`EET`
`' '`	لإظهار أي نص	`Current Date`

مثال

•سنقوم الآن بإنشاء format جديدة لعرض الوقت.

Main.java

import java.text.SimpleDateFormat;
import java.util.Date;
 
public class Main {
 
    public static void main(String[] args) {
 
        // date هنا قمنا بإنشاء تاريخ و وضعناه في الكائن
        Date date = new Date();
 
        // جديدة لإظهار الوقت format هنا قمنا بإنشاء
        SimpleDateFormat sdf = new SimpleDateFormat("'Current Date:' dd/MM/yy     'Current Time:' hh:mm:ss a");
 
        // ثم قمنا بعرض النتيجة format من خلال الدالة date على الـ format هنا قمنا بتطبيق الـ
        System.out.println( sdf.format(date) );
 
    }
 
}

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

Current Date: 22/12/15     Current Time: 07:46:05 PM

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك.

من خلال الجدول السابق يمكنك معرفة أن الكلاس Date يستخدم إفتراضياً الـ format التالية لعرض التاريخ و الوقت: E MMM d hh:mm:ss zzz Y

مثال

•سنقوم الآن بعرض التاريخ مرتين,الأولى بدون هذه الـ format, و الثانية مع هذه الـ format و لاحظ كيف سنحصل على نفس النتيجة.

Main.java

import java.text.SimpleDateFormat;
import java.util.Date;
 
public class Main {
 
    public static void main(String[] args) {
 
        // date هنا قمنا بإنشاء تاريخ و وضعناه في الكائن
        Date date = new Date();
 
        // إفتراضياً Date التي يستخدمها الكلاس format جديدة لإظهار الوقت و لكننا إستخدمنا الـ format هنا قمنا بإنشاء
        SimpleDateFormat sdf = new SimpleDateFormat("E MMM d hh:mm:ss zzz Y");
 
        System.out.println( date );               // عليه format بدون أن نطبق أي Date هنا قمنا بعرض الـ
        System.out.println( sdf.format(date) );   // عليه format مع تطبيق الـ Date هنا قمنا بعرض الـ
 
    }
 
}

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

Wed Dec 23 07:36:44 EET 2015
Wed Dec 23 07:36:44 EET 2015

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك, لكن التاريخ الأول سيكون نفس التاريخ الثاني دائماً.

تحديد الـ format بواسطة الدالة `printf()` في جافا

يمكنك أيضاً إستخدام الدالة printf() لتعرض التاريخ و الوقت بالشكل الذي تريده.
كل ما عليك فعله هو وضع %t ثم وضع حرف من الأحرف الموجودة في الجدول التالي.

الحرف	إستخدامه	مثال
`c`	لإظهار التاريخ و الوقت بشكل كامل	`Thu Dec 24 13:39:33 EET 2015`
`F`	لإظهار التاريخ بنظام ISO 8601	`2015-12-24`
`D`	لإظهار التاريخ بنظام U.S. أي `month/day/year`	`12/24/15`
`T`	لإظهار الوقت بنظام 24 ساعة	`13:40:43`
`r`	لإظهار الوقت بنظام 12 ساعة	`01:40:43 PM`
`R`	لإظهار الوقت بنظام 24 ساعة, و بدون إظهار الثواني	`13:40`
`Y`	لإظهار السنة, وتكون مؤلفة من أربع أرقام ( مع إبقاء الأصفار الموجودة على اليسار )	`2015`
`y`	لإظهار آخر رقمين من السنة ( مع إبقاء الأصفار الموجودة على اليسار )	`15`
`C`	لإظهار أول رقمين من السنة ( مع إبقاء الأصفار الموجودة على اليسار )	`20`
`B`	لإظهار إسم الشهر كاملاَ	`December`
`b`	لإظهار إسم الشهر بشكل مختصر	`Dec`
`m`	لإظهار الشهر بشكل رقمين ( مع إبقاء الأصفار الموجودة على اليسار )	`02`
`d`	لإظهار اليوم بشكل رقمين ( مع إبقاء الأصفار الموجودة على اليسار )	`12`
`e`	لإظهار اليوم بشكل رقمين ( مع إزالة الأصفار الموجودة على اليسار )	`24`
`A`	لإظهار إسم اليوم بشكل كامل	`Thursday`
`a`	لإظهار إسم اليوم بشكل مختصر	`Thu`
`j`	لإظهار رقم اليوم في السنة ( مع إبقاء الأصفار الموجودة على اليسار )	`358`
`H`	لإظهار الساعة بنظام 24 ساعة ( مع إبقاء الأصفار الموجودة على اليسار ), الرقم يكون بين 00 و 23	`13`
`k`	لإظهار الساعة بنظام 24 ساعة ( مع إزالة الأصفار الموجودة على اليسار ), الرقم يكون بين 0 و 23	`13`
`I`	لإظهار الساعة بنظام 12 ساعة ( مع إبقاء الأصفار الموجودة على اليسار ), الرقم يكون بين 01 و 12	`01`
`l`	لإظهار الساعة بنظام 12 ساعة ( مع إزالة الأصفار الموجودة على اليسار ), الرقم يكون بين 1 و 12	`1`
`M`	لإظهار الدقائق ( مع إبقاء الأصفار الموجودة على اليسار )	`02`
`S`	لإظهار الثواني ( مع إبقاء الأصفار الموجودة على اليسار )	`09`
`L`	لإظهار الثواني بشكل ثلاث أرقام بالـ milliseconds ( مع إبقاء الأصفار الموجودة على اليسار )	`959`
`N`	لإظهار الثواني بشكل تسعة أرقام بالـ nanoseconds ( مع إبقاء الأصفار الموجودة على اليسار )	`959000000`
`p`	لإظهار إذا كان الوقت قبل الظهر أو بعد الظهر بأحرف صغيرة	`pm`
`z`	لإظهار الفارق بين وقت الجهاز و الوقت `GMT`	`+0200`
`Z`	لإظهار المنطقة الزمنية	`EET`
`s`	لإظهار عدد الثواني منذ `1970/01/01 00:00:00 GMT`	`1450958247`
`Q`	لإظهار عدد الثواني بالـ milliseconds منذ `1970/01/01 00:00:00 GMT`	`1450958247680`

يمكنك أن تعرض التاريخ و الوقت بطرق كثيرة جداً و بعدة أساليب.

المثال الأول

•سنقوم الآن بعرض التاريخ و الوقت بعدة أشكال بـ format نحددها بالدالة printf().

Main.java

import java.util.Date;
 
public class Main {
 
    public static void main(String[] args) {
 
        // date هنا قمنا بإنشاء تاريخ و وضعناه في الكائن
        Date date = new Date();
 
        // هنا قمنا بعرض التاريخ والوقت
        System.out.printf( "Current Date/time: %tc", date );
 
        // هنا قمنا بعرض التاريخ فقط
        System.out.printf( "\nCurrent Date: %tF", date );
 
        // هنا قمنا بعرض الوقت فقط
        System.out.printf( "\nCurrent time: %tr", date );
 
    }
 
}

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

Current Date/time: Thu Dec 24 19:03:58 EET 2015
Current Date: 2015-12-24
Current time: 07:03:58 PM

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك.

المثال الثاني

•سنقوم الآن بعرض الوقت بـ format تتألف من ثلاث أحرف H و M و S.

•أولاً سنقوم بوضع الأحرف الثلاثة ( الأول يشير للساعة, الثاني يشير للدقائق, و الثالث يشير للثواني ).

•ثانياً سنقوم بوضع كائن الـ Date لكل حرف منهم.

•يجب وضع فاصلة قبل كل كائن, و هكذا سيفهم المترجم أن الحرف الأول سيظهر لنا الساعة الموجودة في الكائن الأول, و الحرف الثاني سيظهر لنا الدقائق الموجودة في الكائن الثاني, و الحرف الثالث سيظهر لنا الثواني الموجودة في الكائن الثالث.

Main.java

import java.util.Date;
 
public class Main {
 
    public static void main(String[] args) {
 
        // date هنا قمنا بإنشاء تاريخ و وضعناه في الكائن
        Date date = new Date();
 
        // هنا قمنا بعرض الوقت فقط
        System.out.printf( "Current time: %tH:%tM:%tS", date, date, date );
 
    }
 
}

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

Current time: 19:03:58

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك.

شرح الكود

لست مضطراً أن تضع الكائن Date لكل حرف كما فعلنا في المثال السابق.
يمكنك وضع أرقام index للأحرف التي ستستخدمها لإنشاء format معينة و هكذا سيصبح حجم الـ format أصغر أيضاً.
يجب وضع الأحرف المستخدمة في الـ format بترتيب معين بحيث تشير للـ Date و الـ String و أي شيء آخر تضعه في هذه الدالة كـ arguments.

رقم الـ index يتم إضافته مباشرةً بعد الرمز % و نضع بعده الرمز $, ثم الحرف t, ثم الحرف الذي نريده من الأحرف الموجودة في الجدول السابق.

أمثلة

إذا كنا نضع index لـ Date نعتمد هذا الشكل: % index $ t format
مثال: %2$tA
إذا كنا نضع index لـ String نعتمد هذا الشكل: % index $ s
مثال: %1$s

المثال الثالث

•سنقوم الآن بعرض التاريخ الحالي.

•سنقوم بوضع قيمة String في الـ index رقم 1.

•سنقوم بوضع كائن الـ Date في الـ index رقم 2.

•يجب وضع فاصلة قبل كل argument, و هكذا سيتم إعطاء كل argument منهم رقم index.

Main.java

import java.util.Date;
 
public class Main {
 
    public static void main(String[] args) {
 
        // date هنا قمنا بإنشاء تاريخ و وضعناه في الكائن
        Date date = new Date();
 
        // هنا قمنا بعرض التاريخ فقط
        System.out.printf( "%1$s %2$tA %2$te-%2$tm-%2$tY", "Today is:", date );
 
    }
 
}

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

Today is: Friday 25-12-2015

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك.

شرح الكود

يمكنك أيضاً إستخدام المؤشر < بدل إستخدام index.
المؤشر < يعني أن الـ argument الذي تم استخدامه سابقاً سيعاد استخدامه من جديد.

المثال الرابع

•سنقوم الآن بتنفيذ نفس المثال السابق و لكننا سنستخدم المؤشر < بدل إستخدام index.

Main.java

import java.util.Date;
 
public class Main {
 
    public static void main(String[] args) {
 
        // date هنا قمنا بإنشاء تاريخ و وضعناه في الكائن
        Date date = new Date();
 
        // هنا قمنا بعرض التاريخ فقط
        System.out.printf( "%s %tA %<te-%<tm-%<tY", "Today is:", date );
 
    }
 
}

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

Today is: Friday 25-12-2015

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك.

شرح الكود

تذكر أن هناك طرق كثيرة يمكنك إعتمادها لطباعة التاريخ و الوقت بالشكل الذي تريده, و هناك العديد من الكلاسات الجاهزة في جافا تمكنك من التعامل مع التاريخ و الوقت.

__________&&&______;&&&___________;&&&&________; __________&&&______;&&&___________;&&&&________; __________&&&______;&&&___________;&&&&________;

Javaكونستركتورات الكلاس `Date` في جافا

تعريفه

الكونستركتور Date يرجع كائن من الكلاس Date يحتوي على التاريخ و الوقت.

يمكنك إستدعائه بطريقتين:

إستداعائه بدون وضع قيمة له كـ argument فيعطيك الوقت الحالي, أي يعطيك نفس الوقت الموجود على جهازك.
إستداعائه مع وضع قيمة له كـ argument, هنا سيعطيك وقت يبدأ من تاريخ 1/1/1970 00:00:00 GMT.

بناؤه

                  // يمكننا إستدعائه هكذا
                  public Date()

                  // أو هكذا
                  public Date(long millisec)

باراميترات

الـ millisec يمثل عدد الـ milliseconds الذي سيضاف على هذا التاريخ 1/1/1970 00:00:00 GMT.
أي إذا وضعت 0 ستحصل على هذا التاريخ كما هو.
و إذا وضعت 1000 ستضيف ثانية على هذا التاريخ.
و إذا وضعت 2000 ستضيف ثانيتين على هذا التاريخ و هكذا..

قيمة الإرجاع

يرجع كائن من الكلاس Date.

مثال

                    public class Main {

                    public static void main(String[] args) {

                    // هنا قمنا بتخزين الوقت الحالي للجهاز
                    Date currentDate = new Date();
                    System.out.println( "Current Date: " + currentDate );

                    // هنا أضفنا 5 ثواني على التاريخ 00:00:00 1/1/1970
                    Date specialDate = new Date(5000);
                    System.out.println( "Special Date: " + specialDate );

                    }

                    }

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

                    Current Date: Sun Dec 20 09:46:01 EET 2015
                    Special Date: Thu Jan 01 02:00:05 EET 1970

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك.

__________&&&______;&&&___________;&&&&________;

Javaالدالة `after()`

تعريفها

هذه الدالة ترجع true إذا كان كائن الـ Date الذي قام باستدعائها يحتوي على تاريخ أحدث من تاريخ الـ Date الذي نضعه كـ argument.

بناؤها

                  public boolean after(Date when)

باراميترات

الـ when هو الـ Date الذي سيتم مقارنته مع الـ Date الذي قام باستدعاء الدالة.

قيمة الإرجاع

ترجع true إذا كان كائن الـ Date الذي قام باستدعائها يحتوي على تاريخ أحدث من تاريخ الـ Date الذي نضعه كـ argument.

مثال

Main.java

                    import java.util.Date;

                    public class Main {

                    public static void main(String[] args) {

                    // هنا قمنا بإنشاء تاريخين
                    Date date1 = new Date(20000);
                    Date date2 = new Date(40000);

                    // date2 أحدث من تاريخ الـ date1 هنا سنفحص إذا كان تاريخ الـ
                    boolean check = date1.after(date2);
                    System.out.println( "date1 is after date2: " + check ); // هنا قمنا بعرض نتيجة المقارنة

                    // date1 أحدث من تاريخ الـ date2 هنا سنفحص إذا كان تاريخ الـ
                    check = date2.after(date1);
                    System.out.println( "date2 is after date1: " + check ); // هنا قمنا بعرض نتيجة المقارنة

                    }

                    }

•سنحصل على النتيجة التالية عند التشغيل.

                    date1 is after date2: false
                    date2 is after date1: true

__________&&&______;&&&___________;&&&&________;

Javaالدالة `before()`

تعريفها

هذه الدالة ترجع true إذا كان كائن الـ Date الذي قام باستدعائها يحتوي على تاريخ أقدم من تاريخ الـ Date الذي نضعه كـ argument.

بناؤها

                  public boolean before(Date when)

باراميترات

الـ when هو الـ Date الذي سيتم مقارنته مع الـ Date الذي قام باستدعاء الدالة.

قيمة الإرجاع

ترجع true إذا كان كائن الـ Date الذي قام باستدعائها يحتوي على تاريخ أقدم من تاريخ الـ Date الذي نضعه كـ argument.

مثال

Main.java

                    import java.util.Date;

                    public class Main {

                    public static void main(String[] args) {

                    // هنا قمنا بإنشاء تاريخين
                    Date date1 = new Date(20000);
                    Date date2 = new Date(40000);

                    // date2 أقدم من تاريخ الـ date1 هنا سنفحص إذا كان تاريخ الـ
                    boolean check = date1.before(date2);
                    System.out.println( "date1 is before date2: " + check );  // هنا قمنا بعرض نتيجة المقارنة

                    // date1 أقدم من تاريخ الـ date2 هنا سنفحص إذا كان تاريخ الـ
                    check = date2.before(date1);
                    System.out.println( "date2 is before date1: " + check );  // هنا قمنا بعرض نتيجة المقارنة

                    }

                    }

•سنحصل على النتيجة التالية عند التشغيل.

                    date1 is before date2: true
                    date2 is before date1: false

__________&&&______;&&&___________;&&&&________;

Javaالدالة `clone()`

تعريفها

هذه الدالة ترجعة نسخة ثانية من كائن الـ Date الذي قام باستدعائها.

بناؤها

                  public Object clone()

باراميترات

لا تقبل أي باراميتر.

قيمة الإرجاع

ترجع كائن من الكلاس Date.

مثال

Main.java

                    import java.util.Date;

                    public class Main {

                    public static void main(String[] args) {

                    // Date هنا قمنا بإنشاء كائن نوعه
                    Date date1 = new Date();

                    // هنا قمنا بإنشاء نسخة عنه
                    Object date2 = date1.clone();

                    System.out.println( "Original Date: " + date1 );   // هنا قمنا بعرض الكائن الأصلي
                    System.out.println( "Cloned Date: " + date2 );     // هنا قمنا بعرض النسخة من هذا الكائن

                    }

                    }

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

                    Original Date: Mon Dec 21 20:26:14 EET 2015
                    Cloned Date: Mon Dec 21 20:26:14 EET 2015

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك.

__________&&&______;&&&___________;&&&&________;

Javaالدالة `compareTo()`

تعريفها

هذه الدالة تقارن كائن الـ Date الذي قام باستدعائها مع كائن الـ Date الذي نضعه كـ argument.

بناؤها

                  public int compareTo(Date anotherDate)

باراميترات

الـ anotherDate هو الـ date الذي سيتم مقارنته مع الـ date الذي قام باستدعاء الدالة.

قيمة الإرجاع

ترجع 0 إذا كانت قيمة الـ Date الذي قام باستدعائها تساوي قيمة التاريخ التي نضعها كـ argument.
ترجع 1 إذا كانت قيمة الـ Date الذي قام باستدعائها أحدث من قيمة التاريخ التي نضعها كـ argument.
ترجع 1- إذا كانت قيمة الـ Date الذي قام باستدعائها أقدم من قيمة التاريخ التي نضعها كـ argument.

مثال

Main.java

                    import java.util.Date;

                    public class Main {

                    public static void main(String[] args) {

                    // Date هنا قمنا بإنشاء ثلاث كائنات نوعهم
                    Date date1 = new Date(0);
                    Date date2 = new Date(5000);
                    Date date3 = date1;

                    int comparison1 = date1.compareTo(date2);   // date2 مع date1 هنا قمنا بمقارنة
                    int comparison2 = date2.compareTo(date1);   // date1 مع date2 هنا قمنا بمقارنة
                    int comparison3 = date1.compareTo(date3);   // date1 مع date3 هنا قمنا بمقارنة

                    // هنا قمنا بعرض نتائج المقارنات الثلالثة
                    System.out.println( "Comparison1 result: " + comparison1 );
                    System.out.println( "Comparison2 result: " + comparison2 );
                    System.out.println( "Comparison3 result: " + comparison3 );

                    }

                    }

•سنحصل على النتيجة التالية عند التشغيل.

                    Comparison1 result: -1
                    Comparison2 result: 1
                    Comparison3 result: 0

__________&&&______;&&&___________;&&&&________;

Javaالدالة `equals()`

تعريفها

هذه الدالة ترجع true إذا كان كائن الـ Date الذي قام باستدعائها يحتوي على نفس قيمة الكائن الذي نضعه كـ argument.

بناؤها

                  public boolean equals(Object obj)

باراميترات

الـ obj هو الكائن الذي نريد مقارنته مع الـ date الذي قام باستدعاء الدالة.

قيمة الإرجاع

ترجع true إذا كان كائن الـ Date الذي قام باستدعائها يحتوي على نفس قيمة الكائن الذي نضعه كـ argument.

مثال

Main.java

                    import java.util.Date;

                    public class Main {

                    public static void main(String[] args) {

                    // Date هنا قمنا بإنشاء ثلاثة كائنات نوعهم
                    Date date1 = new Date(0);
                    Date date2 = new Date(5000);
                    Date date3 = date1;

                    boolean check1 = date1.equals(date2);   // date2 لا تساوي date1 لأن false هنا سترجع
                    boolean check2 = date1.equals(date3);   // date3 تساوي date1 لأن true هنا سترجع

                    // هنا قمنا بعرض نتائج الإختبارات
                    System.out.println( "check1 result: " + check1 );
                    System.out.println( "check2 result: " + check2 );

                    }

                    }

•سنحصل على النتيجة التالية عند التشغيل.

                    check1 result: false
                    check2 result: true

__________&&&______;&&&___________;&&&&________;

Javaالدالة `getTime()`

تعريفها

هذه الدالة ترجع عدد الـ milliseconds من تاريخ 1/1/1970 إلى تاريخ الوقت الذي تم به استدعائها.

بناؤها

                  public long getTime()

باراميترات

لا تقبل أي باراميتر.

قيمة الإرجاع

ترجع عدد الـ milliseconds من تاريخ 1/1/1970 إلى تاريخ الوقت الذي تم به استدعاء هذه الدالة.

مثال

Main.java

                    import java.util.Date;

                    public class Main {

                    public static void main(String[] args) {

                    // هنا قمنا بإنشاء تاريخ
                    Date date = new Date();

                    // date هنا قمنا بتخزين عدد الثواني بين 1/1/1970 و بين التاريخ المخزن في
                    long secondsPassed = date.getTime();

                    // هنا قمنا بعرض عدد الثواني الموجود بين التاريخين
                    System.out.println( "The number of seconds from 1/1/1970 to " +date+ " is: " +secondsPassed );

                    }

                    }

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

                    The number of seconds from 1/1/1970 to Tue Dec 22 09:41:37 EET 2015 is: 1450770097706

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك.

__________&&&______;&&&___________;&&&&________;

Javaالدالة `setTime()`

تعريفها

هذه الدالة تستخدم لتحديد الوقت إعتباراً من تاريخ 1/1/1970, العدد الذي نضعه يمثل عدد الثواني بالـ milliseconds.

ملاحظة: بمجرد إستخدام هذه الدالة ستتحول قيمة التاريخ و الوقت الذي قام باستدعائها إلى1/1/1970 00:00:00 GMT.

بناؤها

                  public void setTime(long millisec)

باراميترات

الـ millisec يمثل عدد الـ milliseconds الذي سيضاف على التاريخ 1/1/1970 00:00:00 GMT.

قيمة الإرجاع

لا ترجع قيمة.

مثال

Main.java

                    import java.util.Date;

                    public class Main {

                    public static void main(String[] args) {

                    // هنا قمنا بإنشاء تاريخ
                    Date date = new Date();

                    // هنا أضفنا 10 ثواني على التاريخ 1/1/1970
                    date.setTime(10000);

                    // هنا قمنا بعرض قيمة التاريخ
                    System.out.println( "Time after setting: " +date );

                    }

                    }

•سنحصل على النتيجة التالية عند التشغيل.

                    Time after setting: Thu Jan 01 02:00:10 EET 1970

__________&&&______;&&&___________;&&&&________;

Javaالدالة `hashCode()`

تعريفها

هذه الدالة ترجع hash code للـ Date الذي قام باستدعائها.

بناؤها

                  public int hashCode()

باراميترات

هذه الدالة الإفتراضية و هي لا تقبل أي باراميتر.

قيمة الإرجاع

ترجع قيمة الـ hash code للـ Date الذي قام باستدعائها.

مثال

Main.java

                    import java.util.Date;

                    public class Main {

                    public static void main(String[] args) {

                    Date currentDate = new Date();                               // هنا قمنا بتخزين الوقت الحالي للجهاز
                    long hash = currentDate.toString().hashCode();               // hashcode هنا قمنا بتحويل قيمة الوقت لنص ثم قمنا بتحويلها لـ

                    System.out.println( "Current Date: " + currentDate );        // هنا قمنا بعرض الوقت الحالي
                    System.out.println( "Current Date in hashcode: " + hash );   // للوقت الحالي hashcode هنا قمنا بعرض قيمة الـ

                    }

                    }

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

                    Current Date: Mon Dec 21 12:50:07 EET 2015
                    Current Date in hashcode: 1833992306

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك.

__________&&&______;&&&___________;&&&&________;

Javaالدالة `toString()`

تعريفها

هذه الدالة تحول قيمة الـ Date لقيمة نوعها String و ترجعها.
الأمر الذي سيسمح لنا بمعاملة الوقت كنص و الإستفادة من دوال الكلاس String.

بناؤها

                  public String toString()

باراميترات

لا تقبل أي باراميتر.

قيمة الإرجاع

ترجع كائن نوعه String.

مثال

Main.java

                    import java.util.Date;

                    public class Main {

                    public static void main(String[] args) {

                    Date currentDate = new Date();               // هنا قمنا بتخزين الوقت الحالي للجهاز
                    String s = currentDate.toString();           // s هنا قمنا بتخزين الوقت كنص في

                    System.out.println( "Current Date: " + s );  // s هنا قمنا بعرض قيمة الـ

                    }

                    }

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

                    Current Date: Sun Dec 20 14:05:15 EET 2015

•هذه النتيجة تتغير حسب الوقت الحالي لجهازك.

__________&&&______;&&&___________;&&&&________; __________&&&______;&&&___________;&&&&________;

تعديل المقال

التاريخ و الوقت في جافا | Java date and time

معرفة التاريخ و الوقت الحالي في جافا

مثال

الكلاس Date في جافا

دوال الكلاس Date في جافا

الكلاس SimpleDateFormat في جافا

مثال

مثال

تحديد الـ format بواسطة الدالة printf() في جافا

المثال الأول

المثال الثاني

شرح الكود

أمثلة

المثال الثالث

شرح الكود

المثال الرابع

شرح الكود

Javaكونستركتورات الكلاس Date في جافا

تعريفه

بناؤه

باراميترات

قيمة الإرجاع

مثال

Javaالدالة after()

تعريفها

بناؤها

باراميترات

قيمة الإرجاع

مثال

Javaالدالة before()

تعريفها

بناؤها

باراميترات

قيمة الإرجاع

مثال

Javaالدالة clone()

تعريفها

بناؤها

باراميترات

قيمة الإرجاع

مثال

Javaالدالة compareTo()

تعريفها

بناؤها

باراميترات

قيمة الإرجاع

مثال

Javaالدالة equals()

تعريفها

بناؤها

باراميترات

قيمة الإرجاع

مثال

Javaالدالة getTime()

تعريفها

بناؤها

باراميترات

قيمة الإرجاع

مثال

Javaالدالة setTime()

تعريفها

بناؤها

باراميترات

قيمة الإرجاع

مثال

Javaالدالة hashCode()

تعريفها

بناؤها

باراميترات

قيمة الإرجاع

مثال

Javaالدالة toString()

تعريفها

بناؤها

باراميترات

قيمة الإرجاع

مثال

مقالات قد تهمك

الكلاس `Date` في جافا

دوال الكلاس `Date` في جافا

الكلاس `SimpleDateFormat` في جافا

تحديد الـ format بواسطة الدالة `printf()` في جافا

Javaكونستركتورات الكلاس `Date` في جافا

Javaالدالة `after()`

Javaالدالة `before()`

Javaالدالة `clone()`

Javaالدالة `compareTo()`

Javaالدالة `equals()`

Javaالدالة `getTime()`

Javaالدالة `setTime()`

Javaالدالة `hashCode()`

Javaالدالة `toString()`