APIزمان و تاریخ جدید در Java 8

API زمان و تاریخ جدید در Java 8

در Java 8 ، API جدیدی برای زمان و تاریخ ارائه شده است تا بتوان نواقص API قدیمی زیر را پوشش داد.

• امن نبودن ریسه: ریسه ی java.util.Date امن نیست. به همین دلیل برنامه نویسان باید در حین استفاده از تاریخ با مشکلات ارز دست و پنجه نرم کنند. این API جدید قابل تغییر نبوده و در آن از متدهای setter استفاده نشده است.
• طراحی ضعیف: تاریخ پیش فرض از سال 1900 و ماه آن از ژانویه و روز آن از 0 شروع می شود. به همین دلیل هیچ گونه یکنواختی در آن وجود ندارد. API قدیمی برای کارهای مربوط به تاریخ متدهای مستقیم کمتری داشت. API جدید برای چنین کارهایی متدهای کاربردی متعددی را فراهم می کند.
• رسیدگی دشوار به ساعت محلی: برنامه نویسان مجبور بودند جهت برطرف کردن مشکلات ساعت محلی کدهای بسیاری را بنویسند. API جدید این مشکل را به صورت نهادینه شده ای حل کرده است.

Java 8 این API جدید را تحت بسته ی java.time ارائه کرده است.

• محلی: زمان و تاریخ این API ساده بوده و خبری از پیچیدگی های مربوط به زمان محلی نیست.
• منطقه ای بودن: API تخصصی زمان و تاریخ جدید جهت رسیدگی به ساعت های محلی مختلف.

API زمان و تاریخ محلی در Java 8

کلاس های LocalDate/LocalTime و LocalDateTime در جاهایی که ساعت های محلی الزامی نیستند، می توانند برنامه نویسی را ساده کنند. بیایید در عمل به آن ها بپردازیم.
با استفاده از یکی از ویرایشگرهای مورد نظر خود، برنامه ی Javaی زیر را مثلا در C:\> JAVA ایجاد کنید.
Java8Tester.java

import java.time.LocalDate;
import java.time.LocalTime;
import java.time.LocalDateTime;
import java.time.Month;
public class Java8Tester {
   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testLocalDateTime();
   }
	
   public void testLocalDateTime() {
      // Get the current date and time
      LocalDateTime currentTime = LocalDateTime.now();
      System.out.println("Current DateTime: " + currentTime);
		
      LocalDate date1 = currentTime.toLocalDate();
      System.out.println("date1: " + date1);
		
      Month month = currentTime.getMonth();
      int day = currentTime.getDayOfMonth();
      int seconds = currentTime.getSecond();
		
      System.out.println("Month: " + month +"day: " + day +"seconds: " + seconds);
		
      LocalDateTime date2 = currentTime.withDayOfMonth(10).withYear(2012);
      System.out.println("date2: " + date2);
		
      //12 december 2014
      LocalDate date3 = LocalDate.of(2014, Month.DECEMBER, 12);
      System.out.println("date3: " + date3);
		
      //22 hour 15 minutes
      LocalTime date4 = LocalTime.of(22, 15);
      System.out.println("date4: " + date4);
		
      //parse a string
      LocalTime date5 = LocalTime.parse("20:15:30");
      System.out.println("date5: " + date5);
   }
}

نتیجه را بررسی کنید

با استفاده از کامپایلر javac مانند زیر این کلاس را کامپایل کنید.

C:\JAVA>javac Java8Tester.java

حالا Java8Tester را مانند زیر اجرا کنید.

C:\JAVA>java Java8Tester

نتیجه باید به صورت زیر نمایش داده شود.

Current DateTime: 2014-12-09T11:00:45.457
date1: 2014-12-09
Month: DECEMBERday: 9seconds: 45
date2: 2012-12-10T11:00:45.457
date3: 2014-12-12
date4: 22:15
date5: 20:15:30

API زمان و تاریخ منطقه ای در Java 8

این API در جاهایی کاربرد دارد که موقعیت زمانی باید لحاظ شود. بیایید در عمل به آن بپردازیم.
با استفاده از یکی از ویرایشگرهای مورد نظر خود، برنامه ی Javaی زیر را مثلا در C:\> JAVA ایجاد کنید.
Java8Tester.java

