net.time4j.format.Attributes Maven / Gradle / Ivy
/*
* -----------------------------------------------------------------------
* Copyright © 2013-2017 Meno Hochschild, A collection of format attributes for controlling the formatting
* and parsing.
*
* @author Meno Hochschild
* @doctags.concurrency {immutable}
*/
/*[deutsch]
* Formatattribute zum Steuern des Format- und Interpretierungsvorgangs.
*
* @author Meno Hochschild
* @doctags.concurrency {immutable}
*/
public final class Attributes
implements AttributeQuery {
//~ Statische Felder/Initialisierungen --------------------------------
/**
* Attribute for the calendar type.
*
* This attribute is effectively read-only and usually derived
* from the corresponding annotation value of any given chronology.
* Default value: {@link CalendarText#ISO_CALENDAR_TYPE}
*
* @see CalendarType
*/
/*[deutsch]
* Gibt den Kalendertyp an.
*
* Dieses Attribut ist effektiv nur mit Lesezugriff und wird aus
* der Annotation einer Chronologie abgeleitet. Standardwert:
* {@link CalendarText#ISO_CALENDAR_TYPE}
*
* @see CalendarType
*/
public static final AttributeKey CALENDAR_TYPE =
PredefinedKey.valueOf("CALENDAR_TYPE", String.class);
/**
* Attribute controlling the language output and parsing of
* chronological texts (for example month names).
*
* Default value: {@code Locale.ROOT}.
*/
/*[deutsch]
* Gibt die Sprach- und Ländereinstellung an, die die
* Sprachausgabe von chronologischen Texten (Beispiel Monatsnamen)
* steuert.
*
* Standardwert: {@code Locale.ROOT}.
*/
public static final AttributeKey LANGUAGE =
PredefinedKey.valueOf("LANGUAGE", Locale.class);
/**
* Attribute denoting the timezone identifier for display purposes.
*
* When printing a global type this attribute controls the zonal
* representation. If this attribute is missing then Time4J will throw
* an exception because the internal timezone reference UTC+00:00 of
* global types is not intended to be used for display purposes.
*
* When parsing a global type this attribute serves as replacement
* timezone if the parsing has not recognized any timezone or offset
* information in the text to be parsed. If the attribute is also missing
* then Time4J will throw an exception.
*
* Note that before version v2.0 the behaviour of Time4J was
* different. When printing, the default {@code ZonalOffset.UTC} was used.
* When parsing, the system default timezone was used as default in case
* of missing attribute and lax mode.
*/
/*[deutsch]
* Gibt die Zeitzonen-ID für die Verwendung in formatierten
* Darstellungen an.
*
* In der Textausgabe von globalen Typen kontrolliert dieses Attribut
* die zonale Darstellung. Fehlt das Attribut, wird Time4J eine Ausnahme
* werfen, weil der interne Zeitzonenbezug UTC+00:00 von globalen Typen
* nicht für Anzeigezwecke gedacht ist.
*
* Wenn umgekehrt ein Text als globaler Typ interpretiert werden soll,
* dient dieses Attribut als Ersatzwert, falls beim Parsen im Text keine
* Zeitzone und auch kein Offset erkannt werden konnten. Fehlt auch hier
* das Attribut, wird eine Ausnahme geworfen.
*
* Hinweis: Vor Version v2.0 war das Verhalten von Time4J anders.
* In der Textausgabe war der Standard immer {@code ZonalOffset.UTC}.
* Beim Parsen war die Systemzeitzone die Vorgabe im laxen Modus
* gewesen, bevor eine Ausnahme flog.
*/
public static final AttributeKey TIMEZONE_ID =
PredefinedKey.valueOf("TIMEZONE_ID", TZID.class);
/**
* Attribute for the conflict strategy to be used in resolving
* ambivalent or invalid local timestamps.
*
* If this attribute is missing then Time4J will assume the default
* conflict strategy.
*
* @see net.time4j.tz.Timezone#DEFAULT_CONFLICT_STRATEGY
*/
/*[deutsch]
* Gibt die Konfliktstrategie an, die bei der Auflösung von nicht
* eindeutigen lokalen Zeitstempeln zu verwenden ist.
*
* Fehlt das Attribut, wird eine Standardstrategie angenommen.
*
* @see net.time4j.tz.Timezone#DEFAULT_CONFLICT_STRATEGY
*/
public static final AttributeKey TRANSITION_STRATEGY =
PredefinedKey.valueOf("TRANSITION_STRATEGY", TransitionStrategy.class);
/**
* Attribute which controls the leniency in parsing.
*
* Setting of this attribute also changes other attributes:
*
*
* Legend
*
* LENIENCY
* {@link #PARSE_CASE_INSENSITIVE}
* {@link #PARSE_PARTIAL_COMPARE}
* {@link #TRAILING_CHARACTERS}
* {@link #PARSE_MULTIPLE_CONTEXT}
*
* STRICT false false false false SMART true false false true LAX true true true true
*
* Default value: {@link Leniency#SMART}
*/
/*[deutsch]
* Legt den Nachsichtigkeitsmodus beim Parsen fest.
*
* Das Setzen dieses Attributs beeinflußt auch andere
* Attribute:
*
*
* Legende
*
* LENIENCY
* {@link #PARSE_CASE_INSENSITIVE}
* {@link #PARSE_PARTIAL_COMPARE}
* {@link #TRAILING_CHARACTERS}
* {@link #PARSE_MULTIPLE_CONTEXT}
*
* STRICT false false false false SMART true false false true LAX true true true true
*
* Standardwert: {@link Leniency#SMART}
*/
public static final AttributeKey LENIENCY =
PredefinedKey.valueOf("LENIENCY", Leniency.class);
/**
* Determines the text width to be used in formatting and parsing.
*
* Default value: {@link TextWidth#WIDE}
*/
/*[deutsch]
* Gibt die verwendete Textbreite an.
*
* Standardwert: {@link TextWidth#WIDE}
*/
public static final AttributeKey TEXT_WIDTH =
PredefinedKey.valueOf("TEXT_WIDTH", TextWidth.class);
/**
* Determines the output context to be used in formatting and
* parsing.
*
* Default value: {@link OutputContext#FORMAT}
*/
/*[deutsch]
* Gibt den verwendeten Ausgabekontext an.
*
* Standardwert: {@link OutputContext#FORMAT}
*/
public static final AttributeKey OUTPUT_CONTEXT =
PredefinedKey.valueOf("OUTPUT_CONTEXT", OutputContext.class);
/**
* This attribute controls if the case of text is irrelevant
* in parsing or not.
*
* Default value: {@code true}
*/
/*[deutsch]
* Steuert, ob beim Parsen die Groß- und Kleinschreibung
* außer Acht gelassen werden soll.
*
* Standardwert: {@code true}
*/
public static final AttributeKey PARSE_CASE_INSENSITIVE =
PredefinedKey.valueOf("PARSE_CASE_INSENSITIVE", Boolean.class);
/**
* This attribute controls if the parser will only check the
* start of a chronological text.
*
* Abbreviations can be parsed by help of this attribute, too.
* Default value: {@code false}
*/
/*[deutsch]
* Steuert, ob beim Parsen nur Textanfänge geprüft werden
* sollen.
*
* Mit diesem Attribut können auch Abkürzungen noch
* sinnvoll interpretiert werden. Standardwert: {@code false}
*/
public static final AttributeKey PARSE_PARTIAL_COMPARE =
PredefinedKey.valueOf("PARSE_PARTIAL_COMPARE", Boolean.class);
/**
* This attribute controls if the parser will also try alternative
* output contexts if parsing with the original one fails.
*
* Relates to month names, weekday names and quarter names.
* Default value: {@code true}
*
* @see OutputContext
* @see #OUTPUT_CONTEXT
* @since 3.14/4.11
*/
/*[deutsch]
* Steuert, ob beim Parsen auch alternative Ausgabekontexte geprüft werden,
* wenn der ursprünglich angenommene Kontext fehlschlägt.
*
* Bezieht sich auf Monatsnamen, Wochentagsnamen und Quartalsnamen.
* Standardwert: {@code true}
*
* @see OutputContext
* @see #OUTPUT_CONTEXT
* @since 3.14/4.11
*/
public static final AttributeKey PARSE_MULTIPLE_CONTEXT =
PredefinedKey.valueOf("PARSE_MULTIPLE_CONTEXT", Boolean.class);
/**
* Determines the number system.
*
* In case of changing the language setting this attribute will
* automatically be adjusted. The {@link #ZERO_DIGIT attribute for zero digit}
* will be adjusted, too (if the number system is decimal) but can be set to
* another value however.
*
* If a non-decimal number system like roman numbers is chosen then Time4J
* will ignore it for any other format component than ordinary integers. For
* example, zone offsets in format ±hh:mm, fractional seconds, ordinals
* like "1st" or two-digit-years cannot be printed in roman numbers.
*
* @since 3.11/4.8
*/
/*[deutsch]
* Bestimmt das Zahlsystem.
*
* Diese Einstellung wird bei jeder Änderung der Spracheinstellung
* automatisch angepasst. Das {@link #ZERO_DIGIT Attribut für die Nullziffer}
* wird auch angepasst (falls das Zahlsystem dezimal ist), kann aber abweichend
* konfiguriert werden.
*
* Wenn ein nicht-dezimales Zahlsystem wie die römischen Zahlen gewählt wird,
* dann wird Time4J dieses Attribut ignorieren, sobald eine Formatkomponente betroffen ist,
* die nicht auf gewöhnlichen Integertypen basiert. Zum Beispiel können
* Zeitzonen-Offsets im Format ±hh:mm, Sekundenbruchteile, Ordinalzahlen wie
* "1st" (englisch) oder zweistellige Jahresangaben nicht in römischen
* Zahlen dargestellt werden.
*
* @since 3.11/4.8
*/
public static final AttributeKey NUMBER_SYSTEM =
PredefinedKey.valueOf("NUMBER_SYSTEM", NumberSystem.class);
/**
* Determines the unicode char for the zero digit.
*
* In case of changing the language setting or the (decimal) number system this attribute
* will automatically be adjusted to the default number system. For ISO-8601, the default
* value is the arab digit {@code 0} (corresponding to the ASCII-value 48).
*
* @see #NUMBER_SYSTEM
*/
/*[deutsch]
* Legt das Unicode-Zeichen für die Null-Ziffer fest.
*
* Diese Einstellung wird bei jeder Änderung der Spracheinstellung oder des
* (Dezimal-)Zahlsystems automatisch an das jeweilige Standard-Zahlsystem angepasst. Standardwert
* ist in ISO-8601 die arabische Ziffer {@code 0} (entsprechend dem ASCII-Wert 48).
*
* @see #NUMBER_SYSTEM
*/
public static final AttributeKey ZERO_DIGIT =
PredefinedKey.valueOf("ZERO_DIGIT", Character.class);
/**
* This attribute controls if the formatter will stop using the localized
* GMT prefix for representations of localized timezone offsets.
*
* Only relevant if the CLDR format pattern symbol O (or OOOO) is used.
*
* @since 3.13/4.10
*/
/*[deutsch]
* Steuert, ob der Formatierer das lokalisierte GMT-Präfix in der
* Repräsentation von lokalisierten Zeitzonen-Offsets unterdrückt.
*
* Nur relevant, wenn das CLDR Formatmustersymbol O (oder OOOO) verwendet wird.
*
* @since 3.13/4.10
*/
public static final AttributeKey NO_GMT_PREFIX =
PredefinedKey.valueOf("NO_GMT_PREFIX", Boolean.class);
/**
* Determines the unicode char for the decimal separator.
*
* In case of changing the language setting this attribute will automatically
* be adjusted. In ISO-8601 (for the root locale), the comma is the default value
* is the comma corresponding to the ASCII-value 44. With help of the boolean
* system property "net.time4j.format.iso.decimal.dot", the dot can be
* defined as alternative default value.
*/
/*[deutsch]
* Legt das Unicode-Zeichen für das Dezimaltrennzeichen fest.
*
* Diese Einstellung wird bei jeder Änderung der Spracheinstellung
* automatisch angepasst. Standardwert ist in ISO-8601 das Komma (also
* der ASCII-Wert 44). Mit Hilfe der bool'schen System-Property
* "net.time4j.format.iso.decimal.dot" kann auch der Punkt
* als alternativer Standardwert definiert werden.
*/
public static final AttributeKey DECIMAL_SEPARATOR =
PredefinedKey.valueOf("DECIMAL_SEPARATOR", Character.class);
/**
* Determines the pad char to be used for non-decimal elements if a formatted representation is
* shorter than specified.
*
* This attribute is mainly interesting for text elements.
*
* Default value is the space. Numerical elements using decimal numbering systems are not affected
* by this attribute because they always use the zero digit as pad char. However, other numbering
* systems like Roman numbers can be combined with this attribute if a padding instruction is also
* defined in the formatter. Example for numerical but non-decimal elements:
*
*
* ChronoFormatter<PlainDate> f =
* ChronoFormatter.setUp(PlainDate.axis(), Locale.ROOT)
* .addFixedInteger(PlainDate.YEAR, 4)
* .addLiteral('-')
* .padNext(2)
* .addInteger(PlainDate.MONTH_AS_NUMBER, 1, 2)
* .addLiteral('-')
* .padNext(2)
* .addInteger(PlainDate.DAY_OF_MONTH, 1, 2)
* .build()
* .with(Attributes.NUMBER_SYSTEM, NumberSystem.DOZENAL) // non-decimal!
* .with(Attributes.PAD_CHAR, '0');
*
* assertThat(
* f.format(PlainDate.of(2017, 10, 11)),
* is("1201-0\u218A-0\u218B"));
*
*/
/*[deutsch]
* Legt das Füllzeichen in nicht-dezimalen Elementen fest, das verwendet wird,
* wenn eine formatierte Darstellung kürzer als mindestens angegeben
* ist.
*
* Dieses Attribut ist vor allem für Textelemente interessant.
*
* Standardwert ist das Leerzeichen. Numerische Elemente, die das Dezimalsystem verwenden, sind hiervon
* nicht berührt, da sie immer die Nullziffer als Füllzeichen verwenden. Allerdings können
* andere Zahlsysteme wie die römischen Zahlen mit diesem Attribut kombiniert werden, soweit der
* Formatierer noch eine Füllzeichenanweisung enthält. Beispiel für numerische aber
* nicht-dezimale Elemente:
*
*
* ChronoFormatter<PlainDate> f =
* ChronoFormatter.setUp(PlainDate.axis(), Locale.ROOT)
* .addFixedInteger(PlainDate.YEAR, 4)
* .addLiteral('-')
* .padNext(2)
* .addInteger(PlainDate.MONTH_AS_NUMBER, 1, 2)
* .addLiteral('-')
* .padNext(2)
* .addInteger(PlainDate.DAY_OF_MONTH, 1, 2)
* .build()
* .with(Attributes.NUMBER_SYSTEM, NumberSystem.DOZENAL) // nicht dezimal!
* .with(Attributes.PAD_CHAR, '0');
*
* assertThat(
* f.format(PlainDate.of(2017, 10, 11)),
* is("1201-0\u218A-0\u218B"));
*
*/
public static final AttributeKey PAD_CHAR =
PredefinedKey.valueOf("PAD_CHAR", Character.class);
/**
* Determines the pivot year for the representation of
* two-digit-years.
*
* Default value is the year which is 20 years after the current
* year. Example: If the pivot year has the value {@code 2034} then
* a two-digit-year will be mapped to the range 1934-2033 such that
* the last two digits are equal. This attribute must have at least
* three digits an be positive else an exception will be thrown.
*/
/*[deutsch]
* Legt das Kippjahr zur zweistelligen Darstellung von Jahreselementen
* fest.
*
* Standardwert ist das Jahr, das 20 Jahre nach dem aktuellen Jahr
* liegt. Hat zum Beispiel das Kippjahr den Wert {@code 2034}, dann
* wird eine zweistellige Jahresangabe auf das Intervall 1934-2033
* so abgebildet, daß die letzten zwei Ziffern gleich sind.
* Kippjahresangaben müssen mindestens 3-stellig und positiv sein,
* sonst wird ein solcher Versuch mit einer Ausnahme quittiert.
*/
public static final AttributeKey PIVOT_YEAR =
PredefinedKey.valueOf("PIVOT_YEAR", Integer.class);
/**
* Controls if any trailing unparsed characters will be
* tolerated or not.
*
* Example:
*
*
* ChronoFormatter formatter =
* ChronoFormatter.setUp(PlainTime.class, Locale.US)
* .addInteger(PlainTime.CLOCK_HOUR_OF_AMPM, 1, 2)
* .addLiteral(' ')
* .addText(PlainTime.AM_PM_OF_DAY)
* .padPrevious(3)
* .addFixedInteger(PlainTime.MINUTE_OF_HOUR, 2)
* .build()
* .with(Attributes.TRAILING_CHARACTERS, true);
* System.out.println(formatter.parse("5 PM 45xyz"));
* // Output: T17:45
*
*
* Starting with version v3.25/4.21, this attribute will only matter if users don't explicitly
* specify a {@code ParseLog} or a {@code ParsePosition}. Otherwise - with explicit parse log or
* position - the parser will always tolerate trailing characters.
*
* Default value: {@code false} in strict or smart mode
*/
/*[deutsch]
* Steuert, ob beim Parsen verbleibende Zeichen der Texteingabe
* toleriert werden.
*
* Beispiel:
*
*
* ChronoFormatter formatter =
* ChronoFormatter.setUp(PlainTime.class, Locale.US)
* .addInteger(PlainTime.CLOCK_HOUR_OF_AMPM, 1, 2)
* .addLiteral(' ')
* .addText(PlainTime.AM_PM_OF_DAY)
* .padPrevious(3)
* .addFixedInteger(PlainTime.MINUTE_OF_HOUR, 2)
* .build()
* .with(Attributes.TRAILING_CHARACTERS, true);
* System.out.println(formatter.parse("5 PM 45xyz"));
* // Output: T17:45
*
*
* Beginnend mit der Version v3.25/4.21 spielt dieses Formatattribut nur eine Rolle, wenn Anwender
* kein {@code ParseLog} oder eine {@code ParsePosition} angeben. Sonst - mit extra Angaben zur Position -
* wird der Interpretierer immer verbleibende Zeichen tolerieren.
*
* Standardwert: {@code false} wenn kein laxer Modus vorliegt
*/
public static final AttributeKey TRAILING_CHARACTERS =
PredefinedKey.valueOf("TRAILING_CHARACTERS", Boolean.class);
/**
* Determines how many remaining chars in a given text are reserved
* and cannot be consumed by the current format step.
*
* Default value is {@code 0}. This attribute can be used as sectional
* attribute if an integer element is numerically processed. Such a
* protected element will not consume any following chars and possibly
* use the default value setting of the current formatter instead.
*
* Note: This attribute overrides any reserved area due to
* adjacent digit parsing.
*
* @since 2.0
*/
/*[deutsch]
* Legt fest, wieviele der verbleibenden Zeichen in einem zu
* interpretierenden Text reserviert und damit nicht vom aktuellen
* Formatschritt konsumiert werden können.
*
* Standardwert ist {@code 0}. Dieses Attribut eignet sich als
* sektionales Attribut, wenn ein Integer-Element numerisch
* verarbeitet wird. So ein geschütztes Element wird keine
* folgenden Zeichen konsumieren und eventuell den Standardwert
* des aktuellen Formatierers verwenden.
*
* Hinweis: Dieses Attribut überlagert reservierte Ziffernbereiche,
* die dem Modus adjacent digit parsing von nachgelagerten Elementen
* mit fester Ziffernbreite zuzuschreiben sind.
*
* @since 2.0
*/
public static final AttributeKey PROTECTED_CHARACTERS =
PredefinedKey.valueOf("PROTECTED_CHARACTERS", Integer.class);
/**
* Defines an attribute key which can be used in queries for the calendar variant.
*
* @since 3.5/4.3
*/
/*[deutsch]
* Definiert ein Formatattribut, das in Abfragen nach der Kalendervariante verwendet werden kann.
*
* @since 3.5/4.3
*/
public static final AttributeKey CALENDAR_VARIANT =
PredefinedKey.valueOf("CALENDAR_VARIANT", String.class);
/**
* Defines an attribute key which can be used in queries for the start of day during formatting or parsing.
*
* The default value is {@link StartOfDay#MIDNIGHT}.
*
* @since 3.5/4.3
*/
/*[deutsch]
* Definiert ein Formatattribut, das in Abfragen nach dem Start eines Kalendertages beim Formatieren
* und Parsen verwendet werden kann.
*
* Der Standardwert ist {@link StartOfDay#MIDNIGHT}.
*
* @since 3.5/4.3
*/
public static final AttributeKey START_OF_DAY =
PredefinedKey.valueOf("START_OF_DAY", StartOfDay.class);
/**
* This attribute controls if style-driven date patterns should always have four-digit-years or not.
*
* Default value: {@code false}
*
* @since 3.26/4.22
*/
/*[deutsch]
* Steuert, ob stil-basierte Datumsformatmuster immer vierstellige Jahreszahlen haben oder nicht.
*
* Standardwert: {@code false}
*
* @since 3.26/4.22
*/
public static final AttributeKey FOUR_DIGIT_YEAR =
PredefinedKey.valueOf("FOUR_DIGIT_YEAR", Boolean.class);
/**
* Attribute for the time scale to be used in parsing
* or formatting universal timestamps.
*
* If this attribute is missing then Time4J will assume the default UTC scale. Example for TAI:
*
*
* assertThat(
* ChronoFormatter.ofMomentPattern(
* "uuuu-MM-dd'T'HH:mm:ss.SSSSSSSSSX",
* PatternType.CLDR,
* Locale.ROOT,
* ZonalOffset.UTC)
* .with(Attributes.TIME_SCALE, TimeScale.TAI)
* .parse("2012-07-01T00:00:34.123456789Z")
* .toString(),
* is("2012-06-30T23:59:60,123456789Z")); // 35 seconds delta between UTC and TAI
*
*
* @since 3.28/4.24
*/
/*[deutsch]
* Gibt die Zeitskala an, die bei der Auflösung oder Formatierung von
* universellen Zeitstempeln zu verwenden ist.
*
* Fehlt das Attribut, wird die UTC-Skala als Standard angenommen. Beispiel für TAI:
*
*
* assertThat(
* ChronoFormatter.ofMomentPattern(
* "uuuu-MM-dd'T'HH:mm:ss.SSSSSSSSSX",
* PatternType.CLDR,
* Locale.ROOT,
* ZonalOffset.UTC)
* .with(Attributes.TIME_SCALE, TimeScale.TAI)
* .parse("2012-07-01T00:00:34.123456789Z")
* .toString(),
* is("2012-06-30T23:59:60,123456789Z")); // 35 Sekunden zwischen UTC und TAI
*
*
* @since 3.28/4.24
*/
public static final AttributeKey TIME_SCALE =
PredefinedKey.valueOf("TIME_SCALE", TimeScale.class);
private static final Attributes EMPTY = new Attributes.Builder().build();
//~ Instanzvariablen --------------------------------------------------
private final Map attributes;
//~ Konstruktoren -----------------------------------------------------
private Attributes(Map map) {
super();
this.attributes = Collections.unmodifiableMap(new HashMap<>(map));
}
//~ Methoden ----------------------------------------------------------
/**
* Represents an empty collection of format attributes.
*
* @return empty attribute query
*/
/*[deutsch]
* Repräsentiert eine leere Menge von Formatattributen.
*
* @return empty attribute query
*/
public static Attributes empty() {
return EMPTY;
}
/**
* Creates a new attribute key.
*
* @param generic immutable type of attribute value
* @param name name of attribute
* @param type type of attribute
* @return new attribute key
* @since 3.13/4.10
*/
/*[deutsch]
* Erzeugt einen neuen Attributschlüssel.
*
* @param generic immutable type of attribute value
* @param name name of attribute
* @param type type of attribute
* @return new attribute key
* @since 3.13/4.10
*/
public static AttributeKey createKey(
String name,
Class type
) {
return PredefinedKey.valueOf(name, type);
}
@Override
public boolean contains(AttributeKey key) {
return this.attributes.containsKey(key.name());
}
@Override
public A get(AttributeKey key) {
Object obj = this.attributes.get(key.name());
if (obj == null) {
throw new NoSuchElementException(key.name());
} else {
return key.type().cast(obj);
}
}
@Override
public A get(
AttributeKey key,
A defaultValue
) {
Object obj = this.attributes.get(key.name());
if (obj == null) {
return defaultValue;
} else {
return key.type().cast(obj);
}
}
/**
* Compares all internal format attributes.
*/
/*[deutsch]
* Vergleicht auf Basis aller internen Formatattribute.
*/
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
} else if (obj instanceof Attributes) {
Attributes that = (Attributes) obj;
return this.attributes.equals(that.attributes);
} else {
return false;
}
}
/*[deutsch]
* Berechnet den Hash-Code.
*/
@Override
public int hashCode() {
return this.attributes.hashCode();
}
/**
* Supports mainly debugging.
*/
/*[deutsch]
* Dient vorwiegend der Debugging-Unterstützung.
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder(this.attributes.size() * 32);
sb.append(this.getClass().getName());
sb.append('[');
sb.append(this.attributes);
sb.append(']');
return sb.toString();
}
//~ Innere Klassen ----------------------------------------------------
/**
* Builds a collection of format attributes.
*
* @doctags.concurrency {mutable}
*/
/*[deutsch]
* Baut eine Menge von Formatattributen.
*
* @doctags.concurrency {mutable}
*/
public static final class Builder {
//~ Instanzvariablen ----------------------------------------------
private final Map attributes = new HashMap<>();
//~ Konstruktoren -------------------------------------------------
/**
* Default constructor.
*/
/*[deutsch]
* Standard-Konstruktor.
*/
public Builder() {
super();
}
/**
* Constructor for determining the calendar type.
*
* @param chronology object with possible calendar type
* @since 3.0
* @see #CALENDAR_TYPE
*/
/*[deutsch]
* Konstruktor zum Ableiten des Kalendertyps.
*
* @param chronology object with possible calendar type
* @since 3.0
* @see #CALENDAR_TYPE
*/
public Builder(Chronology chronology) {
super();
this.setInternal(CALENDAR_TYPE, CalendarText.extractCalendarType(chronology));
}
//~ Methoden ------------------------------------------------------
/**
* Sets the language.
*
* @param locale new language setting
* @return this instance for method chaining
* @see #LANGUAGE
*/
/*[deutsch]
* Setzt die Spracheinstellung.
*
* @param locale new language setting
* @return this instance for method chaining
* @see #LANGUAGE
*/
public Builder setLanguage(Locale locale) {
this.setInternal(LANGUAGE, locale);
return this;
}
/**
* Sets the timezone reference.
*
* @param tzid timezone id
* @return this instance for method chaining
* @see #TIMEZONE_ID
*/
/*[deutsch]
* Setzt die Zeitzonenreferenz.
*
* @param tzid timezone id
* @return this instance for method chaining
* @see #TIMEZONE_ID
*/
public Builder setTimezone(TZID tzid) {
this.setInternal(TIMEZONE_ID, tzid);
return this;
}
/**
* Sets the timezone reference.
*
* @param tzid timezone id
* @return this instance for method chaining
* @throws IllegalArgumentException if given timezone cannot be loaded
* @see #TIMEZONE_ID
* @since 1.1
*/
/*[deutsch]
* Setzt die Zeitzonenreferenz.
*
* @param tzid timezone id
* @return this instance for method chaining
* @throws IllegalArgumentException if given timezone cannot be loaded
* @see #TIMEZONE_ID
* @since 1.1
*/
public Builder setTimezone(String tzid) {
this.setTimezone(Timezone.of(tzid).getID());
return this;
}
/**
* Sets the system timezone reference.
*
* @return this instance for method chaining
* @see #TIMEZONE_ID
* @see Timezone#ofSystem()
*/
/*[deutsch]
* Legt die Systemzeitzone als Zeitzonenreferenz fest.
*
* @return this instance for method chaining
* @see #TIMEZONE_ID
* @see Timezone#ofSystem()
*/
public Builder setStdTimezone() {
return this.setTimezone(Timezone.ofSystem().getID());
}
/**
* Sets the calendar variant.
*
* @param variant calendar variant
* @return this instance for method chaining
* @see #CALENDAR_VARIANT
* @see net.time4j.engine.CalendarVariant
* @since 3.5/4.3
*/
/*[deutsch]
* Setzt die Kalendervariante.
*
* @param variant calendar variant
* @return this instance for method chaining
* @see #CALENDAR_VARIANT
* @see net.time4j.engine.CalendarVariant
* @since 3.5/4.3
*/
public Builder setCalendarVariant(String variant) {
this.setInternal(CALENDAR_VARIANT, variant);
return this;
}
/**
* Sets an attribute of {@code boolean}-type.
*
* @param key attribute key
* @param value attribute value
* @return this instance for method chaining
*/
/*[deutsch]
* Setzt ein Formatattribut vom {@code boolean}-Typ.
*
* @param key attribute key
* @param value attribute value
* @return this instance for method chaining
*/
public Builder set(
AttributeKey key,
boolean value
) {
this.attributes.put(key.name(), Boolean.valueOf(value));
return this;
}
/**
* Sets an attribute of {@code int}-type.
*
* @param key attribute key
* @param value attribute value
* @return this instance for method chaining
* @throws IllegalArgumentException if an invalid pivot year is given
*/
/*[deutsch]
* Setzt ein Formatattribut vom {@code int}-Typ.
*
* @param key attribute key
* @param value attribute value
* @return this instance for method chaining
* @throws IllegalArgumentException if an invalid pivot year is given
*/
public Builder set(
AttributeKey key,
int value
) {
if (
(key == Attributes.PIVOT_YEAR)
&& (value < 100)
) {
throw new IllegalArgumentException(
"Pivot year in far past not supported: " + value);
}
this.attributes.put(key.name(), Integer.valueOf(value));
return this;
}
/**
* Sets an attribute of {@code char}-type.
*
* @param key attribute key
* @param value attribute value
* @return this instance for method chaining
*/
/*[deutsch]
* Setzt ein Formatattribut vom {@code char}-Typ.
*
* @param key attribute key
* @param value attribute value
* @return this instance for method chaining
*/
public Builder set(
AttributeKey key,
char value
) {
this.attributes.put(key.name(), Character.valueOf(value));
return this;
}
/**
* Sets an attribute of {@code enum}-type.
*
* @param generic type of attribute
* @param key attribute key
* @param value attribute value
* @return this instance for method chaining
*/
/*[deutsch]
* Setzt ein Formatattribut vom {@code enum}-Typ.
*
* @param generic type of attribute
* @param key attribute key
* @param value attribute value
* @return this instance for method chaining
*/
public > Builder set(
AttributeKey key,
A value
) {
if (value == null) {
throw new NullPointerException("Missing attribute value.");
} else if (!(value instanceof Enum)) {
throw new ClassCastException( // Schutz gegen raw-type-Fehler
"Enum expected, but found: " + value);
}
this.attributes.put(key.name(), value);
if (key.equals(Attributes.LENIENCY)) {
switch (Leniency.class.cast(value)) {
case STRICT:
this.set(Attributes.PARSE_CASE_INSENSITIVE, false);
this.set(Attributes.PARSE_PARTIAL_COMPARE, false);
this.set(Attributes.TRAILING_CHARACTERS, false);
this.set(Attributes.PARSE_MULTIPLE_CONTEXT, false);
break;
case SMART:
this.set(Attributes.PARSE_CASE_INSENSITIVE, true);
this.set(Attributes.PARSE_PARTIAL_COMPARE, false);
this.set(Attributes.TRAILING_CHARACTERS, false);
this.set(Attributes.PARSE_MULTIPLE_CONTEXT, true);
break;
case LAX:
this.set(Attributes.PARSE_CASE_INSENSITIVE, true);
this.set(Attributes.PARSE_PARTIAL_COMPARE, true);
this.set(Attributes.TRAILING_CHARACTERS, true);
this.set(Attributes.PARSE_MULTIPLE_CONTEXT, true);
break;
default:
throw new UnsupportedOperationException(value.name());
}
} else if (key.equals(Attributes.NUMBER_SYSTEM)) {
NumberSystem numsys = NumberSystem.class.cast(value);
if (numsys.isDecimal()) {
this.set(Attributes.ZERO_DIGIT, numsys.getDigits().charAt(0));
}
}
return this;
}
/**
* Accepts all given attributes.
*
* If an attribute already exists then it will
* be overridden.
*
* @param attributes format attributes
* @return this instance for method chaining
*/
/*[deutsch]
* Übernimmt alle angegebenen Attribute.
*
* Existiert ein Formatattribut schon, wird es
* überschrieben.
*
* @param attributes format attributes
* @return this instance for method chaining
*/
public Builder setAll(Attributes attributes) {
this.attributes.putAll(attributes.attributes);
return this;
}
/**
* Removes the specified attribute.
*
* @param key attribute key to be removed
* @return this instance for method chaining
*/
/*[deutsch]
* Entfernt das angegebene Attribut.
*
* @param key attribute key to be removed
* @return this instance for method chaining
*/
public Builder remove(AttributeKey key) {
this.attributes.remove(key.name());
return this;
}
/**
* Creates a new unmodifiable collection of format attributes.
*
* @return new instance of {@code Attributes}
*/
/*[deutsch]
* Erzeugt eine neue unveränderliche Instanz der
* Formatattribute.
*
* @return new instance of {@code Attributes}
*/
public Attributes build() {
return new Attributes(this.attributes);
}
private void setInternal(
AttributeKey key,
A value
) {
if (value == null) {
throw new NullPointerException("Missing attribute value.");
}
this.attributes.put(key.name(), value);
}
}
}