তারিখ ও সময় — java.time

১ · “সময়” এক শব্দ, চার অর্থ

চারটি বাক্য পড়ুন। “আমার জন্মদিন ১৫ আগস্ট।” “অফিস খোলে সকাল ৯টায়।” “আপনার bKash পেমেন্টটি হয়েছে ঠিক এই মুহূর্তে।” “পরীক্ষা চলবে ৩ ঘণ্টা।” চারটিতেই আমরা “সময়” নিয়ে কথা বলছি, কিন্তু আসলে চারটি একেবারে আলাদা জিনিস।

• ক্যালেন্ডারের তারিখ। জন্মদিন একটি দিন — তার সাথে কোনো ঘণ্টা-মিনিট নেই। আপনি লন্ডনে গেলেও আপনার জন্মদিন ১৫ আগস্টই থাকে।
• দেয়ালঘড়ির সময়। “সকাল ৯টা” প্রতিদিন আসে, আর ঢাকার অফিসের ৯টা আর লন্ডনের অফিসের ৯টা আলাদা মুহূর্ত — কিন্তু দুটিই “৯টা”।
• সময়রেখার একটি মুহূর্ত। পেমেন্টটি পৃথিবীর সব জায়গার জন্য একটি মাত্র মুহূর্তে ঘটেছে। ঢাকার ঘড়িতে সেটা সকাল ১০:৩০, নিউ ইয়র্কের ঘড়িতে রাত ১২:৩০ — কিন্তু মুহূর্ত একটাই।
• ব্যবধান। “৩ ঘণ্টা” কোনো নির্দিষ্ট সময়ে বাঁধা নয়; এটা একটি পরিমাণ। আর “৬ মাসের ঋণ”-ও ব্যবধান, কিন্তু ক্যালেন্ডারের — কারণ সব মাস সমান লম্বা নয়।

পুরোনো Java-তে এই চারটির জন্য প্রায় একটিই class ছিল: java.util.Date. নাম “Date”, অথচ ভেতরে রাখে একটি মুহূর্ত; ছাপলে দেখায় কম্পিউটারের নিজস্ব টাইম জোনে। ফলে জন্মদিন রাখতে গেলে তার সাথে অপ্রয়োজনীয় ঘণ্টা-মিনিট আর জোন জুড়ে যেত, আর সার্ভার অন্য দেশে সরালে জন্মদিন এক দিন সরে যাওয়ার মতো অদ্ভুত bug হতো।

Java 8-এ (২০১৪) এল নতুন package java.time, যা JSR 310 নামের একটি স্পেসিফিকেশনের ফল। এর মূল চিন্তা সহজ: প্রতিটি অর্থের জন্য আলাদা টাইপ, যাতে ভুল করে একটির জায়গায় আরেকটি বসালে compiler-ই আপত্তি করে। আর প্রতিটি টাইপ immutable — একবার তৈরি হলে বদলায় না।

২ · পুরোনো Date আর Calendar — কেন বদলাতে হলো

Java 1.0 (১৯৯৬) এসেছিল java.util.Date নিয়ে। পরের সংস্করণে এর বেশিরভাগ method deprecated হয়ে যায় আর আসে java.util.Calendar. দুটি মিলে যে পুরোনো date API, তা নিয়ে Java ডেভেলপাররা প্রায় দুই দশক ভুগেছেন। মূল সমস্যা তিনটি।

সমস্যা ১: মাস গোনা শুরু ০ থেকে

নিচের কোডের লেখক ২১ ফেব্রুয়ারি — ভাষা শহীদ দিবস — বোঝাতে চেয়েছিলেন। ফেব্রুয়ারি বছরের দ্বিতীয় মাস, তাই লিখেছেন 2:

Calendar cal = Calendar.getInstance();
cal.clear();
cal.set(2026, 2, 21);          // ২১ ফেব্রুয়ারি বোঝাতে চেয়েছিলেন
SimpleDateFormat f = new SimpleDateFormat("dd MMMM yyyy", Locale.ENGLISH);
System.out.println(f.format(cal.getTime()));

21 March 2026

ছাপা হলো মার্চ! কারণ Calendar-এ জানুয়ারি = ০, ফেব্রুয়ারি = ১, … ডিসেম্বর = ১১ (Calendar.DECEMBER-এর মান সত্যিই 11). অথচ দিন গোনা শুরু ১ থেকে। আরও খারাপ: cal.set(2026, 12, 16) লিখলে কোনো error হয় না — Calendar চুপচাপ পরের বছরে চলে যায়, আর ফল দাঁড়ায় ১৬ জানুয়ারি ২০২৭ (Java 21-এ চালিয়ে যাচাই করা)। ভুল মান দিলে থামানোর বদলে “বুঝে নেওয়া” — এই নরম আচরণ (lenient) bug লুকিয়ে রাখে।

