Java – Date and Time:

[برای مشاهده لینک ها شما باید عضو سایت باشید برای عضویت در سایت بر روی اینجا کلیک بکنید]
جاوا متغیر گروه Date را در پوشه ی java.util ارائه می دهد. این گروه تاریخ و زمان جاری را کپسوله می کند (encapsulate).
گروه Date دو سازنده را پشتیبانی می کند. اولین سازنده آبجکت را با تاریخ و زمان جاری مقدار دهی می کند.
Date( )


سازنده ی بعدی یک [برای مشاهده لینک ها شما باید عضو سایت باشید برای عضویت در سایت بر روی اینجا کلیک بکنید]را می پذیرد که برابر تعداد هزارم ثانیه هایی است که از نیمه شب اول ژانویه ی 1970 گذشته است.
Date(long millisec)

زمانی که شما یک Date object در دسترس دارید، می توانید برای بازی با تاریخ ها هرکدام از متودهای پشتیبانی زیر را فرا بخوانید:

SN	Methods with Description
1	boolean after(Date date) اگر فراخوانی Date object حاوی یک تاریخ باشد که دیرتر از تاریخی است که توسط date مشخص شده، true گزارش می دهد، در غیر این صورت false.
2	boolean before(Date date) اگر فراخوانی Date object حاوی یک تاریخ باشد که رودتر از تاریخی است که توسط date مشخص شده، true گزارش می دهد، در غیر این صورت false.
3	Object clone( ) فراخوانی Date object را تکرار می کند.
4	int compareTo(Date date) مقدار فراخوانی آبجکت را با مقدار مربوط به تاریخ مقایسه می کند. اگر مقادیر برابر باشند، 0 گزارش می دهد. اگر آبجکت فراخوانی زودتر از تاریخ باشد، یک مقدار منفی گزارش می دهد. اگر آبجکت فراخوانی دیرتر از تاریخ باشد، یک مقدار مثبت گزارش می دهد.
5	int compareTo(Object obj) اگر obj از گروه Date باشد، عینا برای مقایسه ی To(Date) عمل می کند. در غیر این صورت یک ClassCastException وارد می کند.
6	boolean equals(Object date) اگر فراخوانی Date object حاوی همان تاریخ و زمانی باشد که توسط date مشخص شد، true گزارش می دهد، در غیر اینصورت false گزارش می دهد.
7	long getTime( ) تعداد هزارم ثانیه هایی را که از اول ژانویه ی 1970 سپری شده، نشان می دهد.
8	int hashCode( ) یک کد hash برای فراخوانی آبجکت گزارش می دهد.
9	void setTime(long time) تاریخ و زکان را طوریکه با time مشخص شده، تنظیم می کند، که یک زمان سپری شده به هزارم ثانیه از نیمه شب اول ژانویه 1970 نشان می دهد.
10	String toString( ) آبجکت Date فراخوانی شده را به یک رشته تغییر می دهد و نتیجه را بازمی گرداند.

به دست آوردن Date و Time فعلی:
به دست آوردن تاریخ و زمان فعلی در جاوا بسیار آسان می باشد. شما می توانید از یک آبجکت 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());  }}

---

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

کد:

---

Mon May 04 09:51:52 CDT 2009

---

مقایسه ی تاریخ:
سه روش برای مقایسه ی تاریخ وجود دارد که در زیر مشاهده می کنید:

• می توانید برای تعیین تعداد هزارم ثانیه هایی که از نیمه شب اول ژانویه ی 1970 گذشته است، برای هر دو آبجکت، از getTime( ) استفاده کنید و سپس این دو مقدار را با یکدیگر مقایسه کنید.
• می توانید از متودهای before( ), after( ), و equals( ) استفاده کنید. به عنوان مثال از آنجایی که دوازدهم ماه قبل از هجدهم می آید، عبارت جدید before( ), after( ), and equals( ) دارای گزارش true می باشد.
• شما می توانید از متود compareTo( ) استفاده کنید که توسط اینترفیس Comparable تعریف شده و به وسیله ی Date اجرا می شود.

طراحی تاریخ با استفاده از SimpleDateFormat:
SimpleDateFormat یک گروه ملموس برای طراحی و تجزیه ی تاریخ ها به یک روش هوشمند داخلی می باشد. SimpleDateFormat به شما اجازه می دهد تا با انتخاب هرکدام از الگوهای تعریف شده توسط کاربر برای طراحی date – time شروع کنید.

