org.joda.time.format

Provides printing and parsing support for instants and durations. This package contains simple and advanced classes for formatting.

Formatters are defined by interfaces, and instances are obtained from factory classes. Most datetime formatters can be obtained from DateTimeFormat and ISODateTimeFormat. More advanced formatters can be built by using DateTimeFormatterBuilder.

Similarly there are also classes for parsing and printing periods. Most period formatters can be obtained from the factory classes PeriodFormat and ISOPeriodFormat. More advanced formatters can be built by using PeriodFormatterBuilder.

Datetime formatting is performed by the DateTimeFormatter class. Three classes provide factory methods to create formatters, and this is one. The others are ISODateTimeFormat and DateTimeFormatterBuilder .

This class provides two types of factory:

• DateTimeFormat.forPattern(String) Pattern provides a DateTimeFormatter based on a pattern string that is mostly compatible with the JDK date patterns.
• DateTimeFormat.forStyle(String) Style provides a DateTimeFormatter based on a two character style, representing short, medium, long and full.

For example, to use a patterm:

 DateTime dt = new DateTime();
 DateTimeFormatter fmt = DateTimeFormat.forPattern("MMMM, yyyy");
 String str = fmt.print(dt);
 

 Symbol  Meaning                      Presentation  Examples
 ------  -------                      ------------  -------
 G       era                          text          AD
 C       century of era (>=0)         number        20
 Y       year of era (>=0)            year          1996
 x       weekyear                     year          1996
 w       week of weekyear             number        27
 e       day of week                  number        2
 E       day of week                  text          Tuesday; Tue
 y       year                         year          1996
 D       day of year                  number        189
 M       month of year                month         July; Jul; 07
 d       day of month                 number        10
 a       halfday of day               text          PM
 K       hour of halfday (0~11)       number        0
 h       clockhour of halfday (1~12)  number        12
 H       hour of day (0~23)           number        0
 k       clockhour of day (1~24)      number        24
 m       minute of hour               number        30
 s       second of minute             number        55
 S       fraction of second           number        978
 z       time zone                    text          Pacific Standard Time; PST
 Z       time zone offset/id          zone          -0800; -08:00; America/Los_Angeles
 '       escape for text              delimiter
 ''      single quote                 literal       '
 

Text: If the number of pattern letters is 4 or more, the full form is used; otherwise a short or abbreviated form is used if available.

Number: The minimum number of digits.

This class is the main API for printing and parsing used by most applications. Instances of this class are created via one of three factory classes:

• DateTimeFormat - formats by pattern and style
• ISODateTimeFormat - ISO8601 formats
• DateTimeFormatterBuilder - complex formats created via method calls

An instance of this class holds a reference internally to one printer and one parser.

Datetime formatting is performed by the DateTimeFormatter class. Three classes provide factory methods to create formatters, and this is one. The others are DateTimeFormat and ISODateTimeFormat .

DateTimeFormatterBuilder is used for constructing formatters which are then used to print or parse.

Application users will rarely use this class directly.

Application users will rarely use this class directly.

Datetime formatting is performed by the DateTimeFormatter class. Three classes provide factory methods to create formatters, and this is one. The others are DateTimeFormat and DateTimeFormatterBuilder .

ISO8601 is the international standard for data interchange.

This class is the main API for printing and parsing used by most applications. Instances of this class are created via one of three factory classes:

• PeriodFormat - formats by pattern and style
• ISOPeriodFormat - ISO8601 formats
• PeriodFormatterBuilder - complex formats created via method calls

An instance of this class holds a reference internally to one printer and one parser.

Period formatting is performed by the PeriodFormatter class. Three classes provide factory methods to create formatters, and this is one. The others are PeriodFormat and ISOPeriodFormat .

PeriodFormatterBuilder is used for constructing formatters which are then used to print or parse.

Application users will rarely use this class directly.

Application users will rarely use this class directly.