সমস্যা ২: mutable — যে কেউ বদলে দিতে পারে

Date আর Calendar দুটিই mutable: date.setTime(...) বা cal.add(...) ডাকলে সেই object-ই বদলে যায়। ধরুন একটি Loan object তার শুরুর তারিখ হিসেবে একটি Date রাখে, আর getter সেই Date-টিই ফেরত দেয়। বাইরের কোনো কোড সেটার ওপর setTime ডাকলে ঋণের শুরুর তারিখই বদলে গেল — Loan টেরও পেল না। পর্ব ১৭-এর defensive copy ছাড়া এর প্রতিকার নেই।

সমস্যা ৩: SimpleDateFormat thread-safe নয়

তারিখকে লেখায় রূপ দিতে ব্যবহার হতো SimpleDateFormat. এটি বানাতে একটু খরচ হয়, তাই অনেকে একটি static formatter বানিয়ে পুরো অ্যাপে ভাগ করতেন। কিন্তু এর ভেতরে একটি Calendar field আছে, যা প্রতিটি format বা parse-এর সময় বদলায়। ফলে দুটি thread একসাথে ব্যবহার করলে একজনের তারিখ আরেকজনের ফলে মিশে যেতে পারে — ভুল তারিখ, বা অদ্ভুত exception, তাও শুধু চাপের সময়। একে thread-safe নয় বলে; পর্ব ৪০-এ thread নিয়ে বিস্তারিত দেখবেন। java.time-এর DateTimeFormatter immutable, তাই নিশ্চিন্তে static final রাখা যায়।

৩ · java.time-এর মানচিত্র — কোন কাজে কোন টাইপ

java.time-এ অনেক class, কিন্তু প্রতিদিনের কাজে লাগে মোটামুটি নিচের কয়েকটি। ছাপলে কেমন দেখায়, সেটাও দেওয়া আছে — সবগুলো আন্তর্জাতিক মান ISO-8601 অনুযায়ী (বছর-মাস-দিন, তারপর T, তারপর সময়):

নামের “Local” শব্দটি নতুনদের বিভ্রান্ত করে। এর মানে “এই এলাকার” নয়, বরং “কোনো জোনের তথ্য নেই” — যে দেখছেন, তাঁর স্থানীয় ঘড়ির সাপেক্ষে পড়তে হবে। তাই LocalDateTime একা কোনো মুহূর্ত নির্দেশ করে না: “২৬ মার্চ সকাল ১০:৩০” ঢাকায় এক মুহূর্ত, নিউ ইয়র্কে আরেক। আর Instant-এর শেষের Z মানে “Zulu” বা UTC — শূন্য অফসেট। Month enum থাকায় LocalDate.of(2026, Month.FEBRUARY, 21)-ও লেখা যায়, আর java.time-এ মাসের সংখ্যা স্বাভাবিক: ফেব্রুয়ারি = ২।

এবার চারটি বাস্তব পরিস্থিতিতে টাইপ বাছাইয়ের চিন্তাটা ধাপে ধাপে দেখুন:

LocalDate birth = LocalDate.of(2004, 8, 15);
→ 2004-08-15
ঘণ্টা লাগে না, জোনও না — LocalDate

LocalTime open = LocalTime.of(9, 0);
→ 09:00
প্রতিদিনের নিয়ম, কোনো দিনে বাঁধা নয়

Instant paidAt = Instant.parse("2026-03-26T04:30:00Z");
→ 2026-03-26T04:30:00Z
ডেটাবেসে এভাবেই রাখুন; দেখানোর সময় জোন

ZonedDateTime.of(2026, 11, 2, 20, 0, 0, 0,
                 ZoneId.of("Asia/Dhaka"))
→ 2026-11-02T20:00+06:00[Asia/Dhaka]

Duration.ofMinutes(135)  → PT2H15M
Period.ofMonths(6)       → P6M
ঘণ্টা-মিনিট: Duration; বছর-মাস-দিন: Period

৪ · তৈরি, হিসাব আর তুলনা

java.time-এ কোনো public constructor নেই; object বানানো হয় static factory method দিয়ে। দুটি সবচেয়ে বেশি লাগে:

LocalDate d1 = LocalDate.of(2026, 2, 21);              // সংখ্যা দিয়ে
LocalDate d2 = LocalDate.parse("2026-02-21");           // ISO লেখা থেকে
LocalTime t  = LocalTime.parse("09:15");
LocalDateTime dt = LocalDateTime.parse("2026-02-21T09:15");
Duration exam = Duration.parse("PT1H30M");              // ১ ঘণ্টা ৩০ মিনিট
Period loan   = Period.parse("P1Y2M");                  // ১ বছর ২ মাস

ভুল মান দিলে java.time পুরোনো Calendar-এর মতো “বুঝে নেয়” না, সাথে সাথে থামে। LocalDate.of(2026, 2, 30) দেয় java.time.DateTimeException: Invalid date 'FEBRUARY 30', আর LocalDate.of(2026, 13, 1) দেয় Invalid value for MonthOfYear (valid values 1 - 12): 13 (দুটিই Java 21-এ যাচাই করা)। ভুল যেখানে, ধরা পড়ল সেখানেই।

হিসাব — প্রতিবার নতুন object

plusDays, minusMonths, plusYears, withDayOfMonth — সব method নতুন object ফেরত দেয়; মূলটি বদলায় না। এটা immutable হওয়ার অর্থ, আর এখানেই নতুনদের প্রথম ভুল:

LocalDate x = LocalDate.of(2026, 2, 21);
x.plusDays(1);                 // ফল কোথাও রাখা হয়নি — হারিয়ে গেল
System.out.println(x);         // 2026-02-21, বদলায়নি
x = x.plusDays(1);             // ঠিক: নতুন object ভ্যারিয়েবলে রাখুন

পর্ব ৮-এ String-এর toUpperCase() নিয়ে ঠিক এই কথাই দেখেছিলেন। লাভটাও একই: একটি LocalDate যত জায়গায় ইচ্ছা ভাগ করুন, কেউ সেটা বদলে দিতে পারবে না — পুরোনো Date-এর সমস্যা ২ এখানে নেই।

মাস-শেষের নিয়ম — ৩১ জানুয়ারি + ১ মাস

ধরুন কেউ ৩১ জানুয়ারি ঋণ নিলেন, প্রতি মাসে একই তারিখে কিস্তি। ফেব্রুয়ারিতে তো ৩১ তারিখ নেই! java.time-এর নিয়ম: মাস যোগ করার পর দিনটি সেই মাসে না থাকলে, সেই মাসের শেষ বৈধ দিনে নামিয়ে আনা হয়। ২০২৬ সাল leap year নয়, তাই ফল ২৮ ফেব্রুয়ারি; ২০২৮ সালে একই হিসাব দেয় ২৯ ফেব্রুয়ারি। কিন্তু এর পরে একটি সূক্ষ্ম ফাঁদ আছে, ধাপে ধাপে দেখুন:

1LocalDate start = LocalDate.of(2026, 1, 31);2LocalDate feb  = start.plusMonths(1);3LocalDate mar1 = feb.plusMonths(1);    // চেইন4LocalDate mar2 = start.plusMonths(2);  // মূল থেকে5// কিস্তি i: start.plusMonths(i)

তুলনা

দুটি তারিখ বা সময় তুলনা করতে isBefore, isAfter, isEqual, আর মান সমান কি না দেখতে equals. java.time-এর class-গুলো value-based class, তাই == দিয়ে তুলনা করবেন না — একই তারিখের দুটি object একই object হবে, এমন নিশ্চয়তা নেই। এগুলো Comparable-ও (পর্ব ৩৩), তাই তারিখের তালিকা সরাসরি sort করা যায়।

এবার এই অংশের তিনটি বাস্তব হিসাব একসাথে চালান — জন্মতারিখ থেকে বয়স, মাসিক কিস্তির তারিখ, আর লাইব্রেরির জরিমানা। লক্ষ করুন, “আজ” হিসেবে now() নয়, একটি নির্দিষ্ট তারিখ দেওয়া — তাই যতবার, যেদিনই চালান, ফল একই:

import java.time.*;
import java.time.temporal.ChronoUnit;

