# java.time.format

Provides classes to print and parse dates and times.


Printing and parsing is based around the
`https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/DateTimeFormatter.html` class.
Instances are generally obtained from
`https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/DateTimeFormatter.html`, however
`https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/DateTimeFormatterBuilder.html`
can be used if more power is needed.


Localization occurs by calling
`https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/DateTimeFormatter.html#withLocale(java.util.Locale)`
on the formatter. Further customization is possible using
`https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/DecimalStyle.html`.

### Package specification


Unless otherwise noted, passing a null argument to a constructor or method in any class or interface
in this package will cause a `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/NullPointerException.html` to be thrown.
The Javadoc "@param" definition is used to summarise the null-behavior.
The "@throws `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/NullPointerException.html`" is not explicitly documented in each method.


All calculations should check for numeric overflow and throw either an `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/ArithmeticException.html`
or a `https://developers.google.com/j2objc/javadoc/jre/reference/java/time/DateTimeException.html`.

### Classes

|---|---|
| [DateTimeFormatter](https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/DateTimeFormatter.html) | Formatter for printing and parsing date-time objects. |
| [DateTimeFormatterBuilder](https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/DateTimeFormatterBuilder.html) | Builder to create date-time formatters. |
| [DecimalStyle](https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/DecimalStyle.html) | Localized decimal style used in date and time formatting. |

### Enums

|---|---|
| [FormatStyle](https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/FormatStyle.html) | Enumeration of the style of a localized date, time or date-time formatter. |
| [ResolverStyle](https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/ResolverStyle.html) | Enumeration of different ways to resolve dates and times. |
| [SignStyle](https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/SignStyle.html) | Enumeration of ways to handle the positive/negative sign. |
| [TextStyle](https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/TextStyle.html) | Enumeration of the style of text formatting and parsing. |

### Exceptions

|---|---|
| [DateTimeParseException](https://developers.google.com/j2objc/javadoc/jre/reference/java/time/format/DateTimeParseException.html) | An exception thrown when an error occurs during parsing. |