Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
Examples for using the Java 8 Date and Time API (JSR 310)
import java.time.*;
import java.time.format.DateTimeFormatter;
import java.time.format.FormatStyle;
import java.time.temporal.ChronoUnit;
import java.time.temporal.TemporalAdjusters;
import java.util.*;
import static java.time.temporal.TemporalAdjusters.*;
public class Java8DateTimeExamples {
// This class shows the usage of the Java 8 date/time API
// For more information have a look at this blog post:
// http://www.mscharhag.com/2014/02/java-8-datetime-api.html
private static void dateTimes() {
// dates, e.g. 2014-02-18
// the current date
LocalDate currentDate = LocalDate.now();
// 2014-02-10
LocalDate tenthFeb2014 = LocalDate.of(2014, Month.FEBRUARY, 10);
// months values start at 1 (2014-08-01)
LocalDate firstAug2014 = LocalDate.of(2014, 8, 1);
// the 65th day of 2010 (2010-03-06)
LocalDate sixtyFifthDayOf2010 = LocalDate.ofYearDay(2010, 65);
// times, e.g. 19:12:30.733
LocalTime currentTime = LocalTime.now(); // current time
LocalTime midday = LocalTime.of(12, 0); // 12:00
LocalTime afterMidday = LocalTime.of(13, 30, 15); // 13:30:15
// 12345th second of day (03:25:45)
LocalTime fromSecondsOfDay = LocalTime.ofSecondOfDay(12345);
// dates with times, e.g. 2014-02-18T19:08:37.950
LocalDateTime currentDateTime = LocalDateTime.now();
// 2014-10-02 12:30
LocalDateTime secondAug2014 = LocalDateTime.of(2014, 10, 2, 12, 30);
// 2014-12-24 12:00
LocalDateTime christmas2014 = LocalDateTime.of(2014, Month.DECEMBER, 24, 12, 0);
// By default LocalDate and LocalTime will use the system clock in the default time zone
// We can change this by providing a timezone or an alternative clock implementation
// current (local) time in Los Angeles
LocalTime currentTimeInLosAngeles = LocalTime.now(ZoneId.of("America/Los_Angeles"));
// current time in UTC time zone
LocalTime nowInUtc = LocalTime.now(Clock.systemUTC());
System.out.println("date/time creation: currentDate: " + currentDate);
System.out.println("date/time creation: tenthFeb2014: " + tenthFeb2014);
System.out.println("date/time creation: firstAug2014: " + firstAug2014);
System.out.println("date/time creation: sixtyFifthDayOf2010: " + sixtyFifthDayOf2010);
System.out.println("date/time creation: currentTime: " + currentTime);
System.out.println("date/time creation: midday: " + midday);
System.out.println("date/time creation: afterMidday: " + afterMidday);
System.out.println("date/time creation: fromSecondsOfDay: " + fromSecondsOfDay);
System.out.println("date/time creation: currentTimeInLosAngeles: " + currentTimeInLosAngeles);
System.out.println("date/time creation: currentDateTime: " + currentDateTime);
System.out.println("date/time creation: secondAug2014: " + secondAug2014);
System.out.println("date/time creation: christmas2014: " + christmas2014);
}
private static void dateTimeInformation() {
LocalDate date = LocalDate.of(2014, 2, 15); // 2014-06-15
boolean isBefore = LocalDate.now().isBefore(date); // false
// information about the month
Month february = date.getMonth(); // FEBRUARY
int februaryIntValue = february.getValue(); // 2
int minLength = february.minLength(); // 28
int maxLength = february.maxLength(); // 29
Month firstMonthOfQuarter = february.firstMonthOfQuarter(); // JANUARY
// information about the year
int year = date.getYear(); // 2014
int dayOfYear = date.getDayOfYear(); // 46
int lengthOfYear = date.lengthOfYear(); // 365
boolean isLeapYear = date.isLeapYear(); // false
DayOfWeek dayOfWeek = date.getDayOfWeek();
int dayOfWeekIntValue = dayOfWeek.getValue(); // 6
String dayOfWeekName = dayOfWeek.name(); // SATURDAY
int dayOfMonth = date.getDayOfMonth(); // 15
LocalDateTime startOfDay = date.atStartOfDay(); // 2014-02-15T00:00
// time information
LocalTime time = LocalTime.of(15, 30); // 15:30:00
int hour = time.getHour(); // 15
int second = time.getSecond(); // 0
int minute = time.getMinute(); // 30
int secondOfDay = time.toSecondOfDay(); // 55800
System.out.println("dateTimeInformation: february: " + february);
System.out.println("dateTimeInformation: februaryIntValue: " + februaryIntValue);
System.out.println("dateTimeInformation: firstMonthOfQuarter: " + firstMonthOfQuarter);
System.out.println("dateTimeInformation: minLength: " + minLength);
System.out.println("dateTimeInformation: maxLength: " + maxLength);
System.out.println("dateTimeInformation: year: " + year);
System.out.println("dateTimeInformation: dayOfYear: " + dayOfYear);
System.out.println("dateTimeInformation: lengthOfYear: " + lengthOfYear);
System.out.println("dateTimeInformation: isLeapYear: " + isLeapYear);
System.out.println("dateTimeInformation: dayOfWeekName: " + dayOfWeekName);
System.out.println("dateTimeInformation: dayOfWeekIntValue: " + dayOfWeekIntValue);
System.out.println("dateTimeInformation: dayOfMonth: " + dayOfMonth);
System.out.println("dateTimeInformation: startOfDay: " + startOfDay);
System.out.println("dateTimeInformation: hour: " + hour);
System.out.println("dateTimeInformation: second: " + second);
System.out.println("dateTimeInformation: minute: " + minute);
System.out.println("dateTimeInformation: secondOfDay: " + secondOfDay);
System.out.println("dateTimeInformation: isBefore: " + isBefore);
}
private static void year() {
Year currentYear = Year.now();
Year twoThousand = Year.of(2000);
boolean isLeap = currentYear.isLeap(); // false
int length = currentYear.length(); // 365
// sixtyFourth day of 2014 (2014-03-05)
LocalDate date = Year.of(2014).atDay(64);
System.out.println("year: currentYear: " + currentYear);
System.out.println("year: twoThousand: " + twoThousand);
System.out.println("year: isLeap: " + isLeap);
System.out.println("year: length: " + length);
System.out.println("year: date: " + date);
}
private static void periodsAndDurations() {
// periods
LocalDate firstDate = LocalDate.of(2010, 5, 17); // 2010-05-17
LocalDate secondDate = LocalDate.of(2015, 3, 7); // 2015-03-07
Period period = Period.between(firstDate, secondDate);
int days = period.getDays(); // 18
int months = period.getMonths(); // 9
int years = period.getYears(); // 4
boolean isNegative = period.isNegative(); // false
Period twoMonthsAndFiveDays = Period.ofMonths(2).plusDays(5);
LocalDate sixthOfJanuary = LocalDate.of(2014, 1, 6);
// add two months and five days to 2014-01-06, result is 2014-03-11
LocalDate eleventhOfMarch = sixthOfJanuary.plus(twoMonthsAndFiveDays);
// durations
Instant firstInstant= Instant.ofEpochSecond( 1294881180 ); // 2011-01-13 01:13
Instant secondInstant = Instant.ofEpochSecond(1294708260); // 2011-01-11 01:11
Duration between = Duration.between(firstInstant, secondInstant);
// negative because firstInstant is after secondInstant (-172920)
long seconds = between.getSeconds();
// get absolute result in minutes (2882)
long absoluteResult = between.abs().toMinutes();
// two hours in seconds (7200)
long twoHoursInSeconds = Duration.ofHours(2).getSeconds();
System.out.println("periodsAndDurations: days: " + days);
System.out.println("periodsAndDurations: months: " + months);
System.out.println("periodsAndDurations: years: " + years);
System.out.println("periodsAndDurations: isNegative: " + isNegative);
System.out.println("periodsAndDurations: eleventhOfMarch: " + eleventhOfMarch);
System.out.println("periodsAndDurations: seconds: " + seconds);
System.out.println("periodsAndDurations: absoluteResult: " + absoluteResult);
System.out.println("periodsAndDurations: twoHoursInSeconds: " + twoHoursInSeconds);
}
private static void additionSubtraction() {
LocalDate tomorrow = LocalDate.now().plusDays(1);
// before 5 houres and 30 minutes
LocalDateTime dateTime = LocalDateTime.now().minusHours(5).minusMinutes(30);
System.out.println("additionSubtraction: tomorrow: " + tomorrow);
System.out.println("additionSubtraction: dateTime: " + dateTime);
}
private static void parsingFormatting() {
// 2014-04-01 10:45
LocalDateTime dateTime = LocalDateTime.of(2014, Month.APRIL, 1, 10, 45);
// format as basic ISO date format (20140220)
String asBasicIsoDate = dateTime.format(DateTimeFormatter.BASIC_ISO_DATE);
// format as ISO week date (2014-W08-4)
String asIsoWeekDate = dateTime.format(DateTimeFormatter.ISO_WEEK_DATE);
// format ISO date time (2014-02-20T20:04:05.867)
String asIsoDateTime = dateTime.format(DateTimeFormatter.ISO_DATE_TIME);
// using a custom pattern (01/04/2014)
String asCustomPattern = dateTime.format(DateTimeFormatter.ofPattern("dd/MM/yyyy"));
// french date formatting (1. avril 2014)
String frenchDate = dateTime.format(DateTimeFormatter.ofPattern("d. MMMM yyyy", new Locale("fr")));
// using short german date/time formatting (01.04.14 10:45)
DateTimeFormatter formatter = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.SHORT).withLocale(new Locale("de"));
String germanDateTime = dateTime.format(formatter);
// parsing date strings
LocalDate fromIsoDate = LocalDate.parse("2014-01-20");
LocalDate fromIsoWeekDate = LocalDate.parse("2014-W14-2", DateTimeFormatter.ISO_WEEK_DATE);
LocalDate fromCustomPattern = LocalDate.parse("20.01.2014", DateTimeFormatter.ofPattern("dd.MM.yyyy"));
System.out.println("parsingFormatting: asBasicIsoDate: " + asBasicIsoDate);
System.out.println("parsingFormatting: asIsoWeekDate: " + asIsoWeekDate);
System.out.println("parsingFormatting: asIsoDateTime: " + asIsoDateTime);
System.out.println("parsingFormatting: asCustomPattern: " + asCustomPattern);
System.out.println("parsingFormatting: fromIsoDate: " + fromIsoDate);
System.out.println("parsingFormatting: fromIsoWeekDate: " + fromIsoWeekDate);
System.out.println("parsingFormatting: fromCustomPattern: " + fromCustomPattern);
System.out.println("parsingFormatting: frenchDate: " + frenchDate);
System.out.println("parsingFormatting: germanDateTime: " + germanDateTime);
}
private static void temporalAdjuster() {
LocalDate date = LocalDate.of(2014, Month.FEBRUARY, 25); // 2014-02-25
// first day of february 2014 (2014-02-01)
LocalDate firstDayOfMonth = date.with(TemporalAdjusters.firstDayOfMonth());
// last day of february 2014 (2014-02-28)
LocalDate lastDayOfMonth = date.with(TemporalAdjusters.lastDayOfMonth());
// more fluent using static imports
// last day of 2014 (2014-12-31)
LocalDate lastDayOfYear = date.with(lastDayOfYear());
// first day of next month (2014-03-01)
LocalDate firstDayOfNextMonth = date.with(firstDayOfNextMonth());
// next sunday (2014-03-02)
LocalDate nextSunday = date.with(next(DayOfWeek.SUNDAY));
System.out.println("temporalAdjuster: firstDayOfMonth: " + firstDayOfMonth);
System.out.println("temporalAdjuster: lastDayOfMonth: " + lastDayOfMonth);
System.out.println("temporalAdjuster: lastDayOfYear: " + lastDayOfYear);
System.out.println("temporalAdjuster: firstDayOfNextMonth: " + firstDayOfNextMonth);
System.out.println("temporalAdjuster: nextSunday: " + nextSunday);
}
private static void timezones() {
ZoneId losAngeles = ZoneId.of("America/Los_Angeles");
ZoneId berlin = ZoneId.of("Europe/Berlin");
// 2014-02-20 12:00
LocalDateTime dateTime = LocalDateTime.of(2014, 02, 20, 12, 0);
// 2014-02-20 12:00, Europe/Berlin (+01:00)
ZonedDateTime berlinDateTime = ZonedDateTime.of(dateTime, berlin);
// 2014-02-20 03:00, America/Los_Angeles (-08:00)
ZonedDateTime losAngelesDateTime = berlinDateTime.withZoneSameInstant(losAngeles);
int offsetInSeconds = losAngelesDateTime.getOffset().getTotalSeconds(); // -28800
// a collection of all available zones
Set<String> allZoneIds = ZoneId.getAvailableZoneIds();
// using offsets
LocalDateTime date = LocalDateTime.of(2013, Month.JULY, 20, 3, 30);
ZoneOffset offset = ZoneOffset.of("+05:00");
// 2013-07-20 22:30 +05:00
OffsetDateTime plusFive = OffsetDateTime.of(date, offset);
// 2013-07-19 20:30 -02:00
OffsetDateTime minusTwo = plusFive.withOffsetSameInstant(ZoneOffset.ofHours(-2));
System.out.println("timezones: berlinDateTime: " + berlinDateTime);
System.out.println("timezones: losAngelesDateTime: " + losAngelesDateTime);
System.out.println("timezones: offsetInSeconds: " + offsetInSeconds);
System.out.println("timezones: allZoneIds: " + allZoneIds);
System.out.println("timezones: offset: " + offset);
System.out.println("timezones: plusFive: " + plusFive);
System.out.println("timezones: minusTwo: " + minusTwo);
}
private static void conversion() {
// LocalDate/LocalTime <-> LocalDateTime
LocalDate date = LocalDate.now();
LocalTime time = LocalTime.now();
LocalDateTime dateTimeFromDateAndTime = LocalDateTime.of(date, time);
LocalDate dateFromDateTime = LocalDateTime.now().toLocalDate();
LocalTime timeFromDateTime = LocalDateTime.now().toLocalTime();
// Instant <-> LocalDateTime
Instant instant = Instant.now();
LocalDateTime dateTimeFromInstant = LocalDateTime.ofInstant(instant, ZoneId.of("America/Los_Angeles"));
Instant instantFromDateTime = LocalDateTime.now().toInstant(ZoneOffset.ofHours(-2));
// convert from/to old date/calendar/timezone classes
Instant instantFromDate = new Date().toInstant();
Instant instantFromCalendar = Calendar.getInstance().toInstant();
ZoneId zoneId = TimeZone.getDefault().toZoneId();
ZonedDateTime zonedDateTimeFromGregorianCalendar = new GregorianCalendar().toZonedDateTime();
Date dateFromInstant = Date.from(Instant.now());
TimeZone timeZone = TimeZone.getTimeZone(ZoneId.of("America/Los_Angeles"));
GregorianCalendar gregorianCalendar = GregorianCalendar.from(ZonedDateTime.now());
}
private static void timestamps() {
// current time
Instant now = Instant.now();
// from unix timestamp, 2010-01-01 12:00:00
Instant fromUnixTimestamp = Instant.ofEpochSecond(1262347200);
// same time in millis
Instant fromEpochMilli = Instant.ofEpochMilli(1262347200000l);
// parsing from ISO 8601
Instant fromIso8601 = Instant.parse("2010-01-01T12:00:00Z");
// toString() returns ISO 8601 format
String toIso8601 = now.toString();
// as unix timestamp
long toUnixTimestamp = now.getEpochSecond();
// in millis
long toEpochMillis = now.toEpochMilli();
// native plusSeconds() method to add 10 seconds
Instant nowPlusTenSeconds = now.plusSeconds(10);
// no native support for units like days.
Instant nowPlusTwoDays = now.plus(2, ChronoUnit.DAYS);
Instant nowMinusTwoDays = now.minus(Duration.ofDays(2));
System.out.println("timestamps now: " + now);
System.out.println("timestamps fromUnixTimestamp: " + fromUnixTimestamp);
System.out.println("timestamps fromEpochMilli: " + fromEpochMilli);
System.out.println("timestamps fromIso8601: " + fromIso8601);
System.out.println("timestamps toIso8601: " + toIso8601);
System.out.println("timestamps toUnixTimestamp: " + toUnixTimestamp);
System.out.println("timestamps toEpochMillis: " + toEpochMillis);
System.out.println("timestamps nowPlusTenSeconds: " + nowPlusTenSeconds);
System.out.println("timestamps nowPlusTwoDays: " + nowPlusTwoDays);
System.out.println("timestamps nowMinusTwoDays: " + nowMinusTwoDays);
}
public static void main(String[] args) {
dateTimes();
dateTimeInformation();
year();
temporalAdjuster();
additionSubtraction();
timezones();
timestamps();
periodsAndDurations();
parsingFormatting();
conversion();
}
}
@liumuqi