class Main {
    public static void main(String[] args) {
        LocalDate birth = LocalDate.of(2004, 8, 15);
        LocalDate today = LocalDate.of(2026, 10, 18);     // now() নয়, নির্দিষ্ট দিন
        Period age = Period.between(birth, today);
        System.out.println("বয়স: " + age.getYears() + " বছর " + age.getMonths()
                + " মাস " + age.getDays() + " দিন (" + age + ")");
        System.out.println("মোট দিন: " + ChronoUnit.DAYS.between(birth, today));

        LocalDate loan = LocalDate.of(2026, 1, 31);       // ঋণ নেওয়ার দিন
        for (int i = 1; i <= 4; i++)
            System.out.println("কিস্তি " + i + ": " + loan.plusMonths(i));

        LocalDate due = LocalDate.of(2026, 10, 5);         // বই ফেরতের শেষ দিন
        LocalDate returned = LocalDate.of(2026, 10, 18);
        long late = Math.max(0, ChronoUnit.DAYS.between(due, returned));
        System.out.println("দেরি " + late + " দিন, জরিমানা " + late * 5 + " টাকা");
        System.out.println(returned.isAfter(due) + ", ফেরত " + returned.getDayOfWeek());
    }
}

৫ · Period বনাম Duration — ক্যালেন্ডারের ব্যবধান আর ঘড়ির ব্যবধান

দুটিই “কত সময়”, কিন্তু মাপার একক আলাদা, আর সেজন্য অর্থও আলাদা। Duration মাপে সেকেন্ড আর ন্যানোসেকেন্ডে — যেন একটি স্টপওয়াচ। Period মাপে বছর, মাস আর দিনে — যেন দেয়ালের ক্যালেন্ডার। “১ দিন” কথাটিও দুই জগতে আলাদা: Duration.ofDays(1) মানে ঠিক ২৪ ঘণ্টা (ছাপলে PT24H), আর Period.ofDays(1) মানে “ক্যালেন্ডারে পরের দিন, একই ঘড়ির সময়” — যা DST-এর দিনে ২৩ বা ২৫ ঘণ্টাও হতে পারে (অংশ ৭)।

Period age = Period.between(LocalDate.of(2004, 8, 15),
                            LocalDate.of(2026, 10, 18));
// P22Y2M3D — ২২ বছর ২ মাস ৩ দিন
LocalDate end = LocalDate.of(2026, 1, 31).plus(Period.ofMonths(6));

Instant start = Instant.parse("2026-03-26T04:30:00Z");
Instant end   = Instant.parse("2026-03-26T06:45:30Z");
Duration d = Duration.between(start, end);   // PT2H15M30S
long minutes = d.toMinutes();                // 135

Duration.between(LocalDate.of(2026, 1, 1), LocalDate.of(2026, 2, 1));

java.time.temporal.UnsupportedTemporalTypeException: Unsupported unit: Seconds

ChronoUnit হলো সময়ের এককগুলোর একটি enum — DAYS, WEEKS, MONTHS, HOURS, MINUTES ইত্যাদি। এর between method মোট পরিমাণ দেয় একটি সংখ্যায়, যা প্রায়ই Period-এর চেয়ে কাজের। খেয়াল করুন, Period.getDays() শুধু “বাকি দিন” দেয় (ওপরের উদাহরণে ৩), মোট দিন নয় — লাইব্রেরির জরিমানায় Period.between(...).getDays() লিখলে দুই মাস দেরিতেও জরিমানা আসবে মাত্র কয়েক দিনের। মোট দিনের জন্য সবসময় ChronoUnit.DAYS.between.

৬ · লেখা থেকে তারিখ, তারিখ থেকে লেখা — DateTimeFormatter

ISO রূপ 2026-02-21 কম্পিউটারের জন্য চমৎকার — বর্ণক্রমে সাজালেই সময়ক্রমে সাজানো হয়ে যায়। কিন্তু বাংলাদেশে মানুষ লেখেন 21/02/2026. এই রূপান্তরের যন্ত্র DateTimeFormatter:

static final DateTimeFormatter BD = DateTimeFormatter.ofPattern("dd/MM/uuuu");

String s = LocalDate.of(2026, 2, 21).format(BD);   // "21/02/2026"
LocalDate d = LocalDate.parse("21/02/2026", BD);   // 2026-02-21

immutable আর thread-safe বলে static final রাখা নিরাপদ — SimpleDateFormat-এর ঠিক উল্টো। প্যাটার্নের অক্ষরগুলো বড়-ছোট হাতের ওপর নির্ভর করে, আর এখানেই অনেক ভুল হয়:

mm ভুলটি বেশ নিরীহ দেখায়, কিন্তু LocalDate-এর ওপর "dd/mm/uuuu" দিয়ে format করলে প্রোগ্রাম থামে UnsupportedTemporalTypeException: Unsupported field: MinuteOfHour দিয়ে — তারিখে মিনিট নেই। আর uuuu বনাম yyyy? yyyy মানে “যুগের বছর” (খ্রিস্টাব্দ/খ্রিস্টপূর্ব যুগের ভেতরে), uuuu মানে সরল বছর-সংখ্যা। সাধারণ ব্যবহারে দুটির ফল এক। পার্থক্য ধরা পড়ে কঠোর যাচাইয়ে: ResolverStyle.STRICT দিলে yyyy যুগ (era) না জেনে তারিখ বানাতে পারে না, তাই "21/02/2026" parse ব্যর্থ হয়। তাই অনেক অভিজ্ঞ ডেভেলপার java.time-এ uuuu লেখেন।

ভুল ইনপুট — DateTimeParseException

ব্যবহারকারীর লেখা তারিখ ভুল হতেই পারে। তখন আসে DateTimeParseException — একটি unchecked exception, যার বার্তা বেশ পরিষ্কার (সব Java 21-এ যাচাই করা):

LocalDate.parse("21-02-2026", BD)
→ Text '21-02-2026' could not be parsed at index 2

LocalDate.parse("21/02/2026")            // formatter ছাড়া = ISO ধরে নেয়
→ Text '21/02/2026' could not be parsed at index 0

LocalDate.parse("2026-02-30")
→ Text '2026-02-30' could not be parsed: Invalid date 'FEBRUARY 30'

“index 2” মানে লেখার তৃতীয় অক্ষরে (গোনা ০ থেকে) সমস্যা — সেখানে / আশা করা হয়েছিল, পাওয়া গেল -. ফর্মে তারিখ নিলে এই exception ধরে ব্যবহারকারীকে বলুন “তারিখ দিন/মাস/বছর রূপে লিখুন”.

বাংলায় মাস আর দিনের নাম — Locale

মাস বা দিনের নাম কোন ভাষায় আসবে, তা ঠিক করে Locale. Locale না দিলে আসে কম্পিউটারের ডিফল্ট ভাষায় — আপনার ল্যাপটপে এক রকম, সার্ভারে আরেক রকম। তাই সবসময় স্পষ্ট করে দিন:

var bn = DateTimeFormatter.ofPattern("d MMMM uuuu, EEEE", Locale.forLanguageTag("bn"));
var en = DateTimeFormatter.ofPattern("d MMMM uuuu, EEEE", Locale.ENGLISH);
LocalDate d = LocalDate.of(2026, 2, 21);
System.out.println(d.format(bn));   // 21 ফেব্রুয়ারী 2026, শনিবার
System.out.println(d.format(en));   // 21 February 2026, Saturday

Java 21-এ যাচাই করে দেখা গেছে: bn Locale-এ মাসের নাম আসে জানুয়ারী, ফেব্রুয়ারী, মার্চ … ডিসেম্বর, আর দিনের নাম সোমবার … রবিবার। দুটি জিনিস খেয়াল করুন। এক, বানান JDK-র ভেতরের Unicode CLDR ডেটা থেকে আসে (“ফেব্রুয়ারী”, দীর্ঘ ঈ-কার) — বাংলা একাডেমির প্রমিত বানান “ফেব্রুয়ারি” চাইলে নিজের তালিকা বানাতে হবে। দুই, অঙ্ক থেকে যায় ইংরেজি (21, 2026); বাংলা অঙ্ক চাইলে আলাদা ব্যবস্থা লাগে। আর এগুলো খ্রিস্টীয় ক্যালেন্ডারের মাসের বাংলা নাম — বৈশাখ-জ্যৈষ্ঠের বঙ্গাব্দ নয়; বঙ্গাব্দের জন্য JDK-তে কোনো তৈরি ক্যালেন্ডার নেই।

৭ · টাইম জোন — ঢাকা, নিউ ইয়র্ক আর লন্ডন

একটি টাইম জোন শুধু “UTC থেকে কত ঘণ্টা এগিয়ে বা পিছিয়ে” নয়; এটা একটি অঞ্চলের ঘড়ির পুরো ইতিহাস ও নিয়ম — কবে কত অফসেট ছিল, কবে বদলাবে। এই নিয়মগুলো রাখা হয় IANA time zone database-এ, আর JDK নিজের ভেতরে এর একটি কপি নিয়ে আসে। জোনের নাম লেখা হয় “মহাদেশ/শহর” রূপে: Asia/Dhaka, America/New_York, Europe/London. ভুল নাম দিলে: ZoneRulesException: Unknown time-zone ID: Asia/Dhak.

