Date and Time handling is very common issue facing by developers while developing an application . It occurs in every layer of application like front-end , business logic and back-end etc. Mainly when interacting with different component or interacting with other back-end application for example front-end to business layer, business layer to database, database to business layer, one application to other application.

Some of application are used by international level from multiple countries and each country have different Time Zone. Some of Countries having Day Light savings also. Also know to handle Leap Year.

In this tutorial, You will learn about java date and time packages, classes and apis. Here almost  covered all type of  java date and time issues and  different situation. You will also learn in depth knowledge of Java 8 new packages, classes and apis examples and compare with legacy versions of java , Lacking of Date and Time packages before Java 8.

Topic Covered

• Why Java 8 introduce new  package for Date and Time?
• Date and Time Keywords
• Date and Time packages and classes
  • Introduction of Date and Time classes.
  • Legacy to Java 8 Date Time Interoperability
• Current Date and Time
• Date and Time Formatting
  • Date and Time Formatting Characters
  • Date and Time Pattern Examples
  • Date and Time Formatting by java.text.SimpleDateFormat
  • Date and Time formatting by printf
  • Parsing String to Date
• Date and Time Internationalization (TimeZone and Day Light Saving)
• Handle JDBC Date and Time
  • Convert java.util.Date and java.sql.Date
  • Convert java.util.Date and java.sql.Timestamp
• Convert java.util.Date to java.util.Calendar
• Convert Java.util.Date to java.time.LocaleDateTime
• Calculate Duration and Period
• Date Sorting
• System Time and calculate duration
• Date and Time Issues Solutions

Legacy Java( Before java 8)  use mainly java.util.Date, java.util.Calendar, java.util.GregorianCalendar and java.text.SimpleDateFormat to handle Date and Time creation, operation and formatting handling.  Legacy  Java Date and Calendar Classes having lack of documents and some more issues related to time-zone, type-safe and day-light saving etc. In Java 8 added a separate package as java.time  specifically for Date and Time handling  which considered all the earlier issues Date and Calendar and added so many new classes with good documentation for API.

Why Java 8 introduce new  package for Date and Time?

Below are some issues with Legacy Date classes that’s why in Java 8 introduces new package java.time solve all existing issues.

• 99% of Date is deprecated. Now Instant replaces java.util.Date.
• Date’s Year is offset from 1900. Now Years have same numbering in java.time, 2018 is the year 2018.
• Date’s Month is zero-indexed while day is one-indexed. Now Months have same numbering in java.time, 1-12 for January-December. Even better, the Month enum provides objects to represent each month of the year rather than a integer number. So you get valid values, type-safety, and self-documenting code.
• Dates are mutable. Now virtually all of java.time classes is immutable.
• ZonedDateTime replaces java.util.Calendar.  Except you really have to use a GregorianCalendar, ZonedDateTime replaces java.util.GregorianCalendar too.
• Do a significant percent of developers want to use a different calendar?
  Yes. Other calendaring systems are used by many people around the globe. The java.time framework provides for this via the Chronology interface and AbstractChronology class. The default chronology is IsoChronology following the ISO 8601 standard used generally in the West. In Java 8 & 9, other bundled chronologies include Thai Buddhist, Hijrah (Islamic), Minguo (Taiwan), and Japanese Imperial.
• Calendar.getTime() returns a Date. Just use Instant as your basic building-block class in java.time, always representing a moment in UTC with a resolution of nanoseconds. The other types such as OffsetDateTime & ZonedDateTime can convert back-and-forth with Instant.
• There’s no Date math (like how far apart are two dates in years)
  The java.time classes have many convenient plus/minus methods. Furthermore, java.time provides powerful TemporalAduster implementations as well as enabling you to write your own. Also look to the ChronoUnit::between method, such as ChronoUnit.YEARS.between( thisLocalDate , that LocalDate ).
• Messing with milliseconds since epoch doesn’t count
  Look to Instant::toEpochMilli and Instant.ofEpochMilli if you must use count-from-epoch, but certainly not advisable. Better to use java.time objects and ISO 8601 strings to represent date-time values.