کد:

---

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

---

فرمت ساده ی کدهای [برای مشاهده لینک ها شما باید عضو سایت باشید برای عضویت در سایت بر روی اینجا کلیک بکنید]:
برای تعیین فرمت زمان از یک رشته الگوی زمان استفاده کنید. در این الگو همه ی حروف ASCII به عنوان حروف پیش فرض در نظر گرفته شده اند که مانند زیر تعریف شده اند:

Character	Description	Example
G	Era designator	AD
y	Year in four digits سال چهار رقمی	2001
M	Month in year ماه در سال	July or 07
d	Day in month روز در ماه	10
h	Hour in A.M./P.M. (1~12) ساعت در صبح / بعد از ظهر	12
H	Hour in day (0~23) ساعت در روز	22
m	Minute in hour دقیقه در ساعت	30
s	Second in minute ثانیه در دقیقه	55
S	Millisecond هزارم ثانیه	234
E	Day in week روز در هفته	Tuesday
D	Day in year روز در سال	360
F	Day of week in month روز هفته در ماه	2 (second Wed. in July)
w	Week in year هفته در سال	40
W	Week in month هفته در ماه	1
a	A.M./P.M. marker نشانگر قبل از ظهر / بعد از ظهر	PM
k	Hour in day (1~24) ساعت در روز	24
K	Hour in A.M./P.M. (0~11) ساعت قبل از ظهر / بعد از ظهر	10
z	Time zone منطقه ی زمانی	Eastern Standard Time
'	Escape for text	Delimiter
"	Single quote	`

طراحی تاریخ با استفاده از 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 using toString()    String str = String.format("Current Date/Time : %tc", date );      System.out.printf(str);  }}

---

این مثال نتیجه ی زیر را به دنبال خواهد داشت:

کد:

---

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

---

اگر مجبور باشید برای طراحی هر بخش، تاریخ را چند بار ارائه دهید، ممکن است کمی احمقانه به نظر برسد. به همین دلیل یک رشته می تواند ایندکس مربوط به argument را نشان دهد تا طراحی شود.
ایندکس باید فورا با % دنبال شود و با $ پایان یابد. برای مثال:

کد:

---

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.printf("%1$s %2$tB %2$td, %2$tY",                          "Due date:", date);  }}

---

این مثال نتیجه ی زیر را به دنبال دارد:

کد:

---

Due date: February 09, 2004

---

متناوبا می توانید از < flag نیز استفاده کنید. این نشان می دهد که همان argument در فرمت تعیین شده ی قبل باید مجددا مورد استفاده قرار بگیرد. برای مثال:

کد:

---

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

---

کاراکترهای تبدیل Date و Time:

Character	Description	Example
c	Complete date and time تاریخ و زمان کامل	Mon May 04 09:51:52 CDT 2009
F	ISO 8601 date	2004-02-09
D	U.S. formatted date (month/day/year) فرمت امریکایی تاریخ	02/09/2004
T	24-hour time زمان 24 ساعت	18:05:19
r	12-hour time زمان 12 ساعت	06:05:19 pm
R	24-hour time, no seconds زمان 24 ساعت، بدون ثانیه	18:05
Y	Four-digit year (with leading zeroes) زمان چهار رقمی با صفر	2004
y	Last two digits of the year (with leading zeroes) دو رقم آخر سال ( با صفر)	04
C	First two digits of the year (with leading zeroes) دو رقم اول سال (با صفر)	20
B	Full month name نام کامل ماه	February
b	Abbreviated month name نام اختصاری ماه	Feb
m	Two-digit month (with leading zeroes) ماه دو رقمی ( با صفر)	02
d	Two-digit day (with leading zeroes) روز دو رقمی (با صفر)	03
e	Two-digit day (without leading zeroes) روز دو رقمی (بدون صفر)	9
A	Full weekday name نام کامل روز های هفته	Monday
a	Abbreviated weekday name نام اختصاری روزهای هفته	Mon
j	Three-digit day of year (with leading zeroes) روز سه رقمی سال (با صفر)	069
H	Two-digit hour (with leading zeroes), between 00 and 23 ساعت دو رقمی (با صفر) بین 00 و 23.	18
k	Two-digit hour (without leading zeroes), between 0 and 23 ساعت دو رقمی (بدون صفر)، بین 0 و 23	18
I	Two-digit hour (with leading zeroes), between 01 and 12 ساعت دو رقمی (با صفر)، بین 01 و 12.	06
l	Two-digit hour (without leading zeroes), between 1 and 12 ساعت دو رقمی (بدون صفر)، بین 1 و 12.	6
M	Two-digit minutes (with leading zeroes) دقیقه ی دو رقمی (با صفر)	05
S	Two-digit seconds (with leading zeroes) ثانیه ی دو رقمی (با صفر)	19
L	Three-digit milliseconds (with leading zeroes) هزارم ثانیه سه رقمی (با صفر)	047
N	Nine-digit nanoseconds (with leading zeroes) نانو ثانیه نه رقمی (با صفر)	047000000
P	Uppercase morning or afternoon marker نشانگر صبح یا بعداز ظهر با حروف بزرگ	PM
p	Lowercase morning or afternoon marker نشانگر صبح یا بعداز ظهر با حروف کوچک	pm
z	RFC 822 numeric offset from GMT افست عددی RFC 822 از GMT	-0800
Z	Time zone منطقه ی زمانی	PST
s	Seconds since 1970-01-01 00:00:00 GMT	1078884319
Q	Milliseconds since 1970-01-01 00:00:00 GMT	1078884319047

