Java Notes
HubWhat Is Java?History of JavaFeatures of JavaJava EditionsJDK, JRE, and JVMYour First Java ProgramJava Program StructureJava Compilation ProcessIdentifiers in JavaKeywords in JavaVariables in JavaData Types in JavaType Casting in JavaOperators in JavaInput and Output in JavaComments in JavaIf-Else Statements in JavaSwitch-Case in JavaFor Loop in JavaWhile Loop in JavaDo-While Loop in JavaNested Loops in Javabreak and continue in JavaArray IntroductionOne Dimensional ArrayMulti Dimensional ArrayJagged Array in JavaArray OperationsArray Programs — FundamentalsArray Interview QuestionsString Class in JavaImmutable Strings in JavaString MethodsStringBuilder in JavaStringBuffer in JavaString Programs — FundamentalsString Interview QuestionsOOPs IntroductionClass and Object in JavaConstructor in Javathis Keyword in Javastatic Keyword in JavaEncapsulation in JavaInheritance in Javasuper Keyword in JavaPolymorphism in JavaMethod Overloading in JavaMethod Overriding in JavaAbstraction in JavaAbstract Class in JavaInterface in JavaObject Class in JavaWrapper Class in JavaInner Class in JavaAnonymous Class in JavaObject Cloning in JavaJava Collections Framework OverviewGenerics in JavaArrayList in JavaLinkedList in JavaVector in JavaStack in JavaHashSet in JavaLinkedHashSet in JavaTreeSet in JavaPriorityQueue in JavaArrayDeque in JavaDeque Interface in JavaHashMap in JavaLinkedHashMap in JavaTreeMap in JavaHashtable in JavaIterator in JavaComparable vs Comparator in JavaJava Collections Practice ProgramsException Handling IntroductionException Hierarchy in JavaTry-Catch Block in JavaFinally Block in Javathrow and throws Keywords in JavaCustom Exceptions in JavaException Handling Best PracticesFile Class in JavaByte Streams in JavaCharacter Streams in JavaBuffered Streams in JavaSerialization in JavaDeserialization in JavaJava NIO PackageLambda Expression in Java 8Functional Interface in Java 8Method Reference in Java 8Default and Static Methods in InterfacesStream API in Java 8Optional Class in Java 8Date and Time API in Java 8Thread IntroductionThread Life Cycle in JavaThread Class in JavaRunnable Interface in JavaCreating Threads in JavaThread Priority in JavaDaemon Threads in JavaSynchronization in JavaInter-Thread Communication in JavaExecutor Framework in JavaMultithreading Programs in JavaJDBC IntroductionJDBC ArchitectureMySQL Connection with JDBCStatement Interface in JDBCPreparedStatement in JDBCResultSet in JDBCCallableStatement in JDBCTransaction Management in JDBCBatch Processing in JDBCJDBC ProjectsServlet IntroductionGenericServletHttpServletServlet Life CycleRequest and Response ObjectsCookies in ServletsSession TrackingJSP IntroductionJSP Tags and JSTLExpression Language (EL)MVC ArchitectureSpring Framework IntroductionSpring Core ContainerSpring BeansDependency InjectionSpring Boot IntroductionREST API with Spring BootValidation in Spring BootCRUD ApplicationSpring Data JPAException Handling in Spring BootSpring SecurityJWT Authentication — Java ProgrammingConfig ServerEureka Server - Service DiscoveryAPI GatewayDocker DeploymentTime ComplexityRecursion in JavaLinked List in JavaStack in Java — DSA in JavaQueue in JavaHashing in JavaSorting Algorithms in JavaSearching Algorithms in JavaTree Data Structure in JavaHeap (DSA)Graph Data Structure in JavaDynamic Programming in JavaSingleton Design PatternFactory Design PatternBuilder Design PatternAdapter Design PatternObserver Design PatternMVC Pattern — Java ProgrammingBasic Java ProgramsArray Programs — PracticeString Programs — PracticeOOP ProgramsCollection ProgramsMultithreading ProgramsJDBC ProgramsPlacement Coding QuestionsStudent Management System — Java ProgrammingEmployee Management SystemLibrary Management System — Java ProgrammingBanking System — Java ProgrammingChat ApplicationE-Commerce BackendSpring Boot Fullstack ProjectCore Java Interview QuestionsOOPs Interview QuestionsCollections Interview QuestionsMultithreading Interview QuestionsJDBC Interview QuestionsSpring Framework Interview QuestionsCoding Interview QuestionsJava Cheat SheetQuick Revision Notes — Java ProgrammingImportant Java ProgramsImportant Formulas & ConceptsJava Master Course - Learning Roadmap
Complete guide to java.time package — LocalDate, LocalTime, LocalDateTime, ZonedDateTime, Duration, Period, formatting, parsing, and migration from legacy Date/Calendar.
Why a New Date/Time API?
The old java.util.Date and java.util.Calendar classes were fundamentally broken:
| Problem | Old API | New API (java.time) |
|---|---|---|
| Mutability | Date is mutable (thread-unsafe) | All classes are immutable |
| Month indexing | January = 0 | January = 1 |
| Year | 1900-based | Actual year |
| Timezone handling | Poor | First-class ZonedDateTime |
| Design | Confusing, inconsistent | Clean, fluent, ISO-8601 |
java example
// Old API problems
Date date = new Date(2024, 1, 15); // Actually March 15, 3924!
Calendar cal = Calendar.getInstance();
cal.set(Calendar.MONTH, 1); // February (0-indexed)!
// Mutable — another thread could change it
// New API — clean and intuitive
LocalDate date = LocalDate.of(2024, 1, 15); // January 15, 2024
LocalDate date2 = LocalDate.of(2024, Month.JANUARY, 15); // Same, more readableLocalTime — Time Without Date
Try it in WoHoCode
Edit the program, then run it here.
Loading editor...
Ln 1, Col 1java | Ctrl+Enter: run | Ctrl+S: save
Output
Run this example to see its output.
LocalDateTime — Date + Time Without Timezone
Try it in WoHoCode
Edit the program, then run it here.
Loading editor...
Ln 1, Col 1java | Ctrl+Enter: run | Ctrl+S: save
Output
Run this example to see its output.
ZonedDateTime — Full Date/Time with Timezone
Try it in WoHoCode
Edit the program, then run it here.
Loading editor...
Ln 1, Col 1java | Ctrl+Enter: run | Ctrl+S: save
Output
Run this example to see its output.
Duration and Period
Try it in WoHoCode
Edit the program, then run it here.
Loading editor...
Ln 1, Col 1java | Ctrl+Enter: run | Ctrl+S: save
Output
Run this example to see its output.
Formatting and Parsing
Try it in WoHoCode
Edit the program, then run it here.
Loading editor...
Ln 1, Col 1java | Ctrl+Enter: run | Ctrl+S: save
Output
Run this example to see its output.
Migration from Legacy API
java example
// Date <-> Instant <-> LocalDateTime
Date legacyDate = new Date();
Instant instant = legacyDate.toInstant();
LocalDateTime ldt = LocalDateTime.ofInstant(instant, ZoneId.systemDefault());
// Back to Date
Date backToDate = Date.from(ldt.atZone(ZoneId.systemDefault()).toInstant());
// Calendar <-> ZonedDateTime
Calendar calendar = Calendar.getInstance();
ZonedDateTime zdt = ZonedDateTime.ofInstant(calendar.toInstant(),
calendar.getTimeZone().toZoneId());
// java.sql.Date <-> LocalDate
java.sql.Date sqlDate = java.sql.Date.valueOf(LocalDate.now());
LocalDate localDate = sqlDate.toLocalDate();
// java.sql.Timestamp <-> LocalDateTime
java.sql.Timestamp timestamp = java.sql.Timestamp.valueOf(LocalDateTime.now());
LocalDateTime fromTimestamp = timestamp.toLocalDateTime();Real-World Examples
Example
// Calculate business days between two dates
public static long businessDaysBetween(LocalDate start, LocalDate end) {
return start.datesUntil(end)
.filter(d -> d.getDayOfWeek() != DayOfWeek.SATURDAY)
.filter(d -> d.getDayOfWeek() != DayOfWeek.SUNDAY)
.count();
}
// Find next working day
public static LocalDate nextWorkingDay(LocalDate date) {
LocalDate next = date.plusDays(1);
while (next.getDayOfWeek() == DayOfWeek.SATURDAY ||
next.getDayOfWeek() == DayOfWeek.SUNDAY) {
next = next.plusDays(1);
}
return next;
}
// Age calculator
public static String calculateAge(LocalDate birthDate) {
Period age = Period.between(birthDate, LocalDate.now());
return String.format("%d years, %d months, %d days",
age.getYears(), age.getMonths(), age.getDays());
}
Interview Questions
Q1: Why is the new Date/Time API better than Date and Calendar?
Answer: Immutability (thread-safe), proper month indexing (1-12), separation of concerns (LocalDate vs LocalTime vs ZonedDateTime), fluent API, built-in timezone support, and ISO-8601 compliance.
Q2: What is the difference between LocalDateTime and ZonedDateTime?
Answer: LocalDateTime has no timezone info — it represents a date-time on a wall clock. ZonedDateTime includes timezone rules and can handle DST transitions. Use LocalDateTime for local events, ZonedDateTime for global timestamps.
Q3: What is the difference between Duration and Period?
Answer: Duration is time-based (hours, minutes, seconds) used with LocalTime/LocalDateTime. Period is date-based (years, months, days) used with LocalDate. "3 hours" is Duration; "2 months and 5 days" is Period.
Q4: How do you convert between old Date and new LocalDateTime?
Answer: Date.toInstant() → LocalDateTime.ofInstant(instant, zoneId) and back: LocalDateTime.atZone(zoneId).toInstant() → Date.from(instant).
Q5: What happens at DST boundaries with ZonedDateTime?
Answer: Java handles gaps (spring forward) by moving forward to the next valid time, and overlaps (fall back) by choosing the earlier offset by default. You can use withEarlierOffsetAtOverlap() or withLaterOffsetAtOverlap().
Q6: What is Instant and when should you use it?
Answer: Instant represents a specific moment on the UTC timeline (machine time). Use it for timestamps, measuring elapsed time, database storage, and any time you need an absolute point in time regardless of timezone.
Summary
In this chapter, we learned about Date and Time API in Java 8 in detail. Here are the key points:
- Basic introduction to the concept and why it is needed
- Syntax and structure with complete examples
- Internal working and best practices
- Real-world applications and use cases
- Common mistakes and how to avoid them
- How this topic is asked in interviews
To practice these concepts, write and run the code in your IDE and verify the output. Modify each example and experiment so that you deeply understand the concept.
Continue the lesson path
Study next in this module
01Java 8 FeaturesOptional Class in Java 8Master the Optional class in Java 8 — eliminating null pointer exceptions, proper usage patterns, chaining operations, and anti-patterns to avoid.02Java 8 FeaturesStream API in Java 8Complete guide to Java 8 Stream API — creation, intermediate operations, terminal operations, parallel streams, collectors, and real-world data processing pipelines.03Java 8 FeaturesDefault and Static Methods in InterfacesComplete guide to Default and Static methods in Java 8 interfaces — interface evolution, multiple inheritance resolution, and practical design patterns.04Java 8 FeaturesMethod Reference in Java 8Deep guide to Method References in Java 8 — all four types, when to use vs lambdas, constructor references, and practical patterns.