This comment has been minimized.

Copy link

liumuqi commented Nov 1, 2016

can parse any datetime or date string with format sring ? like this: xxx.parse("2014-10-11","yyyy-MM-dd") ,xxx.parse("2014-10-11 10:13:11","yyyy-MM-dd HH:MM:ss") can do or not ?

@kelvearagao

This comment has been minimized.

Copy link

kelvearagao commented Nov 11, 2016

thanks

@jimandreas

This comment has been minimized.

Copy link

jimandreas commented Aug 7, 2017

Thanks for sharing this excellent set of example calls!

@Tonterias

This comment has been minimized.

Copy link

Tonterias commented Aug 24, 2017

Thanks. Well done: clear and to the point

@AndroidDeveloperLB

This comment has been minimized.

Copy link

AndroidDeveloperLB commented Jan 11, 2018

How can I convert from unix timestamp from/to LocalDate and/or LocalTimeDate ?

I know I could use Calendar as a helper class, but is there a better way?

@RicardoEscobar

This comment has been minimized.

Copy link

RicardoEscobar commented Jan 22, 2018

I love it, It took me 8 hours to try every example on my own use cases but it was worth it I learned a lot.

I shared on twitter.

@sbibek

This comment has been minimized.

Copy link

sbibek commented Mar 7, 2018

