آموزش جاوا - تاریخ و زمان

جاوا کلاس Date را در بسته‌ی java.util فراهم می‌کند. این کلاس تاریخ و زمان فعلی را در خود نگهداری می‌کند.

کلاس Date دو سازنده را پشتیبانی می‌کند که در جدول زیر نشان داده شده‌اند.

متدهای کلاس تاریخ به شرح زیر هستند.

دریافت تاریخ و زمان فعلی

این یک روش بسیار آسان برای دریافت تاریخ و زمان فعلی در جاوا است. می‌توانید از یک شیء ساده‌ی Date با متد toString() برای چاپ تاریخ و زمان فعلی استفاده کنید به شکل زیر −

مثال

import java.util.Date;
public class DateDemo {

   public static void main(String args[]) {
      // Instantiate a Date object
      Date date = new Date();

      // display time and date using toString()
      System.out.println(date.toString());
   }
}

این به نتیجه‌ی زیر منجر خواهد شد −

خروجی

on May 04 09:51:52 CDT 2009

مقایسه تاریخ

سه روش برای مقایسه دو تاریخ وجود دارد −

• شما می‌توانید از getTime( ) برای دریافت تعداد میلی‌ثانیه‌هایی استفاده کنید که از 1 ژانویه 1970 می‌گذرد و سپس این مقادیر را با یکدیگر مقایسه کنید. (You can use getTime() to obtain the milliseconds that have elapsed since January 1, 1970 and then compare these values with each other.)

• شما می‌توانید از متد compareTo( ) برای مقایسه دو تاریخ استفاده کنید. این متد یک عدد صحیح برمی‌گرداند که بر اساس نتیجه‌ی مقایسه مقادیر دو تاریخ تعیین می‌شود. (You can use the compareTo() method to compare two dates. This method returns an integer that determines the result of comparing the values of the two dates.)

• شما می‌توانید از متدهای after( ) و before( ) برای بررسی تاریخ‌ها در ترتیب بعدی یا قبلی یکدیگر استفاده کنید. (You can use the after() and before() methods to check if dates are in a chronological order, either after or before each other.)

با استفاده از این روش‌ها، شما می‌توانید تاریخ‌ها را با یکدیگر مقایسه کنید و عملیات مورد نیاز را انجام دهید.

import java.util.*;
import java.text.*;

public class DateDemo {

   public static void main(String args[]) {
      Date dNow = new Date( );
      SimpleDateFormat ft = 
      new SimpleDateFormat ("E yyyy.MM.dd 'at' hh:mm:ss a zzz");

      System.out.println("Current Date: " + ft.format(dNow));
   }
}

این کد نتیجه زیر را تولید می‌کند −

خروجی

Current Date: Sun 2004.07.18 at 04:14:09 PM PDT

کدهای فرمت SimpleDateFormat ساده

برای تعیین فرمت زمان، از یک رشته الگوی زمان استفاده کنید. در این الگو، تمام حروف ASCII به عنوان حروف الگو رزرو شده‌اند و به شکل زیر تعریف می‌شوند −

فرمت‌بندی تاریخ با استفاده از printf

فرمت‌بندی تاریخ و زمان به سادگی با استفاده از متد printf انجام می‌شود. شما از یک فرمت دو حرفی استفاده می‌کنید، با شروع با حرف t و پایان با یکی از حروف جدول همانند کد زیر است.

مثال

import java.util.Date;
public class DateDemo {

   public static void main(String args[]) {
      // Instantiate a Date object
      Date date = new Date();

      // display time and date
      String str = String.format("Current Date/Time : %tc", date );

      System.out.printf(str);
   }
}

این عبارت نتیجه زیر را تولید می‌کند −

خروجی

Current Date/Time : Sat Dec 15 16:37:57 MST 2012

اگر بخواهید بارها تاریخ را برای فرمت‌بندی هر بخش وارد کنید، کمی احمقانه خواهد بود. به همین دلیل، یک رشته فرمت می‌تواند شاخص آرگومانی که باید فرمت شود را نشان دهد.

شاخص باید به‌طور مستقیم پس از % آمده و باید با $ خاتمه یابد.

مثال

import java.util.Date;
public class DateDemo {

   public static void main(String args[]) {
      // Instantiate a Date object
      Date date = new Date();
  
      // display time and date
      System.out.printf("%1$s %2$tB %2$td, %2$tY", "Due date:", date);
   }
}

این عبارت نتیجه زیر را تولید می‌کند −

خروجی

Due date: February 09, 2004

در صورت تمایل، می‌توانید از علامت < استفاده کنید. این علامت نشان می‌دهد که باید از همان آرگومانی که در قالب فرمت قبلی استفاده شده، دوباره استفاده شود.

مثال

import java.util.Date;
public class DateDemo {

   public static void main(String args[]) {
      // Instantiate a Date object
      Date date = new Date();
  
      // display formatted date
      System.out.printf("%s %tB %<te, %<tY", "Due date:", date);
   }
}

این عبارت نتیجه زیر را تولید می‌کند −

خروجی

Due date: February 09, 2004

کاراکترهای تبدیل تاریخ و زمان

کلاس‌های مفید دیگری هم در ارتباط با تاریخ و زمان وجود دارند. برای اطلاعات بیشتر، می‌توانید به مستندات استاندارد جاوا مراجعه کنید.