گروه های مفید دیگری در ارتباط با تاریخ و زمان وجود دارند. برای جزئیات بیشتر می توانید به مستندات استاندارد جاوا مراجعه کنید.
تجزیه ی رشته ها به تاریخ ها:
گروه 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);      }  }}

---

یک نمونه اجرا از مثال بالا نتیجه ی زیر را به دنبال خواهد داشت:
$ java DateDemo1818-11-11 Parses as Wed Nov 11 00:00:00 GMT 1818$ java DateDemo 2007-12-012007-12-01 Parses as Sat Dec 01 00:00:00 GMT 2007

خوابیدن برای مدتی:
شما می توانید برای هر مدت زمانی که دلخواهتان است، از یک هزارم ثانیه تا طول دوره ی زندگی کامپیوتر خود، بخوابید. برای مثال برنامه ی زیر به مدت 10 ثانیه به خواب می رود:

کد:

---

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 یک اجرای ملموس از یک گروه Calendar است که یک تقویم میلادی معمولی را که با آن آشنا هستید، اجرا می کند. من در مورد گروه Calander در این آموزش بحث نکردم، شما می توانید در این مورد مستندسازی استاندارد جاوا را مورد بررسی قرار دهید.
متود getInstance( ) از تقویم یک GregorianCalendar را بازمی گرداند که با تاریخ و زمان فعلی در محل و منطقه ی زمانی پیش فرض مقدار دهی شده است: AD و BC. اینها نشانگر دو عصر تعریف شده توسط تقویم میلادی می باشند.
چندین سازنده برای آبجکت های GregorianCalendar وجود دارد:

SN	Constructor with Description
1	GregorianCalendar() با استفاده از زمان حاضر در منطقه ی زمانی پیش فرض با محل پیش فزض، یک GregorianCalendar پیش فرض می سازد.
2	GregorianCalendar(int year, int month, int date) یک GregorianCalendar پیش فرض با تاریخ تنظیم شده ی ارائه شده در منطقه ی زمانی پیش فرض با محل پیش فرض، یک GregorianCalendar می سازد.
3	GregorianCalendar(int year, int month, int date, int hour, int minute) Constructs a GregorianCalendar with the given date and time set for the default time zone with the default locale. با تاریخ و زمان ارائه شده برای منطقه ی زمانی پیش فرض در محل پیش فرض، یک GregorianCalendar می سازد.
4	GregorianCalendar(int year, int month, int date, int hour, int minute, int second) با تاریخ و زمان تنظیم شده برای منطقه ی زمانی پیش فرض در محل پیش فرض، یک GregorianCalendar می سازد.
5	GregorianCalendar(Locale aLocale) براساس زمان کنونی در منطقه ی زمانی پیش فرض با محل پیش فرض، یک GregorianCalendar می سازد.
6	GregorianCalendar(TimeZone zone) براساس زمان کنونی در منطقه ی زمانی پیش فرض با محل پیش فرض، یک GregorianCalendar می سازد.
7	GregorianCalendar(TimeZone zone, Locale aLocale) براساس زمان کنونی در منطقه ی زمانی پیش فرض با محل پیش فرض، یک GregorianCalendar می سازد.