• JDBC date and Timestamp exchange:  JDBC driver compliant with JDBC 4.2 or later (JSR 221), you can avoid the date-time related java.sql classes such as java.sql.Date, java.sql.Timestamp classes. Those old classes are related to the troublesome old legacy classes, and are no longer needed. for Example to set and get property from database by JDBC

preparedStatement.setObject(…, instant);

                                and

                                Instant instant = resultSet.getObject( … , Instant.class ) ;

Date and Time Keywords

Date and Time packages and classes

Below are all the JAVA classes which are used to handle all type problems related Date and Time , exceptions, and formatting.

Introduction of Date and Time classes.

In above detail you learn about package, classes for Legacy system and also after Java 8. Now here you will learn about implementation of different cases.

Legacy to Java 8 Date Time Interoperability

In Java 8 added some new methods with Legacy java.util Date and Time classes to convert object of java.time classes to get advantage new java 8 Date and Time classes with minimal changes. Below are ways of inter-operability :

java.util.Date to an java.time.Instant Conversion

Date date=new Date();
Instant instant=date.toInstant();

An java.time.Instant to java.util.Date Conversion

Date date=Date.from(instant);

java.util.Calendar to an java.time.Instant Conversion

Calendar cal=Calendar.getInstance();
Instant instant=cal.toInstant();

java.util.GregorianCalendar instance to an java.time.ZoneDateTime Conversion

Calendar gCal=GregorianCalendar.getInstance();
ZoneDateTime zoneDateTime=ZoneDateTime.ofInstant(gCal.toInstant(),ZoneId.systemDefault());

java.time.ZoneDateTime instance to java.util.GregorianCalendar

GregorianCalendar gCal=GregorianCalendar.from(zoneDateTime);

java.util.TimeZone object to java.time.ZoneId

Calendar gCal1=GregorianCalendar.getInstance();
TimeZone tz = cal.getTimeZone();
ZoneId zoneID=tz.toZoneId();
int tzoffset = cal.get(Calendar.ZONE_OFFSET);

Follow below link to know more about it and complete example.

Complete Example for Java Legacy to Java 8 Date Time Interoperability

Current Date and Time

Here are ways to get current date and time by using legacy java 8 version.
java.util.Date
 

Date date=new Date();

java.util.Calendar and java.util.GregorianCalendar

Calendar calendar=Calendar.getInstance();
Calendar gCalnedar=GregorianCalendar.getInstance();

java.time.LocaleDateTime
LocalDateTime localDateTime=LocalDateTime.now();

java.time.LocaleDate
LocalDate localDate=LocalDate.now();

java.time.LocaleTime
LocalTime localTime=LocalTime.now();

Java : Current Date and Time Example

Date and Time Formatting Characters

Below are date and formatting characters use for formatting date and time.

Date and Time Pattern Examples

Below are some patterns use by organization standard based on above formatting characters.

Date and Time formatting by printf

Java Date and time designing should be possible effortlessly utilizing printf method by  utilizing a two-letter organize, beginning with t and completion in one of the letters of the table as appeared in the accompanying code. You can check complete list of designing characters as above in “Date and Time Formatting Characters”.

For Example:

Date date = new Date();
 String str = String.format("Current Date/Time : %tc", date );
 System.out.printf(str);
 System.out.printf("%1$s %2$tB %2$td, %2$tY", "Due date:", date);
 System.out.printf("%s %tB %<te, %<tY&, &Due date:&, date);

Output

Current Date/Time : Mon Aug 06 11:23:05 IST 2018 Due date: August 06, 2018Due date: August 6, 2018

Follow below link to see complete example and more detail on printf for date formatting.

Parsing String to Date

ss

Date and Time Internationalization (TimeZone and Daylight Saving Time)

For detail information and handling Daylight savings time (DST) and different time zones follow below links.

JAVA : Daylight Saving Time (DST) Handling

Java : How to convert GMT, CST, IST and PST timezone?

Handle JDBC Date and Time

JDBC databases not support java.util.Date format because it’s having time information also. For storing data in database we have to convert Java date to java.sql.Date or java.sql.Timestamp. java.sql.Timestamp is subclass of java.util.Date. Follow below below link to know more about java.sql.Date and java.sql.Timestamp  conversion.

• Java : java.util.Date and java.sql.Date Conversion
• Java : java.util.Date and java.sql.Timestamp Conversion

After Java 8

Now JDBC driver compliant with JDBC 4.2 or later (JSR 221), you can avoid the date-time related java.sql classes such as java.sql.Date, java.sql.Timestamp classes. Now these legacy classes are no longer needed. for Example:

//To set property in database

preparedStatement.setObject(…, instant);

and

//To get property from database

Instant instant = resultSet.getObject( … , Instant.class ) ;

Calculate Duration and Period

Almost every developer handle Duration and Period issues while need to do any calculation based on Date and Time. In Java 8 introduces new classes to handle Duration and period.

• Period : A date period is measured in days, months, and years. Period can be calculated by java.time.Period class.
• Duration: A time duration is measured in hours, minutes, and seconds. Duration can be calculated by java.time.Duration class.

Period period= Period.between(localDate1, localDate2);

Duration duration=Duration.between(localTime1, localTime2);

Duration.toString() method return duration as P1Y10M6D. Here duration is 1 year, 10 month and 6 days.

Period.toString() method return period as PT3H10M40S. Here duration is 3 hour, 10 minute and 40 seconds.

Follow below link  to complete example of Duration and Period.

• Java: Duration and Period Calculation

Date and Time Sorting

Basically, a list can be sorted if only all of its elements are mutually comparable by implementing the Comparable interface. If a class implements the Comparable interface, it is considered as having natural ordering which allows objects of that class to be sorted by the Collections.sort(list) method.

All basic data type wrapper classes in Java have natural ordering: String, Character, Byte, Date, Integer, Float, etc. In Java 8 classes LocalDateTime, LocalDate and LocalTime also implements comparable  interface.

Problem occurred when date in String format and following different format pattern as dd/MM/yyyy or MM/dd/yyyy ‘@’hh:mm a or some more patterns. In below examples you will see sorting of date and Time in text format and objects also.

• Java : Sort Date Time Object and Text Format
• Java : Sort Date Object and Text Format

System Time and calculate process time

System.currentTimeMillis(): Returns the current time in milliseconds. The granularity of the value depends on the underlying operating system and may be larger. For example, many operating systems measure time in units of tens of milliseconds.

System.nanoTime():  Returns the current value of the running Java Virtual Machine’s high-resolution time source, in nanoseconds. This method can only be used to measure elapsed time and is not related to any other notion of system or wall-clock time.

These methods are used to calculate processing time or performance of operations , methods and apis.

Check below example to calculate processing time :

• Java : System Time and Calculate Processing Time

Date and Time Issues Solutions

• [Solved] java.time.zone.ZoneRulesException: Unknown time-zone ID: IST
• [Solved] java.time.DateTimeException: Invalid value for NanoOfSecond (valid values 0 – 999999999): -1
• [Solved] java.time.DateTimeException: Invalid value for HourOfDay (valid values 0 – 23): 24
• [Solved] java.time.DateTimeException: Invalid date ‘February 29’ as ‘2014’ is not a leap year
• [Solved] java.time.temporal. UnsupportedTemporalType Exception: Unsupported field: YearOfEra
• [Solved] Date Format : java.text.ParseException: Unparseable date: “yyyy-MM-ddThh:mm:ss.SSSZ”
• [Solved] Date Format : java.lang.IllegalArgumentException: Illegal pattern character ‘Z’ or ‘T’
• [Solved] Date Format AM/PM : java.lang.IllegalArgumentException: Illegal pattern character ‘A’

Sample Programs

• Java 8+ Date Time Exmples
• JAVA : Generate 15 Minute Time Interval AM/PM
• Java : How to convert seconds to Time?
• Java Program : Convert Time Hour, Minute and Second
• Java : Sort Date Time Object and Text Format