ঢাকা এখন UTC+6, আর বাংলাদেশে বর্তমানে কোনো DST (daylight saving time) নেই — সারা বছর একই অফসেট। (২০০৯ সালে অল্প সময়ের জন্য ছিল; ভাবনার প্রশ্ন ২-এ সেই ইতিহাস।) কিন্তু যুক্তরাষ্ট্র আর যুক্তরাজ্যে আছে: বসন্তে ঘড়ি এক ঘণ্টা এগোয়, শরতে পেছায়। ২০২৬ সালে নিউ ইয়র্কে ঘড়ি এগোবে ৮ মার্চ, পেছাবে ১ নভেম্বর; লন্ডনে এগোবে ২৯ মার্চ (JDK-র জোন-নিয়ম থেকে যাচাই করা)। ফলে ঢাকা আর নিউ ইয়র্কের পার্থক্য বছরের কিছু সময় ১০ ঘণ্টা, কিছু সময় ১১ ঘণ্টা। “নিউ ইয়র্ক = ঢাকা − ১১ ঘণ্টা” হার্ডকোড করা কোড বছরের অর্ধেক সময় ভুল।

একটি মুহূর্ত ভিন্ন শহরের ঘড়িতে কেমন দেখায়, ধাপে ধাপে দেখুন:

1Instant pay = Instant.parse("2026-03-26T04:30:00Z");2var dhaka  = pay.atZone(ZoneId.of("Asia/Dhaka"));3var ny     = pay.atZone(ZoneId.of("America/New_York"));4var london = pay.atZone(ZoneId.of("Europe/London"));5dhaka.isEqual(ny);  dhaka.equals(ny);

এই নীতির পেছনের যুক্তি: মুহূর্ত কখনো দ্ব্যর্থক হয় না, কিন্তু স্থানীয় সময় হতে পারে। তবে ব্যতিক্রম আছে। ভবিষ্যতের মানুষের ঘটনা — “আগামী বছর ১৫ মার্চ সকাল ১০টায় ঢাকায় মিটিং” — অনেক সময় স্থানীয় সময় আর জোন হিসেবে রাখাই ভালো, কারণ ততদিনে সরকার জোনের নিয়ম বদলে দিলে মানুষ আসবেন “সকাল ১০টায়”, পুরোনো হিসাবের মুহূর্তে নয়। OffsetDateTime শুধু একটি নির্দিষ্ট অফসেট (+06:00) রাখে, জোনের নিয়ম নয় — API-তে সময় আদান-প্রদানে এটা বেশ চলে, কারণ লেখাটি দ্ব্যর্থহীন।

প্রতিটি দিন ২৪ ঘণ্টার নয় — DST-এর ফাঁক

নিউ ইয়র্কে ৮ মার্চ ২০২৬ রাত ২টায় ঘড়ি সরাসরি ৩টায় লাফ দেবে। অর্থাৎ সেদিন ২:০০ থেকে ২:৫৯ পর্যন্ত কোনো সময় সেখানে অস্তিত্বই রাখে না। আর সেদিন মাত্র ২৩ ঘণ্টার। ZonedDateTime দিয়ে “নিউ ইয়র্কে ৮ মার্চ ২:৩০” বানাতে চাইলে Java ফাঁকের দৈর্ঘ্য পরিমাণ এগিয়ে দেয়: ফল 03:30-04:00. নভেম্বরের উল্টো দিনে ১:০০–১:৫৯ দুইবার আসে, দিনটি ২৫ ঘণ্টার। তাই “দিন = ২৪ ঘণ্টা” ধরে নেওয়া কোড — যেমন plusHours(24) দিয়ে “কাল একই সময়” বের করা — DST অঞ্চলে বছরে দুইবার ভুল করে। “কাল একই ঘড়ির সময়” চাইলে plusDays(1), “ঠিক ২৪ ঘণ্টা পরে” চাইলে plusHours(24) — দুটি আলাদা প্রশ্ন।

৮ · Clock, TemporalAdjusters আর বাস্তব হিসাব

now() সবখানে নয় — Clock দিয়ে টেস্টযোগ্য কোড

একটি ডেলিভারি অ্যাপের কথা ভাবুন: “৩ কর্মদিবসের মধ্যে পৌঁছাবে।” কোডটি যদি ভেতরে LocalDate.now() ডাকে, তাহলে এর টেস্ট আজ পাস করবে, কাল হয়তো ফেল করবে — কারণ ফল নির্ভর করে কোন দিন চালাচ্ছেন তার ওপর। বৃহস্পতিবারে অর্ডার হলে শুক্র-শনি বাদ যাওয়ার নিয়ম ঠিক আছে কি না, সেটা টেস্ট করতে কি বৃহস্পতিবার পর্যন্ত অপেক্ষা করবেন?