در اینجا لیستی از متودهای مفید ارائه شده توسط گروه GregorianCalendar را مشاهده می کنید:

SN	Methods with Description
1	void add(int field, int amount) براساس قوانین تقویم، مقدار مشخصی زمان را به فیلد ارائه شده ی زمان اضافه می کند.
2	protected void computeFields() UTC را به هزارم ثانیه به مقادیر فیلد زمان تبدیل می کند.
3	protected void computeTime() تبدیل UTC در هزارم ثانیه به مقادیر فیلد زمان را لغو می کند.
4	boolean equals(Object obj) GregorianCalendar را با یک آبجکت مرجع مقایسه می کند.
5	int get(int field) مقدار را برای یک فیلد زمان ارائه شده به دست می آورد.
6	int getActualMaximum(int field) حداکثر مقداری را که این فیلد می تواند داشته باشد، گزارش می دهد، با توجه به تاریخ جاری.
7	int getActualMinimum(int field) حداقل مقداری را که این فیلد می تواند داشته باشد، گزارش می دهد، با توجه به تاریخ جاری.
8	int getGreatestMinimum(int field) بالاترین minimum را برای فیلد ارائه شده گزارش می دهد، اگر متفوت باشد.
9	Date getGregorianChange() تاریخ تغییر Gregorian Calendar را به دست می آورد.
10	int getLeastMaximum(int field) کمترین maximum را برای فیلد ارائه شده گزارش می دهد، اگر متفاوت باشد.
11	int getMaximum(int field) مقدار حداکثر را برای فیلد ارائه شده گزارش می دهد.
12	Date getTime() زمان جاری این تقویم را به دست می آورد.
13	long getTimeInMillis() زمان جاری این تقویم را به عنوان یک long به دست می آورد.
14	TimeZone getTimeZone() منطقه ی زمانی را به دست می آورد.
15	int getMinimum(int field) حداقل مقدار را برای فیلد ارائه شده گزارش می دهد.
16	int hashCode() hashCode را لغو می کند.
17	boolean isLeapYear(int year) اگر سال ارائه شده کبیسه باشد، مشخص می کند.
18	void roll(int field, boolean up) یک واحد مجزا از زمان را به به فیلد ارائه شده اضافه می کند و یا از آن کم می کند، بدون اینکه در فیلدهای بزرگتر تغییری ایجاد شود.
19	void set(int field, int value) فیلد زمان را با استفاده از مقدار ارائه شده تنظیم می کند.
20	void set(int year, int month, int date) مقادیری برای فیلدهای year، month و date تنظیم می کند.
21	void set(int year, int month, int date, int hour, int minute) مقادیری برای فیلدهای year، month ، hour وminute، date تنظیم می کند.
22	void set(int year, int month, int date, int hour, int minute, int second) مقادیری برای فیلدهای year، month و date، hour، minute و second تنظیم می کند.
23	void setGregorianChange(Date date) تاریخ تغییر GregorianCalendar را تنظیم می کند.
24	void setTime(Date date) زمان فعلی این تقویم را با تاریخ ارائه شده تنظیم می کند.
25	void setTimeInMillis(long millis) زمان فعلی این تقویم را از مقدار ارائه شده ی long تنظیم می کند.
26	void setTimeZone(TimeZone value) مطقه ی زمانی را با مقدار منطقه ی زمانی ارائه شده تنظیم می کند.
27	String toString() یک رشته که نشانگر این تقویم می باشد را گزارش می دهد.

مثال:

کد:

---

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 2009Time: 11:25:27The current year is not a leap year

برای داشتن لیست کاملی از ثابت در دسترس در گروه [برای مشاهده لینک ها شما باید عضو سایت باشید برای عضویت در سایت بر روی اینجا کلیک بکنید] می توانید به اسناد استاندارد جاوا مراجعه کنید.
سلام دوستان عزیز، من این مطالب رو از سایت [برای مشاهده لینک ها شما باید عضو سایت باشید برای عضویت در سایت بر روی اینجا کلیک بکنید] مطالعه کردم. بنظرم مفید و کاربردی هستند. شما هم بخونید.تشکر