LocalDate, LocalTime और LocalDateTime: ये क्या हैं, तारीख के साथ काम

LocalDate, LocalTime और LocalDateTime क्या हैं?

LocalDate — एक क्लास जो बिना समय और समय क्षेत्र की जानकारी के वर्ष-महीना-दिन प्रारूप में तारीख का प्रतिनिधित्व करती है। इसका उपयोग जन्मदिन, घटना तिथियाँ या समाप्ति तिथियाँ जैसे डेटा संग्रहीत करने के लिए किया जाता है।

LocalDate -999999999 से +999999999 तक की सीमा में वर्ष, 1 से 12 तक महीना और लीप वर्ष को ध्यान में रखते हुए महीने का दिन संग्रहीत करता है। क्लास पूरी तरह से immutable है — कोई भी संक्रिया एक नई वस्तु लौटाती है।

LocalTime दिन के समय का प्रतिनिधित्व करता है: घंटे, मिनट, सेकंड और नैनोसेकंड। अधिकतम सटीकता एक नैनोसेकंड तक है। LocalTime में तारीख या समय क्षेत्र की कोई जानकारी नहीं होती, जो इसे स्टोर खुलने के समय या प्रक्रिया अवधि संग्रहीत करने के लिए सुविधाजनक बनाता है।

LocalDateTime LocalDate और LocalTime को एक वस्तु में जोड़ता है। यह सबसे अधिक उपयोग किया जाने वाला प्रकार है जब आपको तारीख और समय दोनों संग्रहीत करने की आवश्यकता होती है, लेकिन समय क्षेत्र के बंधन की आवश्यकता नहीं होती। उदाहरण के लिए, स्थानीय प्रारूप में एक संगीत कार्यक्रम की तारीख और समय।

Oracle Java दस्तावेज़ीकरण (2024) के अनुसार, तीनों क्लासेज़ Joda-Time लाइब्रेरी के विचारों पर आधारित हैं, लेकिन बेहतर आर्किटेक्चर और मानक लाइब्रेरी में पूर्ण एकीकरण के साथ।

java.time पैकेज कैसे काम करता है?

java.time पैकेज Java 8 में पुरानी Date, Calendar और SimpleDateFormat क्लासेज़ के प्रतिस्थापन के रूप में दिखाई दिया। इसकी आर्किटेक्चर immutable ऑब्जेक्ट्स और fluent-इंटरफ़ेस के सिद्धांतों पर बनी है।

मुख्य विशेषता — सभी मुख्य क्लासेज़ value-based हैं। इसका मतलब है कि उनके उदाहरण मान से तुलना किए जाते हैं, संदर्भ से नहीं, और उन्हें इनहेरिट नहीं किया जा सकता। दो वस्तुओं की तुलना करने के लिए equals विधि का उपयोग करें, == ऑपरेटर का नहीं।

पैकेज कई श्रेणियों में विभाजित है। बिना समय क्षेत्र के प्रकार — LocalDate, LocalTime, LocalDateTime — स्थानीय तारीखों और समय के लिए उपयोग किए जाते हैं। समय क्षेत्र वाले प्रकार — ZonedDateTime, OffsetDateTime, OffsetTime — ऑफ़सेट या क्षेत्र की जानकारी जोड़ते हैं। Instant प्रकार — Instant — UTC में समय रेखा पर एक बिंदु का प्रतिनिधित्व करते हैं।

यह विभाजन पुरानी API में निहित समस्या को हल करता है: डेवलपर कभी नहीं जानता था कि Date ऑब्जेक्ट में समय क्षेत्र की जानकारी है या नहीं। java.time में, प्रत्येक प्रकार स्पष्ट रूप से अपनी शब्दार्थ घोषित करता है।

LocalDate: तारीख के साथ काम

LocalDate क्लास तारीख बनाने, पढ़ने और संशोधित करने के लिए कई विधियाँ प्रदान करती है। वर्तमान तारीख स्थैतिक विधि now() के माध्यम से प्राप्त की जा सकती है। एक विशिष्ट तारीख — of(int year, int month, int dayOfMonth) विधि के माध्यम से।

