`uuuu` versus `yyyy` in `DateTimeFormatter` formatting pattern codes in Java?

by

Within the scope of java.time-package, we can say:

  • It is safer to use “u” instead of “y” because DateTimeFormatter will otherwise insist on having an era in combination with “y” (= year-of-era). So using “u” would avoid some possible unexpected exceptions in strict formatting/parsing. See also this SO-post. Another minor thing which is improved by “u”-symbol compared with “y” is printing/parsing negative gregorian years (in far past).

  • Otherwise we can clearly state that using “u” instead of “y” breaks long-standing habits in Java-programming. It is also not intuitively clear that “u” denotes any kind of year because a) the first letter of the English word “year” is not in agreement with this symbol and b) SimpleDateFormat has used “u” for a different purpose since Java-7 (ISO-day-number-of-week). Confusion is guaranteed – for ever?

  • We should also see that using eras (symbol “G”) in context of ISO is in general dangerous if we consider historic dates. If “G” is used with “u” then both fields are unrelated to each other. And if “G” is used with “y” then the formatter is satisfied but still uses proleptic gregorian calendar when the historic date mandates different calendars and date-handling.

Background information:

When developing and integrating the JSR 310 (java.time-packages) the designers decided to use Common Locale Data Repository (CLDR)/LDML-spec as the base of pattern symbols in DateTimeFormatter. The symbol “u” was already defined in CLDR as proleptic gregorian year, so this meaning was adopted to new upcoming JSR-310 (but not to SimpleDateFormat because of backwards compatibility reasons).

However, this decision to follow CLDR was not quite consistent because JSR-310 had also introduced new pattern symbols which didn’t and still don’t exist in CLDR, see also this old CLDR-ticket. The suggested symbol “I” was changed by CLDR to “VV” and finally overtaken by JSR-310, including new symbols “x” and “X”. But “n” and “N” still don’t exist in CLDR, and since this old ticket is closed, it is not clear at all if CLDR will ever support it in the sense of JSR-310. Furthermore, the ticket does not mention the symbol “p” (padding instruction in JSR-310, but not defined in CLDR). So we have still no perfect agreement between pattern definitions across different libraries and languages.

And about “y”: We should also not overlook the fact that CLDR associates this year-of-era with at least some kind of mixed Julian/Gregorian year and not with the proleptic gregorian year as JSR-310 does (leaving the oddity of negative years aside). So no perfect agreement between CLDR and JSR-310 here, too.

More Related Contents:

  1. Convert java.util.Date to what “java.time” type?
  2. How to parse a time into a Date object from user input in JavaScript?
  3. Difference between year-of-era and week-based-year?
  4. How can I parse dates and convert time zones in Perl?
  5. Compare two dates Google apps script
  6. How do I convert a date/time to epoch time (unix time/seconds since 1970) in Perl?
  7. Parse clock time in java 8
  8. Convert one date format into another in PHP
  9. Check time difference in Javascript
  10. Browsers, time zones, Chrome 67 Error (historic timezone changes)
  11. Converting string to Date and DateTime
  12. Change system date programmatically
  13. How to get milliseconds from LocalDateTime in Java 8
  14. What is the use of “lenient “?
  15. In Java, how do I get the difference in seconds between 2 dates?
  16. SQL Query to find the last day of the month
  17. How to transform currentTimeMillis to a readable date format? [duplicate]
  18. Stop javascript Date function from changing timezone offset
  19. Google Apps Script date format issue (Utilities.formatDate)
  20. How to compare dates or date against today with query on google sheets?
  21. Java Best Practice for Date Manipulation/Storage for Geographically Diverse Users
  22. Convert date to datetime in Python
  23. Date in a URL dd/mm/yyyy
  24. Range.Find not making a difference between January and November (February and December) in VBA Excel
  25. Get first and last day of month using threeten, LocalDate
  26. Java 8: Calculate difference between two ZonedDateTime
  27. adding 1 day to a DATETIME format value
  28. Carbon Difference in Time between two Dates in hh:mm:ss format
  29. How to display a Date object in a specific format using JavaScript?
  30. Date format conversion using Java

Leave a Comment