تاریخ و زمان در جاوا (Java Date and Time)

در جاوا، یک کلاس داخلی مخصوص تاریخ و زمان وجود ندارد، اما می‌توان از بسته‌ی java.time استفاده کرد که شامل کلاس‌های مختلف برای کار با تاریخ و زمان است. در ادامه با مهم‌ترین کلاس‌های این بسته آشنا می‌شویم:

کلاس	توضیح
LocalDate	نمایش تاریخ (سال، ماه، روز) به‌صورت yyyy-MM-dd
LocalTime	نمایش زمان (ساعت، دقیقه، ثانیه و نانوثانیه) به‌صورت HH-mm-ss-ns
LocalDateTime	نمایش تاریخ و زمان به‌صورت yyyy-MM-dd-HH-mm-ss-ns
DateTimeFormatter	فرمت‌بندی و تبدیل تاریخ و زمان به قالب‌های مختلف

۱. نمایش تاریخ جاری

برای نمایش تاریخ امروز از کلاس LocalDate و متد now() استفاده می‌کنیم:

مثال:

import java.time.LocalDate; // ایمپورت کلاس LocalDate

public class Main {
    public static void main(String[] args) {
        LocalDate myDate = LocalDate.now(); // ایجاد شیء تاریخ جاری
        System.out.println("تاریخ امروز: " + myDate);
    }
}

خروجی نمونه:

تاریخ امروز: 2025-02-01

💡 تمرین: کدی بنویسید که تاریخ امروز را دریافت کند و سال جاری را به‌تنهایی چاپ کند.

۲. نمایش زمان جاری

برای نمایش ساعت، دقیقه، ثانیه و نانوثانیه‌ی کنونی از کلاس LocalTime و متد now() استفاده می‌کنیم:

مثال:

import java.time.LocalTime; // ایمپورت کلاس LocalTime

public class Main {
    public static void main(String[] args) {
        LocalTime myTime = LocalTime.now(); // دریافت زمان جاری
        System.out.println("زمان کنونی: " + myTime);
    }
}

خروجی نمونه:

زمان کنونی: 16:33:37.974243

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

۳. نمایش تاریخ و زمان جاری

برای نمایش تاریخ و زمان به‌صورت هم‌زمان از کلاس LocalDateTime و متد now() استفاده می‌کنیم:

مثال:

import java.time.LocalDateTime; // ایمپورت کلاس LocalDateTime

public class Main {
    public static void main(String[] args) {
        LocalDateTime myDateTime = LocalDateTime.now(); // دریافت تاریخ و زمان جاری
        System.out.println("تاریخ و زمان کنونی: " + myDateTime);
    }
}

خروجی نمونه:

تاریخ و زمان کنونی: 2025-02-01T16:33:37.974370

💡 سوال: چرا در خروجی بین تاریخ و زمان یک T وجود دارد؟ 🤔
🔹 T فقط یک جداکننده بین تاریخ و زمان است.

۴. فرمت‌بندی تاریخ و زمان

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

مثال:

import java.time.LocalDateTime; // ایمپورت کلاس LocalDateTime
import java.time.format.DateTimeFormatter; // ایمپورت کلاس DateTimeFormatter

public class Main {
    public static void main(String[] args) {
        LocalDateTime myDateTime = LocalDateTime.now(); // دریافت تاریخ و زمان جاری
        System.out.println("قبل از فرمت‌بندی: " + myDateTime);

        DateTimeFormatter myFormat = DateTimeFormatter.ofPattern("dd-MM-yyyy HH:mm:ss"); // تعیین قالب سفارشی
        String formattedDate = myDateTime.format(myFormat); // تبدیل به قالب جدید

        System.out.println("بعد از فرمت‌بندی: " + formattedDate);
    }
}

خروجی نمونه:

قبل از فرمت‌بندی: 2025-02-01T16:33:37.975166
بعد از فرمت‌بندی: 01-02-2025 16:33:37

۵. قالب‌های مختلف برای تاریخ و زمان

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

قالب	خروجی نمونه
yyyy-MM-dd	1988-09-29
dd/MM/yyyy	29/09/1988
dd-MMM-yyyy	29-Sep-1988
E, MMM dd yyyy	Thu, Sep 29 1988

💡 چالش: کدی بنویسید که تاریخ امروز را به‌صورت چهارشنبه، ۲۹ سپتامبر ۱۹۸۸ نمایش دهد.

جمع‌بندی

🔹 جاوا کلاس داخلی مخصوص تاریخ و زمان ندارد، اما بسته‌ی java.time این امکان را فراهم می‌کند.
🔹 کلاس‌های مهم در این بسته شامل LocalDate، LocalTime، LocalDateTime و DateTimeFormatter هستند.
🔹 می‌توان تاریخ و زمان جاری را دریافت و در قالب‌های مختلف نمایش داد.

✅ تمرین پیشنهادی:
یک برنامه بنویسید که زمان فعلی را دریافت کند و فقط ساعت و دقیقه را چاپ کند. 💡