तारीख के घटकों को पढ़ने के लिए गेटर्स का उपयोग किया जाता है: getYear(), getMonthValue(), getDayOfMonth(), getDayOfWeek(), getDayOfYear()। getMonth() विधि Month एनम लौटाती है, और getDayOfWeek() DayOfWeek एनम लौटाती है।

LocalDate तारीख जाँच का समर्थन करता है। isBefore(), isAfter() और isEqual() विधियाँ तारीखों की तुलना करने की अनुमति देती हैं। isLeapYear() विधि जाँचती है कि वर्ष लीप वर्ष है या नहीं। lengthOfMonth() विधि महीने में दिनों की संख्या लौटाती है, और lengthOfYear() वर्ष में दिनों की संख्या लौटाती है।

संशोधन के लिए withYear(), withMonth(), withDayOfMonth() विधियों का उपयोग किया जाता है, जो बदले गए घटक के साथ एक नई वस्तु लौटाती हैं। plusDays(), minusMonths() और समान विधियाँ तारीख अंकगणित करती हैं।

LocalTime: समय के साथ काम

LocalTime नैनोसेकंड सटीकता के साथ दिन के समय का प्रतिनिधित्व करता है। मानक प्रारूप ISO-8601 (HH:mm:ss.nnnnnnnnn) है। न्यूनतम मान 00:00 है, अधिकतम 23:59:59.999999999 है।

LocalTime ऑब्जेक्ट now() के साथ वर्तमान समय के लिए, of(int hour, int minute), of(int hour, int minute, int second) या of(int hour, int minute, int second, int nanoOfSecond) के साथ बनाया जा सकता है। parse(CharSequence text) विधि ISO-8601 प्रारूप में स्ट्रिंग को पार्स करती है।

गेटर्स में getHour(), getMinute(), getSecond(), getNano() शामिल हैं। toSecondOfDay() विधि दिन की शुरुआत से सेकंड की संख्या लौटाती है, और toNanoOfDay() नैनोसेकंड लौटाती है। यह एक दिन के भीतर अवधि की गणना के लिए सुविधाजनक है।

LocalTime LocalDate के समान तुलना और संशोधन संक्रियाओं का समर्थन करता है: plusHours(), minusMinutes(), withHour(), withMinute()। isBefore() और isAfter() विधियाँ इस बात को ध्यान में रखते हुए काम करती हैं कि समय एक दिन के भीतर चक्रीय है।

LocalDateTime: तारीख और समय का संयोजन

LocalDateTime एक ही क्लास में LocalDate और LocalTime की क्षमताओं को जोड़ता है। यह तारीख और समय दोनों संग्रहीत करता है, लेकिन समय क्षेत्र के बिना। यह सबसे लचीला स्थानीय प्रकार है, लेकिन वितरित सिस्टम में उपयोग करते समय सावधानी की आवश्यकता होती है।

LocalDateTime स्थैतिक विधियों now(), of(LocalDate date, LocalTime time), of(int year, Month month, int dayOfMonth, int hour, int minute) और उनके ओवरलोड के माध्यम से बनाया जा सकता है। LocalDate और LocalTime को atTime() विधि के माध्यम से भी जोड़ा जा सकता है।

LocalDateTime संबंधित गेटर्स के माध्यम से सभी तारीख और समय फ़ील्ड तक पहुँच प्रदान करता है: toLocalDate() और toLocalTime() अलग-अलग घटक लौटाते हैं। truncatedTo(TemporalUnit unit) विधि समय को दी गई सटीकता तक गोल करने की अनुमति देती है — उदाहरण के लिए, मिनटों तक।

समय क्षेत्र में रूपांतरण के लिए atZone(ZoneId zone) विधि का उपयोग किया जाता है, जो ZonedDateTime लौटाती है। LocalDateTime में समय क्षेत्र जोड़ने का यह एकमात्र तरीका है।

तारीख और समय की वस्तुएँ कैसे बनाएँ?

तीनों क्लासेज़ स्थैतिक फ़ैक्टरी विधियों के माध्यम से एकीकृत निर्माण पैटर्न का उपयोग करती हैं। क्लास कंस्ट्रक्टर्स को private घोषित किया गया है — new का उपयोग करके सीधे ऑब्जेक्ट नहीं बनाया जा सकता।

