TextStyle

AI-generated Key Takeaways

• TextStyle is an enumeration used for formatting and parsing text in date-time contexts, offering varying levels of detail.

• It provides six styles: FULL, FULL_STANDALONE, SHORT, SHORT_STANDALONE, NARROW, and NARROW_STANDALONE, categorized by text length and stand-alone usage.

• These styles determine the output format of date-time components like months or days, ranging from full names to abbreviations or single letters.

• While 'standard' and 'stand-alone' forms have no difference in English, some languages use different words for date components depending on their context within a date.

• The enumeration inherits methods from java.lang.Enum, java.lang.Object, and java.lang.Comparable for object comparison and manipulation.

public final enum TextStyle extends Enum<TextStyle>

Enumeration of the style of text formatting and parsing.

Text styles define three sizes for the formatted text - 'full', 'short' and 'narrow'. Each of these three sizes is available in both 'standard' and 'stand-alone' variations.

The difference between the three sizes is obvious in most languages. For example, in English the 'full' month is 'January', the 'short' month is 'Jan' and the 'narrow' month is 'J'. Note that the narrow size is often not unique. For example, 'January', 'June' and 'July' all have the 'narrow' text 'J'.

The difference between the 'standard' and 'stand-alone' forms is trickier to describe as there is no difference in English. However, in other languages there is a difference in the word used when the text is used alone, as opposed to in a complete date. For example, the word used for a month when used alone in a date picker is different to the word used for month in association with a day and year in a date.

Inherited Method Summary

From class java.lang.Enum

final Object	clone() Throws CloneNotSupportedException.
final int	compareTo(TextStyle o) Compares this enum with the specified object for order.
final boolean	equals(Object other) Returns true if the specified object is equal to this enum constant.
final void	finalize() enum classes cannot have finalize methods.
final Class<TextStyle>	getDeclaringClass() Returns the Class object corresponding to this enum constant's enum type.
final int	hashCode() Returns a hash code for this enum constant.
final String	name() Returns the name of this enum constant, exactly as declared in its enum declaration.
final int	ordinal() Returns the ordinal of this enumeration constant (its position in its enum declaration, where the initial constant is assigned an ordinal of zero).
String	toString() Returns the name of this enum constant, as contained in the declaration.
static <T extends Enum<T>> T	valueOf(Class<T> enumType, String name) Returns the enum constant of the specified enum type with the specified name.

From class java.lang.Object

Object	clone() Creates and returns a copy of this Object.
boolean	equals(Object obj) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of Class that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long timeout, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait(long timeout) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.

From interface java.lang.Comparable

abstract int

compareTo(TextStyle o) Compares this object with the specified object for order.

Enum Values

public static final TextStyle FULL

Full text, typically the full description. For example, day-of-week Monday might output "Monday".

public static final TextStyle FULL_STANDALONE

Full text for stand-alone use, typically the full description. For example, day-of-week Monday might output "Monday".

public static final TextStyle NARROW

Narrow text, typically a single letter. For example, day-of-week Monday might output "M".

public static final TextStyle NARROW_STANDALONE

Narrow text for stand-alone use, typically a single letter. For example, day-of-week Monday might output "M".

public static final TextStyle SHORT

Short text, typically an abbreviation. For example, day-of-week Monday might output "Mon".

public static final TextStyle SHORT_STANDALONE

Short text for stand-alone use, typically an abbreviation. For example, day-of-week Monday might output "Mon".