import java.time.ZonedDateTime;
import java.time.ZoneId;
public class Java8Tester {
   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testZonedDateTime();
   }
	
   public void testZonedDateTime() {
      // Get the current date and time
      ZonedDateTime date1 = ZonedDateTime.parse("2007-12-03T10:15:30+05:30[Asia/Karachi]");
      System.out.println("date1: " + date1);
		
      ZoneId id = ZoneId.of("Europe/Paris");
      System.out.println("ZoneId: " + id);
		
      ZoneId currentZone = ZoneId.systemDefault();
      System.out.println("CurrentZone: " + currentZone);
   }
}

نتیجه را بررسی کنید

با استفاده از کامپایلر javac این کلاس را مانند زیر کامپایل کنید.

C:\JAVA>javac Java8Tester.java

حالا Java8Tester را مانند زیر اجرا کنید.

C:\JAVA>java Java8Tester

نتیجه باید به صورت زیر نمایش داده شود.

date1: 2007-12-03T10:15:30+05:00[Asia/Karachi]
ZoneId: Europe/Paris
CurrentZone: Etc/UTC

شمارنده یChrono Units در Java 8

شمارنده ی java.time.temporal.ChronoUnit به Java 8 اضافه شده است تا به جای مقادیر صحیح موجود در APIقدیمی، روز، ماه و ... را نمایش دهد. بیایید در عمل به آن بپردازیم.
با استفاده از یکی از ویرایشگرهای مورد نظر خود، برنامه ی Javaی زیر را مثلا در C:\> JAVA ایجاد کنید.
Java8Tester.java

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;
public class Java8Tester {
   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testChromoUnits();
   }
	
   public void testChromoUnits() {
      //Get the current date
      LocalDate today = LocalDate.now();
      System.out.println("Current date: " + today);
		
      //add 1 week to the current date
      LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);
      System.out.println("Next week: " + nextWeek);
		
      //add 1 month to the current date
      LocalDate nextMonth = today.plus(1, ChronoUnit.MONTHS);
      System.out.println("Next month: " + nextMonth);
		
      //add 1 year to the current date
      LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);
      System.out.println("Next year: " + nextYear);
		
      //add 10 years to the current date
      LocalDate nextDecade = today.plus(1, ChronoUnit.DECADES);
      System.out.println("Date after ten year: " + nextDecade);
   }
}

نتیجه را بررسی کنید

با استفاده از کامپایلر javac این کلاس را مانند زیر کامپایل کنید.

C:\JAVA>javac Java8Tester.java

حالا Java8Tester را مانند زیر اجرا کنید.

C:\JAVA>java Java8Tester

نتیجه باید به صورت زیر نمایش داده شود.

Current date: 2014-12-10
Next week: 2014-12-17
Next month: 2015-01-10
Next year: 2015-12-10
Date after ten year: 2024-12-10

دوره و مدت در Java 8

در Java 8 جهت رسیدگی به اختلاف زمانی، دو کلاس ویژه ارائه شده اند.

• Period یا دوره: این کلاس بر اساس تاریخ به مقدار زمان رسیدگی می کند.
• Duration یا مدت: این کلاس بر اساس زمان به مقدار زمان رسیدگی می کند.

بیایید در عمل به آن بپردازیم.
با استفاده از یکی از ویرایشگرهای مورد نظر خود، برنامه ی Javaی زیر را مثلا در C:\> JAVA ایجاد کنید.
Java8Tester.java

import java.time.temporal.ChronoUnit;
import java.time.LocalDate;
import java.time.LocalTime;
import java.time.Duration;
import java.time.Period;
public class Java8Tester {
   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testPeriod();
      java8tester.testDuration();
   }
	
   public void testPeriod() {
      //Get the current date
      LocalDate date1 = LocalDate.now();
      System.out.println("Current date: " + date1);
		
      //add 1 month to the current date
      LocalDate date2 = date1.plus(1, ChronoUnit.MONTHS);
      System.out.println("Next month: " + date2);
      
      Period period = Period.between(date2, date1);
      System.out.println("Period: " + period);
   }
	
   public void testDuration() {
      LocalTime time1 = LocalTime.now();
      Duration twoHours = Duration.ofHours(2);
		
      LocalTime time2 = time1.plus(twoHours);
      Duration duration = Duration.between(time1, time2);
		
      System.out.println("Duration: " + duration);
   }
}