मुख्य निर्माण विधियाँ:

• now() — सिस्टम घड़ी से वर्तमान तारीख/समय
• of(...) — घटकों से (वर्ष, महीना, दिन, आदि)
• parse(String) — ISO-8601 प्रारूप में स्ट्रिंग से
• from(TemporalAccessor) — किसी अन्य टेम्पोरल ऑब्जेक्ट से

of विधि के कई ओवरलोड हैं। LocalDate के लिए वर्ष, महीना और दिन चाहिए। LocalTime के लिए — घंटे और मिनट (वैकल्पिक रूप से सेकंड और नैनोसेकंड)। LocalDateTime के लिए — वर्ष, महीना, दिन, घंटे, मिनट। महीने को int (1-12) या Month एनम के रूप में पास किया जा सकता है।

val today = LocalDate.now()
val specificDate = LocalDate.of(2026, Month.JULY, 21)
val parsedDate = LocalDate.parse("2026-07-21")

val currentTime = LocalTime.now()
val lunchTime = LocalTime.of(13, 30, 0)
val parsedTime = LocalTime.parse("13:30:00")

val now = LocalDateTime.now()
val meeting = LocalDateTime.of(2026, 7, 21, 15, 0)

प्रकारों के बीच रूपांतरण

java.time क्लासेज़ एक दूसरे में सुविधाजनक रूपांतरण के लिए डिज़ाइन की गई हैं। LocalDate को atTime(LocalTime) या atStartOfDay() विधि के माध्यम से LocalDateTime में रूपांतरित किया जा सकता है। LocalTime — atDate(LocalDate) के माध्यम से।

LocalDateTime को toLocalDate() के माध्यम से वापस LocalDate में और toLocalTime() के माध्यम से LocalTime में रूपांतरित किया जा सकता है। ZonedDateTime में रूपांतरण के लिए atZone(ZoneId) विधि का उपयोग किया जाता है।

java.util.Date में रूपांतरण (पुराने कोड के साथ संगतता के लिए) Instant और समय क्षेत्र के माध्यम से एक मध्यवर्ती चरण की आवश्यकता होती है। Baeldung (2024) के अनुसार, यह संक्रिया Date.from(instant) के माध्यम से की जाती है।

val date = LocalDate.of(2026, 7, 21)
val dateTime = date.atTime(LocalTime.of(10, 30))

val time = LocalTime.of(14, 0)
val dateTimeFromTime = time.atDate(date)

val extractedDate = dateTime.toLocalDate()
val extractedTime = dateTime.toLocalTime()

val zoned = dateTime.atZone(ZoneId.of("Europe/Moscow"))

फ़ॉर्मेटिंग और पार्सिंग

फ़ॉर्मेटिंग और पार्सिंग के लिए DateTimeFormatter क्लास का उपयोग किया जाता है। यह स्थिरांक (ISO_LOCAL_DATE, ISO_LOCAL_TIME, ISO_LOCAL_DATE_TIME) के माध्यम से पूर्वनिर्धारित प्रारूप और पैटर्न स्ट्रिंग के माध्यम से कस्टम प्रारूप बनाने की क्षमता प्रदान करता है।

फ़ॉर्मेटिंग पैटर्न प्रतीकों का उपयोग करते हैं: yyyy — वर्ष, MM — महीना (दो अंक), dd — दिन, HH — घंटा (0-23), mm — मिनट, ss — सेकंड। format() विधि तारीख-समय ऑब्जेक्ट पर या DateTimeFormatter के माध्यम से बुलाई जाती है।

DateTimeFormatter स्थैतिक विधियों ofLocalizedDate(FormatStyle), ofLocalizedTime(FormatStyle) और ofLocalizedDateTime(FormatStyle) के माध्यम से स्थानीयकरण का भी समर्थन करता है। उपलब्ध शैलियाँ SHORT, MEDIUM, LONG और FULL हैं।

val formatter = DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm")
val formatted = LocalDateTime.now().format(formatter)

