What is the difference between year and year-of-era?

by

The answer lies in the documentation for IsoChronology

  • era – There are two eras, ‘Current Era’ (CE) and ‘Before Current Era’ (BCE).
  • year-of-era – The year-of-era is the same as the proleptic-year for the current CE era. For the BCE era before the ISO epoch the year increases from 1 upwards as time goes backwards.
  • proleptic-year – The proleptic year is the same as the year-of-era for the current era. For the previous era, years have zero, then negative values.

u will give you the proleptic year.
y will give you the year of the era.

The difference is mainly important for years of the BC era. The proleptic year 0 is actually 1 BC, it is followed by proleptic year 1 which is 1 AD. The proleptic year can be negative, the year of era can not.

Here is a snippet that will help visualize how it works :

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("'proleptic' : u '= era:' y G");

for (int i = 5; i > -6 ; i--) {
    LocalDate localDate = LocalDate.of(i, 3, 14);
    System.out.println(formatter.format(localDate));
}

Output:

proleptic : 5 = era: 5 AD
proleptic : 4 = era: 4 AD
proleptic : 3 = era: 3 AD
proleptic : 2 = era: 2 AD
proleptic : 1 = era: 1 AD
proleptic : 0 = era: 1 BC
proleptic : -1 = era: 2 BC
proleptic : -2 = era: 3 BC
proleptic : -3 = era: 4 BC
proleptic : -4 = era: 5 BC
proleptic : -5 = era: 6 BC

More Related Contents:

  1. Getting the date from a ResultSet for use with java.time classes
  2. Is there a class in java.time comparable to the Joda-Time Interval?
  3. Is Joda Time deprecated with java 8 Date and Time API? (java.time)
  4. LocalDateTime to java.sql.Date in java 8?
  5. Issue with DateTimeParseException when using STRICT resolver style
  6. Convert java.util.Date to java.time.LocalDate
  7. Converting between java.time.LocalDateTime and java.util.Date
  8. JSON Java 8 LocalDateTime format in Spring Boot
  9. Calculate days between two Dates in Java 8
  10. Is there a jackson datatype module for JDK8 java.time?
  11. How to get milliseconds from LocalDateTime in Java 8
  12. cannot resolve symbol ‘java.time.LocalDate’ error in android studio
  13. JDK dateformatter parsing DayOfWeek in German locale, java8 vs java9
  14. How can I create a Java 8 LocalDate from a long Epoch time in Milliseconds?
  15. How can I mock java.time.LocalDate.now()
  16. Why does the new Java 8 Date Time API not have nanosecond precision? [duplicate]
  17. Can’t parse String to LocalDate (Java 8)
  18. Why can’t I get a duration in minutes or hours in java.time?
  19. Unable to obtain OffsetDateTime from TemporalAccessor
  20. LocalDate to java.util.Date and vice versa simplest conversion? [duplicate]
  21. How to convert LocalDate to SQL Date Java?
  22. Why does Java8 Stream generate nothing?
  23. String to ZonedDateTime is changing format
  24. Format a date using the new date time API
  25. DateTimeFormatter Support for Single Digit Day of Month and Month of Year
  26. Android N Java8 java.time
  27. Persist java.time.Instant (JDK8) with JPA2/Hibernate
  28. Parse clock time in java 8
  29. Drawbacks of javac -parameters flag
  30. Are java.util.Date and java.util.Calendar deprecated?

Leave a Comment