How to represent the timestamp which is in epoch nanoseconds in localdatetime?

@aleksamarkoni

This comment has been minimized.

Copy link

aleksamarkoni commented Jun 4, 2018

Many thanks, I don't have a cookie, but I would gladly give you one :)

@ivanvasheka

This comment has been minimized.

Copy link

ivanvasheka commented Jul 19, 2018

Great example! Could you please add a comparing / equals section? For example, how to say if two Instants are in the same Day / Week / Month / Year ? And maybe there are some tools to properly format relative date text (e.g. if the Instant is today or yesterday or on the last week? Thanks!

@LiuHongze19920301

This comment has been minimized.

Copy link

LiuHongze19920301 commented Sep 29, 2018

How can I convert from unix timestamp from/to LocalDate and/or LocalTimeDate ?

I know I could use Calendar as a helper class, but is there a better way?

public static LocalDate mapDateToLocalDate(Date date) {
Instant instant = date.toInstant();
ZoneId defaultZoneId = ZoneId.systemDefault();
return instant.atZone(defaultZoneId).toLocalDate();
}

public static LocalDateTime mapDateToLocalDateTime(Date date) {
Instant instant = date.toInstant();
ZoneId defaultZoneId = ZoneId.systemDefault();
return instant.atZone(defaultZoneId).toLocalDateTime();
}

public static Date mapLocalDateToDate(LocalDate localDate) {
ZoneId defaultZoneId = ZoneId.systemDefault();
Instant instant = localDate.atStartOfDay().atZone(defaultZoneId).toInstant();
return Date.from(instant);
}

@gildas

This comment has been minimized.

Copy link

gildas commented Sep 13, 2019

I didn't see any test for stuff like 2011-12-03T10:15:30+01:00
In my test, Instant.parse("2011-12-03T10:15:30+01:00" fails, whereas it shouldn't since the date is a valid ISO 8601. This exact string even comes from the Java doc on Oracle...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.