val parsed = LocalDate.parse(
    "21.07.2026",
    DateTimeFormatter.ofPattern("dd.MM.yyyy")
)

तारीख-समय वस्तुओं की तुलना

तीनों क्लासेज़ Comparable इंटरफ़ेस लागू करती हैं, जो उन्हें प्राकृतिक रूप से तुलना करने की अनुमति देती है। compareTo() विधि क्रम के आधार पर ऋणात्मक संख्या, शून्य या धनात्मक संख्या लौटाती है। isBefore(), isAfter() और isEqual() विधियाँ बूलियन लौटाती हैं।

LocalDate के लिए, तुलना कालानुक्रमिक है — पहले की तारीख छोटी मानी जाती है। LocalTime के लिए — दिन के समय के अनुसार। LocalDateTime के लिए — पहले तारीख के अनुसार, फिर समय के अनुसार। सभी तुलनाएँ लीप वर्ष और महीनों में दिनों की संख्या को सही ढंग से ध्यान में रखती हैं।

पुरानी API से एक महत्वपूर्ण अंतर: LocalDate, LocalTime और LocalDateTime के लिए equals() मानों की तुलना करता है, संदर्भों की नहीं। इसका मतलब है कि समान फ़ील्ड वाली दो वस्तुएँ बराबर होंगी, भले ही वे अलग-अलग उदाहरण हों।

val d1 = LocalDate.of(2026, 7, 21)
val d2 = LocalDate.of(2026, 12, 25)

if (d1.isBefore(d2)) {
    Log.d("दिनांक", "d1, d2 से पहले है")
}

val sortedDates = listOf(d2, d1).sorted()

तारीख और समय अंकगणित

तीनों क्लासेज़ plus और minus विधियों के माध्यम से अंकगणितीय संक्रियाओं का समर्थन करती हैं। LocalDate के लिए plusDays(), plusWeeks(), plusMonths(), plusYears() और संबंधित minus विधियाँ उपलब्ध हैं। LocalTime plusHours(), plusMinutes(), plusSeconds(), plusNanos() का समर्थन करता है।

LocalDateTime दोनों प्रकारों से सभी अंकगणितीय संक्रियाएँ प्राप्त करता है। LocalDate की एक विशेषता: एक महीना जोड़ने पर, परिणाम विभिन्न महीनों की लंबाई को सही ढंग से संभालते हैं। उदाहरण के लिए, 31 जनवरी + 1 महीना = 28 (लीप वर्ष में 29) फरवरी।

अधिक जटिल संक्रियाओं के लिए Period क्लास (तारीखों के लिए) और Duration क्लास (समय के लिए) मौजूद हैं। plus(TemporalAmount) और minus(TemporalAmount) विधियाँ इन वस्तुओं को स्वीकार करती हैं।

val today = LocalDate.now()
val nextWeek = today.plusDays(7)
val nextMonth = today.plusMonths(1)
val lastYear = today.minusYears(1)

val now = LocalTime.now()
val inTwoHours = now.plusHours(2)
val halfHourAgo = now.minusMinutes(30)

Kotlin में कोड उदाहरण

आइए एक व्यावहारिक उदाहरण देखें: कार्य शिफ्ट ट्रैकिंग एप्लिकेशन। हमें शिफ्ट की अवधि की गणना करने और यह निर्धारित करने की आवश्यकता है कि यह रात के समय पर पड़ती है या नहीं। हम शुरुआत और समाप्ति समय के लिए LocalTime, तारीख के लिए LocalDate और आधी रात पार करने वाली शिफ्टों की गणना के लिए LocalDateTime का उपयोग करते हैं।

data class Shift(
    val startTime: LocalTime,
    val endTime: LocalTime,
    val date: LocalDate
) {
    fun isOvernight(): Boolean = endTime.isBefore(startTime)

    fun durationInMinutes(): Long {
        val start = LocalDateTime.of(date, startTime)
        val end = LocalDateTime.of(
            if (isOvernight()) date.plusDays(1) else date,
            endTime
        )
        return Duration.between(start, end).toMinutes()
    }
}

