Provides classes to print and parse dates and times.
Printing and parsing is based around the
DateTimeFormatter
class.
Instances are generally obtained from
DateTimeFormatter
, however
DateTimeFormatterBuilder
can be used if more power is needed.
Localization occurs by calling
withLocale(Locale)
on the formatter. Further customization is possible using
DecimalStyle
.
Unless otherwise noted, passing a null argument to a constructor or method in any class or interface
in this package will cause a NullPointerException
to be thrown.
The Javadoc "@param" definition is used to summarise the null-behavior.
The "@throws java.
" is not explicitly documented in each method.
All calculations should check for numeric overflow and throw either an java.
or a java.
.
Modifier and Type | Class and Description |
---|---|
public class | DateTimeFormatter
Formatter for printing and parsing date-time objects. |
public class | DateTimeFormatterBuilder
Builder to create date-time formatters. |
pack-priv class | DateTimeParseContext
Context object used during date and time parsing. |
public class | DateTimeParseException
An exception thrown when an error occurs during parsing. |
pack-priv class | DateTimePrintContext
Context object used during date and time printing. |
pack-priv class | DateTimeTextProvider
A provider to obtain the textual form of a date-time field. |
public class | DecimalStyle
Localized decimal style used in date and time formatting. |
pack-priv class | Parsed
A store of parsed data. |
pack-priv class | ZoneName
A helper class to map a zone name to metazone and back to the appropriate zone id for the particular locale. |
Modifier and Type | Enum and Description |
---|---|
public enum | FormatStyle
Enumeration of the style of a localized date, time or date-time formatter. |
public enum | ResolverStyle
Enumeration of different ways to resolve dates and times. |
public enum | SignStyle
Enumeration of ways to handle the positive/negative sign. |
public enum | TextStyle
Enumeration of the style of text formatting and parsing. |