সমাধান Clock. java.time-এর সব now() method-এর একটি রূপ আছে যা একটি Clock নেয়: LocalDate.now(clock), Instant.now(clock). আসল অ্যাপে দিন Clock.systemDefaultZone() বা Clock.system(ZoneId.of("Asia/Dhaka")); টেস্টে দিন Clock.fixed(...) — যে ঘড়ি সবসময় একই মুহূর্ত দেখায়। ঘড়িকে বাইরে থেকে পাঠানো — এটা পর্ব ২১-এর dependency injection, আর fixed clock আসলে একটি সহজ mock. পর্ব ৪৭-এ JUnit দিয়ে এভাবেই টেস্ট লিখবেন।

TemporalAdjusters — “পরের শুক্রবার”, “মাসের শেষ দিন”

অনেক ব্যবসার নিয়ম ক্যালেন্ডার-ভাষায় লেখা: “বেতন মাসের শেষ দিনে”, “মিটিং পরের রবিবার”. এগুলোর জন্য TemporalAdjusters-এ তৈরি নিয়ম আছে, যা with(...)-এ দিতে হয়। ১৮ অক্টোবর ২০২৬ (রবিবার) থেকে যাচাই করা ফল:

LocalDate t = LocalDate.of(2026, 10, 18);                         // রবিবার
t.with(TemporalAdjusters.next(DayOfWeek.FRIDAY));                // 2026-10-23
t.with(TemporalAdjusters.lastDayOfMonth());                      // 2026-10-31
t.with(TemporalAdjusters.lastInMonth(DayOfWeek.THURSDAY));       // 2026-10-29
t.with(TemporalAdjusters.next(DayOfWeek.SUNDAY));                // 2026-10-25
t.with(TemporalAdjusters.nextOrSame(DayOfWeek.SUNDAY));          // 2026-10-18

শেষ দুই লাইনের পার্থক্য লক্ষ করুন: next আজ রবিবার হলেও পরের রবিবারে যায়, nextOrSame আজকেই থাকে। একটি পরীক্ষার রুটিন বানাতে — রবিবার আর বুধবারে পরীক্ষা, ১৮ অক্টোবরের পর থেকে — একটি EnumSet<DayOfWeek> (পর্ব ২৪) আর একটি লুপই যথেষ্ট:

Set<DayOfWeek> examDays = EnumSet.of(DayOfWeek.SUNDAY, DayOfWeek.WEDNESDAY);
var f = DateTimeFormatter.ofPattern("dd/MM/uuuu EEEE", Locale.forLanguageTag("bn"));
LocalDate e = LocalDate.of(2026, 10, 18);
for (String subject : List.of("বাংলা", "ইংরেজি", "গণিত", "ICT")) {
    do { e = e.plusDays(1); } while (!examDays.contains(e.getDayOfWeek()));
    System.out.println(subject + " → " + e.format(f));
}

ছাপা হয় (Java 21-এ যাচাই করা): বাংলা → 21/10/2026 বুধবার, ইংরেজি → 25/10/2026 রবিবার, গণিত → 28/10/2026 বুধবার, ICT → 01/11/2026 রবিবার. সরকারি ছুটির দিনও বাদ দিতে চাইলে একটি Set<LocalDate> রেখে লুপের শর্তে যোগ করুন — LocalDate-এর equals আর hashCode মান-ভিত্তিক, তাই Set-এ ঠিকঠাক কাজ করে।

এবার সব একসাথে: fixed clock দিয়ে ডেলিভারির কর্মদিবস (শুক্র-শনি বাদ), ঢাকা থেকে নিউ ইয়র্কে মিটিংয়ের সময় DST-এর আগে ও পরে, আর DST-এর দিনের দৈর্ঘ্য। বাংলাদেশে সরকারি অফিসে শুক্র-শনি সাপ্তাহিক ছুটি, তবে অনেক প্রতিষ্ঠানে নিয়ম আলাদা — তাই আসল কোডে ছুটির দিনগুলো কনফিগারেশন থেকে আসা উচিত।

import java.time.*;
import java.time.format.DateTimeFormatter;
import java.util.Locale;