تجزیه رشته‌ها به تاریخ‌ها

کلاس SimpleDateFormat متدهای اضافی دیگری دارد، به ویژه متد parse() که سعی می‌کند یک رشته را بر اساس فرمت ذخیره شده در شیء SimpleDateFormat داده شده تجزیه کند.

مثال

import java.util.*;
import java.text.*;
  
public class DateDemo {

   public static void main(String args[]) {
      SimpleDateFormat ft = new SimpleDateFormat ("yyyy-MM-dd"); 
      String input = args.length == 0 ? "1818-11-11" : args[0]; 

      System.out.print(input + " Parses as "); 
      Date t;
      try {
         t = ft.parse(input); 
         System.out.println(t); 
      } catch (ParseException e) { 
         System.out.println("Unparseable using " + ft); 
      }
   }
}

اجرای نمونه‌ای از برنامه فوق نتیجه زیر را تولید خواهد کرد −

نتیجه

1818-11-11 Parses as Wed Nov 11 00:00:00 EST 1818

خوابیدن برای مدتی

شما می‌توانید برای هر بازه‌ی زمانی از یک میلی‌ثانیه تا عمر کامپیوتر خودتان بخوابید. به عنوان مثال، برنامه‌ی زیر برای ۳ ثانیه خواب می‌کند −

مثال

import java.util.*;
public class SleepDemo {

   public static void main(String args[]) {
      try { 
         System.out.println(new Date( ) + "\n"); 
         Thread.sleep(5*60*10); 
         System.out.println(new Date( ) + "\n"); 
      } catch (Exception e) {
         System.out.println("Got an exception!"); 
      }
   }
}

این عمل موجب تولید نتیجه‌ی زیر می‌شود −

خروجی

Sun May 03 18:04:41 GMT 2009
Sun May 03 18:04:51 GMT 2009

اندازه‌گیری زمان گذشته

گاهی اوقات، شما ممکن است نیاز داشته باشید تا زمان را به میلی‌ثانیه اندازه‌گیری کنید. بنابراین، بیایید مثال بالا را دوباره بنویسیم −

مثال

import java.util.*;
public class DiffDemo {

   public static void main(String args[]) {
      try {
         long start = System.currentTimeMillis( );
         System.out.println(new Date( ) + "\n");
         
         Thread.sleep(5*60*10);
         System.out.println(new Date( ) + "\n");
         
         long end = System.currentTimeMillis( );
         long diff = end - start;
         System.out.println("Difference is : " + diff);
      } catch (Exception e) {
         System.out.println("Got an exception!");
      }
   }
}

این به نتیجه زیر منجر خواهد شد −

خروجی

Sun May 03 18:16:51 GMT 2009
Sun May 03 18:16:57 GMT 2009
Difference is : 5993

کلاس GregorianCalendar

GregorianCalendar یک پیاده‌سازی محسوب می‌شود برای کلاس تقویم که تقویم گریگوری را با تقویمی که با آن آشنایی دارید، پیاده‌سازی می‌کند. ما در این آموزش درباره کلاس تقویم بحث نکردیم، شما می‌توانید در مستندات استاندارد جاوا به این مورد مراجعه کنید.

متد getInstance( ) از کلاس Calendar یک GregorianCalendar را با استفاده از تاریخ و زمان فعلی در محلیت و منطقه زمانی پیش فرض برمی‌گرداند. GregorianCalendar دو فیلد AD و BC را تعریف می‌کند که نمایانگر دو عصر تعریف شده توسط تقویم گریگوری هستند.

همچنین چندین سازنده برای اشیاء GregorianCalendar وجود دارد −

لطفاً توجه داشته باشید که این فهرست متدها مربوط به نسخه‌ی مشخص GPT-3.5 است و ممکن است در نسخه‌های جدیدتر Java تغییر کرده باشد.

در ادامه لیستی از چندین متد پشتیبان مفید ارائه شده توسط کلاس GregorianCalendar آورده شده است −

مثال

import java.util.*;
public class GregorianCalendarDemo {

   public static void main(String args[]) {
      String months[] = {"Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", 
         "Oct", "Nov", "Dec"};
      
      int year;
      // Create a Gregorian calendar initialized
      // with the current date and time in the
      // default locale and timezone.
      
      GregorianCalendar gcalendar = new GregorianCalendar();
      
      // Display current time and date information.
      System.out.print("Date: ");
      System.out.print(months[gcalendar.get(Calendar.MONTH)]);
      System.out.print(" " + gcalendar.get(Calendar.DATE) + " ");
      System.out.println(year = gcalendar.get(Calendar.YEAR));
      System.out.print("Time: ");
      System.out.print(gcalendar.get(Calendar.HOUR) + ":");
      System.out.print(gcalendar.get(Calendar.MINUTE) + ":");
      System.out.println(gcalendar.get(Calendar.SECOND));

      // Test if the current year is a leap year
      if(gcalendar.isLeapYear(year)) {
         System.out.println("The current year is a leap year");
      }else {
         System.out.println("The current year is not a leap year");
      }
   }
}

این عمل، نتیجه‌ی زیر را تولید خواهد کرد −

خروجی

Date: Apr 22 2009
Time: 11:25:27
The current year is not a leap year