نتیجه را بررسی کنید

با استفاده از کامپایلر javac این کلاس را مانند زیر کامپایل کنید.

C:\JAVA>javac Java8Tester.java

حالا Java8Tester را مانند زیر اجرا کنید.

C:\JAVA>java Java8Tester

نتیجه باید به صورت زیر نمایش داده شود.

Current date: 2014-12-10
Next month: 2015-01-10
Period: P-1M
Duration: PT2H

تنظیم کننده های زمانی در Java 8

جهت انجام محاسبات ریاضی زمانی از TemporalAdjuster استفاده می شود. مثلا به دست آوردن دومین یکشنبه ی ماه یا سه شنبه ی هفته ی بعد. بیایید در عمل به آن بپردازیم.
با استفاده از یکی از ویرایشگرهای مورد نظر خود، برنامه ی Javaی زیر را مثلا در C:\> JAVA ایجاد کنید.
Java8Tester.java

import java.time.LocalDate;
import java.time.temporal.TemporalAdjusters;
import java.time.DayOfWeek;
public class Java8Tester {
   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testAdjusters();
   }
	
   public void testAdjusters() {
      //Get the current date
      LocalDate date1 = LocalDate.now();
      System.out.println("Current date: " + date1);
		
      //get the next tuesday
      LocalDate nextTuesday = date1.with(TemporalAdjusters.next(DayOfWeek.TUESDAY));
      System.out.println("Next Tuesday on : " + nextTuesday);
		
      //get the second saturday of next month
      LocalDate firstInYear = LocalDate.of(date1.getYear(),date1.getMonth(), 1);
      LocalDate secondSaturday = firstInYear.with(TemporalAdjusters.nextOrSame(
         DayOfWeek.SATURDAY)).with(TemporalAdjusters.next(DayOfWeek.SATURDAY));
      System.out.println("Second Saturday on : " + secondSaturday);
   }
}

نتیجه را بررسی کنید

با استفاده از کامپایلر javac این کلاس را مانند زیر کامپایل کنید.

C:\JAVA>javac Java8Tester.java

حالا Java8Tester را مانند زیر اجرا کنید.

C:\JAVA>java Java8Tester

نتیجه باید به صورت زیر نمایش داده شود.

Current date: 2014-12-10
Next Tuesday on : 2014-12-16
Second Saturday on : 2014-12-13

سازگاری وارونه در Java 8

متد toInstant() به تاریخ اصلی و اشیاء تقویم اضافه می شود که از آن می توان جهت تبدیل آن ها به API جدید استفاده کرد. جهت دریافت یک شیء LocalDateTime یا ZonedDateTime از یک متد ofInstant(Insant,ZoneId) استفاده کنید. بیایید در عمل به آن بپردازیم.
با استفاده از یکی از ویرایشگرهای مورد نظر خود، برنامه ی Javaی زیر را مثلا در C:\> JAVA ایجاد کنید.
Java8Tester.java

import java.time.LocalDateTime;
import java.time.ZonedDateTime;
import java.util.Date;
import java.time.Instant;
import java.time.ZoneId;
public class Java8Tester {
   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testBackwardCompatability();
   }
	
   public void testBackwardCompatability() {
      //Get the current date
      Date currentDate = new Date();
      System.out.println("Current date: " + currentDate);
		
      //Get the instant of current date in terms of milliseconds
      Instant now = currentDate.toInstant();
      ZoneId currentZone = ZoneId.systemDefault();
		
      LocalDateTime localDateTime = LocalDateTime.ofInstant(now, currentZone);
      System.out.println("Local date: " + localDateTime);
		
      ZonedDateTime zonedDateTime = ZonedDateTime.ofInstant(now, currentZone);
      System.out.println("Zoned date: " + zonedDateTime);
   }
}

نتیجه را بررسی کنید

با استفاده از کامپایلر javac این کلاس را مانند زیر کامپایل کنید.

C:\JAVA>javac Java8Tester.java

حالا Java8Tester را مانند زیر اجرا کنید.

C:\JAVA>java Java8Tester

Current date: Wed Dec 10 05:44:06 UTC 2014
Local date: 2014-12-10T05:44:06.635
Zoned date: 2014-12-10T05:44:06.635Z[Etc/UTC]

برای مطالعه سرفصل آموزش جاوا (J2SE) کلیک نمایید .