class Main {
    static final ZoneId DHAKA = ZoneId.of("Asia/Dhaka"), NY = ZoneId.of("America/New_York");
    static LocalDate deliveryDate(Clock clock, int workingDays) {
        LocalDate d = LocalDate.now(clock);                // ঘড়ি বাইরে থেকে আসে
        while (workingDays > 0) {
            d = d.plusDays(1);
            if (d.getDayOfWeek() != DayOfWeek.FRIDAY && d.getDayOfWeek() != DayOfWeek.SATURDAY) workingDays--;
        }
        return d;
    }
    public static void main(String[] args) {
        Clock clock = Clock.fixed(Instant.parse("2026-10-15T04:00:00Z"), DHAKA);
        System.out.println("অর্ডার " + LocalDateTime.now(clock) + ", ডেলিভারি " + deliveryDate(clock, 3));
        DateTimeFormatter bn = DateTimeFormatter.ofPattern("d MMMM, EEEE", Locale.forLanguageTag("bn"));
        for (LocalDate day : new LocalDate[] { LocalDate.of(2026, 10, 26), LocalDate.of(2026, 11, 2) }) {
            ZonedDateTime meet = ZonedDateTime.of(day, LocalTime.of(20, 0), DHAKA);
            System.out.println(meet.format(bn) + " | ঢাকা " + meet.toLocalTime() + " = নিউ ইয়র্ক "
                    + meet.withZoneSameInstant(NY).toLocalTime() + " | UTC " + meet.toInstant());
        }
        ZonedDateTime m = ZonedDateTime.of(LocalDate.of(2026, 3, 8), LocalTime.MIDNIGHT, NY);
        System.out.println("৮ মার্চ নিউ ইয়র্কের দিন: " + Duration.between(m, m.plusDays(1)));
    }
}

সাধারণ ভুলের তালিকা

৯ · AI-এর যুগে — তারিখ-সময়ের কোড যাচাই

তারিখ-সময়ের bug সবচেয়ে বিপজ্জনক এই কারণে যে এগুলো বছরের বেশিরভাগ সময় লুকিয়ে থাকে। AI-এর লেখা কোড demo-তে নিখুঁত চলে, কারণ demo চলে আজ, আপনার ল্যাপটপে, ঢাকার জোনে। সমস্যা দেখা দেয় ৩১ ডিসেম্বরে, DST-এর রাতে, বা সার্ভার বিদেশে সরানোর পর। AI শিখেছে ইন্টারনেটের কোটি কোটি লাইন থেকে, যার বড় অংশ java.time আসার আগের — তাই নিচের ভুলগুলো খুব সাধারণ।

সবচেয়ে সূক্ষ্মটি week-based year: প্যাটার্নে yyyy-এর জায়গায় YYYY. বছরের বেশিরভাগ দিনে দুটির ফল এক, তাই টেস্টে ধরা পড়ে না। কিন্তু Locale.US-এ ৩০ ডিসেম্বর ২০২৬ format করলে YYYY-MM-dd দেয় 2027-12-30 — পুরো এক বছর সামনে! কারণ যুক্তরাষ্ট্রের নিয়মে সপ্তাহ শুরু রবিবারে, আর ২৭ ডিসেম্বর (রবিবার) থেকে শুরু হওয়া সপ্তাহে ১ জানুয়ারি ২০২৭ আছে, তাই পুরো সপ্তাহটি “২০২৭-এর প্রথম সপ্তাহ”। Locale.UK-এ (ISO নিয়ম) উল্টো ঘটনা: ১ জানুয়ারি ২০২৭ দেখায় 2026-01-01 (দুটিই Java 21-এ যাচাই করা)। অর্থাৎ ভুলটি Locale-ভেদে বছরের শেষে বা শুরুতে আসে।

AI-এর কোড হাতে পেলে — যাচাইয়ের চেকলিস্ট

• কোথাও java.util.Date, Calendar বা SimpleDateFormat নেই (পুরোনো লাইব্রেরির সীমানা ছাড়া)
• ব্যবসার কোডে সরাসরি now() নেই; Clock বাইরে থেকে আসে
• বিশ্বব্যাপী মুহূর্ত Instant-এ; LocalDateTime শুধু যেখানে জোন সত্যিই অপ্রাসঙ্গিক
• প্যাটার্নে YYYY, DD বা তারিখে mm নেই; Locale স্পষ্ট
• কোনো অফসেট বা “২৪ ঘণ্টা = এক দিন” হার্ডকোড নেই
• plus.../minus...-এর ফল ভ্যারিয়েবলে রাখা হয়েছে
• টেস্টে মাস-শেষ, leap year, বছরের শেষ সপ্তাহ আর DST-এর দিন আছে