दूसरा उदाहरण — उपयोगकर्ता की आयु की गणना। हम जन्म तिथि के लिए LocalDate का उपयोग करते हैं और जन्म के दिन और महीने को ध्यान में रखते हुए वर्तमान तिथि से तुलना करते हैं।

fun calculateAge(birthDate: LocalDate): Int {
    val today = LocalDate.now()
    val period = Period.between(birthDate, today)
    return period.years
}

तीसरा उदाहरण — सूचनाओं के साथ काम। LocalDateTime का उपयोग अनुस्मारक शेड्यूल करने के लिए किया जाता है। हम जाँचते हैं कि निर्धारित समय आ गया है या नहीं।

data class Reminder(
    val id: Long,
    val scheduledAt: LocalDateTime
) {
    fun isDue(): Boolean =
        LocalDateTime.now().isAfter(scheduledAt)
}

Android समर्थन: API स्तर और Desugaring

java.time के लिए अंतर्निहित समर्थन Android पर API 26 (Android 8.0 Oreo) से दिखाई दिया। पुराने Android संस्करणों वाले उपकरणों के लिए, desugaring का उपयोग करना आवश्यक है — एक तंत्र जो प्रारंभिक संस्करणों में नई Java API के लिए समर्थन जोड़ता है।

Android Gradle Plugin में Desugaring compileOptions के माध्यम से build.gradle में कॉन्फ़िगर किया जाता है। बस isCoreLibraryDesugaringEnabled = true सेट करें और desugar_jdk_libs लाइब्रेरी जोड़ें। उसके बाद, java.time 14 से शुरू होने वाले सभी API स्तरों के लिए उपलब्ध हो जाता है।

उन परियोजनाओं के लिए जो desugaring का उपयोग नहीं कर सकती (उदाहरण के लिए, AGP 4.0 से नीचे की विरासत परियोजनाएँ), ThreeTenABP लाइब्रेरी मौजूद है — java.time का बैकपोर्ट। यह समान क्लासेज़ (LocalDate, LocalTime, LocalDateTime) प्रदान करती है, लेकिन org.threeten.bp पैकेज में।

@Suppress("UnstableApiUsage")
android {
    compileOptions {
        isCoreLibraryDesugaringEnabled = true
    }
}

dependencies {
    "coreLibraryDesugaring"("com.android.tools:desugar_jdk_libs:2.1.4")
}

सामान्य गलतियाँ और उनसे कैसे बचें

पहली सामान्य गलती — समय क्षेत्रों पर विचार किए बिना वितरित सिस्टम में LocalDateTime का उपयोग करना। यदि सर्वर Europe/Moscow में है और क्लाइंट Asia/Tokyo में है, तो LocalDateTime की अलग-अलग व्याख्या की जाएगी। समाधान: वैश्विक डेटा के लिए Instant या ZonedDateTime का उपयोग करें।

दूसरी गलती — गलत स्ट्रिंग पार्सिंग। डिफ़ॉल्ट रूप से, LocalDate.parse() ISO-8601 प्रारूप (yyyy-MM-dd) की अपेक्षा करता है। यदि स्ट्रिंग किसी अन्य प्रारूप में है, तो आपको स्पष्ट रूप से DateTimeFormatter पास करना होगा। आपको DateTimeParseException को भी संभालना चाहिए ताकि अमान्य इनपुट पर एप्लिकेशन क्रैश न हो।

तीसरी गलती — null सुरक्षा की अनदेखी करना। LocalDate, LocalTime और LocalDateTime ऐसी वस्तुएँ हैं जो null हो सकती हैं। Kotlin में, स्पष्ट जाँच या Elvis ऑपरेटर के साथ nullable प्रकार का उपयोग करने की अनुशंसा की जाती है। Java में — विधियों को कॉल करने से पहले null की जाँच करें।

चौथी गलती — LocalDateTime और ZonedDateTime के बीच भ्रम। LocalDateTime में समय क्षेत्र की कोई जानकारी नहीं होती। यदि आपको समय में एक पूर्ण क्षण पारित करने की आवश्यकता है — ज़ोनल प्रकार का उपयोग करें। यदि स्थानीय समय पर्याप्त है — स्थानीय प्रकार का उपयोग करें।