Class ArgumentList.Argument
- java.lang.Object
-
- de.bsvrz.sys.funclib.commandLineArgs.ArgumentList.Argument
-
- Enclosing class:
- ArgumentList
public static class ArgumentList.Argument extends java.lang.ObjectKlasse zum Zugriff auf Name und Wert eines Aufrufarguments.
-
-
Field Summary
Fields Modifier and Type Field Description static java.util.regex.PatternBYTE_DELIM_PATTERNstatic java.util.regex.PatternBYTE_UNIT_PATTERNstatic java.util.regex.PatternDURATION_PATTERNstatic java.util.regex.PatternDURATION_PATTERN_2
-
Method Summary
Modifier and Type Method Description longasAbsoluteTime()Interpretiert den Wert des Arguments als absolute Zeitangabe.longasByteSize()Interpretiert das Aufrufargument als eine Datenmenge, Beispielsweise würde "-test=10M" 10 Megabytes entsprechen.java.io.FileasChangeableFile()Gibt den Wert des Arguments als Datei-Identifikation einer änderbaren Datei zurück.java.io.FileasChangeableFile(boolean createIfNotExistent)Gibt den Wert des Arguments als Datei-Identifikation einer änderbaren Datei zurück.java.io.FileasDirectory()Gibt den Wert des Arguments als Datei-Identifikation eines Dateiverzeichnisses zurück.java.time.DurationasDuration()Interpretiert den Wert des Arguments als Zeitdauer (KlasseDuration.<E> EasEnum(java.lang.Class<E> typeClass)Bestimmt den Wert des Arguments als Enum-Konstante.java.io.FileasExistingFile()Gibt den Wert des Arguments als Datei-Identifikation einer existierenden Datei zurück.java.io.FileasFile()Gibt den Wert des Arguments als Datei-Identifikation zurück.java.time.InstantasInstant()Gibt die angegebene Datum+Uhrzeit alsInstantzurück (in der lokalen Standardzeitzone).java.time.LocalDateasLocalDate()Gibt das angegebene Datum zurück, im Format dd.MM.yyyy.java.time.LocalDateTimeasLocalDateTime()Ermittelt ein Datum alsLocalDateTime.java.time.LocalTimeasLocalTime()Gibt die angegebene Zeit zurück, im Format HH:mm:ss,SSS.java.lang.StringasNonEmptyString()Bestimmt den Wert des Arguments als nicht leere Zeichenkette.java.nio.file.PathasPath()Gibt den Wert des Arguments als Datei-Identifikation zurück.java.io.FileasReadableFile()Gibt den Wert des Arguments als Datei-Identifikation einer lesbaren Datei zurück.longasRelativeTime()Interpretiert den Wert des Arguments als relative Zeitangabe.java.math.BigDecimalasSiUnit(java.lang.String siUnit)Gibt den Wert dieses Arguments als Wert einer SI-Einheit zurück.java.lang.StringasString()Bestimmt den Wert des Arguments als Zeichenkette.longasTime()Interpretiert den Wert des Arguments als Zeitangabe.ArgumentList.ValueCaseasValueCase(ArgumentList.ValueSelection validValues)java.io.FileasWritableFile()Gibt den Wert des Arguments als Datei-Identifikation einer beschreibaren Datei zurück.java.io.FileasWritableFile(boolean createIfNotExistent)Gibt den Wert des Arguments als Datei-Identifikation einer beschreibaren Datei zurück.booleanbooleanValue()Gibt den Wert des Arguments alsbooleanWert zurück.bytebyteValue()Gibt den Wert des Arguments alsbyteWert zurück.bytebyteValueBetween(byte minimum, byte maximum)Gibt den Wert des Arguments alsbyteWert zurück.doubledoubleValue()Gibt den Wert des Arguments alsdoubleWert zurück.doubledoubleValueBetween(double minimum, double maximum)Gibt den Wert des Arguments alsdoubleWert zurück.floatfloatValue()Gibt den Wert des Arguments alsfloatWert zurück.floatfloatValueBetween(float minimum, float maximum)Gibt den Wert des Arguments alsfloatWert zurück.java.lang.StringgetName()Bestimmt den Namen des Arguments.java.lang.StringgetValue()Bestimmt den Wert des Arguments.booleanhasValue()Überprüft, ob das Argument einen Wert hat.intintValue()Gibt den Wert des Arguments alsintWert zurück.intintValueBetween(int minimum, int maximum)Gibt den Wert des Arguments alsintWert zurück.longlongValue()Gibt den Wert des Arguments alslongWert zurück.longlongValueBetween(long minimum, long maximum)Gibt den Wert des Arguments alslongWert zurück.shortshortValue()Gibt den Wert des Arguments alsshortWert zurück.shortshortValueBetween(short minimum, short maximum)Gibt den Wert des Arguments alsshortWert zurück.ArgumentList.ArgumenttoArgumentWithNameAsValue()Erzeugt ein neues Argument dessen Wert aus dem Namen dieses Arguments übernommen wird.java.lang.StringtoString()Erzeugt eine Zeichenkette, die den Namen und den Wert des Arguments enthält.
-
-
-
Field Detail
-
DURATION_PATTERN
public static final java.util.regex.Pattern DURATION_PATTERN
-
DURATION_PATTERN_2
public static final java.util.regex.Pattern DURATION_PATTERN_2
-
BYTE_UNIT_PATTERN
public static final java.util.regex.Pattern BYTE_UNIT_PATTERN
-
BYTE_DELIM_PATTERN
public static final java.util.regex.Pattern BYTE_DELIM_PATTERN
-
-
Method Detail
-
toArgumentWithNameAsValue
public ArgumentList.Argument toArgumentWithNameAsValue()
Erzeugt ein neues Argument dessen Wert aus dem Namen dieses Arguments übernommen wird.- Returns:
- Neues Argument-Objekt
-
getName
public java.lang.String getName()
Bestimmt den Namen des Arguments.- Returns:
- Name des Arguments.
-
hasValue
public boolean hasValue()
Überprüft, ob das Argument einen Wert hat. Wenn das Argument keinen Wert hat, kann nur noch mit der Methode #booleanValue()auf den Wert zugegriffen werden, ohne daß eine Ausnahme generiert wird.- Returns:
true, falls das Argument einen Wert hat; sonstfalse.
-
getValue
public java.lang.String getValue()
Bestimmt den Wert des Arguments.- Returns:
- Wert des Arguments.
- Throws:
java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
booleanValue
public boolean booleanValue() throws java.lang.IllegalArgumentExceptionGibt den Wert des Arguments alsbooleanWert zurück. Die Argumentwerte "wahr", "ja", "1" werden zum Boolschen Werttruekonvertiert; die Argumentwerte "falsch", "nein", "0" werden zum Boolschen Wertfalsekonvertiert. Die Groß-/Kleinschreibung des Argumentwerts hat beim Vergleich keine Relevanz. Wenn das Argument keinen Wert hat, dann wird als Ergebnis der Konvertierungtruezurückgegeben.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.IllegalArgumentException- Wenn der Argumentwert nicht konvertiert werden konnte.
-
byteValue
public byte byteValue() throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alsbyteWert zurück. Der Argumentwert wird in einen Zahlwert vom Typbytekonvertiert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
shortValue
public short shortValue() throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alsshortWert zurück. Der Argumentwert wird in einen Zahlwert vom Typshortkonvertiert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
intValue
public int intValue() throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alsintWert zurück. Der Argumentwert wird in einen Zahlwert vom Typintkonvertiert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
longValue
public long longValue() throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alslongWert zurück. Der Argumentwert wird in einen Zahlwert vom Typlongkonvertiert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
floatValue
public float floatValue() throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alsfloatWert zurück. Der Argumentwert wird in einen Zahlwert vom Typfloatkonvertiert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
doubleValue
public double doubleValue() throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alsdoubleWert zurück. Der Argumentwert wird in einen Zahlwert vom Typdoublekonvertiert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
byteValueBetween
public byte byteValueBetween(byte minimum, byte maximum) throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alsbyteWert zurück. Der Argumentwert wird in einen Zahlwert vom Typbytekonvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.- Parameters:
minimum- Kleinster erlaubter Wert.maximum- Größter erlaubter Wert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.IllegalArgumentException- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
shortValueBetween
public short shortValueBetween(short minimum, short maximum) throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alsshortWert zurück. Der Argumentwert wird in einen Zahlwert vom Typshortkonvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.- Parameters:
minimum- Kleinster erlaubter Wert.maximum- Größter erlaubter Wert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.IllegalArgumentException- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
intValueBetween
public int intValueBetween(int minimum, int maximum) throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alsintWert zurück. Der Argumentwert wird in einen Zahlwert vom Typintkonvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.- Parameters:
minimum- Kleinster erlaubter Wert.maximum- Größter erlaubter Wert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.IllegalArgumentException- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
longValueBetween
public long longValueBetween(long minimum, long maximum) throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alslongWert zurück. Der Argumentwert wird in einen Zahlwert vom Typlongkonvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.- Parameters:
minimum- Kleinster erlaubter Wert.maximum- Größter erlaubter Wert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.IllegalArgumentException- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
floatValueBetween
public float floatValueBetween(float minimum, float maximum) throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alsfloatWert zurück. Der Argumentwert wird in einen Zahlwert vom Typfloatkonvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.- Parameters:
minimum- Kleinster erlaubter Wert.maximum- Größter erlaubter Wert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.IllegalArgumentException- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
doubleValueBetween
public double doubleValueBetween(double minimum, double maximum) throws java.lang.NumberFormatExceptionGibt den Wert des Arguments alsdoubleWert zurück. Der Argumentwert wird in einen Zahlwert vom Typdoublekonvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.- Parameters:
minimum- Kleinster erlaubter Wert.maximum- Größter erlaubter Wert.- Returns:
- Der konvertierte Argumentwert.
- Throws:
java.lang.IllegalArgumentException- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asFile
public java.io.File asFile()
Gibt den Wert des Arguments als Datei-Identifikation zurück. Der Argumentwert wird als Dateiname der Datei interpretiert.- Returns:
- Dateiobjekt zum Zugriff auf die durch den Argumentwert identifizierten Datei.
- Throws:
java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asPath
public java.nio.file.Path asPath()
Gibt den Wert des Arguments als Datei-Identifikation zurück. Der Argumentwert wird als Dateiname der Datei interpretiert.- Returns:
- Dateiobjekt zum Zugriff auf die durch den Argumentwert identifizierten Datei.
- Throws:
java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asExistingFile
public java.io.File asExistingFile()
Gibt den Wert des Arguments als Datei-Identifikation einer existierenden Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert.- Returns:
- Dateiobjekt zum Zugriff auf die durch den Argumentwert identifizierten Datei.
- Throws:
java.lang.IllegalArgumentException- Wenn die identifizierte Datei nicht existiert.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asReadableFile
public java.io.File asReadableFile()
Gibt den Wert des Arguments als Datei-Identifikation einer lesbaren Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert und ob ein lesender Zugriff erlaubt ist.- Returns:
- Dateiobjekt zum Zugriff auf die durch den Argumentwert identifizierten Datei.
- Throws:
java.lang.IllegalArgumentException- Wenn die identifizierte Datei nicht existiert oder nicht lesbar ist.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asWritableFile
public java.io.File asWritableFile()
Gibt den Wert des Arguments als Datei-Identifikation einer beschreibaren Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert und ob ein schreibender Zugriff erlaubt ist.- Returns:
- Dateiobjekt zum Zugriff auf die durch den Argumentwert identifizierten Datei.
- Throws:
java.lang.IllegalArgumentException- Wenn die identifizierte Datei nicht existiert oder nicht beschreibar ist.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asWritableFile
public java.io.File asWritableFile(boolean createIfNotExistent) throws java.io.IOExceptionGibt den Wert des Arguments als Datei-Identifikation einer beschreibaren Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert und ob ein schreibender Zugriff erlaubt ist.- Parameters:
createIfNotExistent- Wenn die spezifizierte Datei nicht existiert und dieser Parameter den Werttruehat, wird eine neue Datei erzeugt.- Returns:
- Dateiobjekt zum Zugriff auf die durch den Argumentwert identifizierten Datei.
- Throws:
java.lang.IllegalArgumentException- Wenn die identifizierte Datei nicht existiert und nicht angelegt werden sollte oder nicht beschreibar ist.java.io.IOException- Wenn die Datei nicht angelegt werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asChangeableFile
public java.io.File asChangeableFile()
Gibt den Wert des Arguments als Datei-Identifikation einer änderbaren Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert und ob ein lesender und schreibender Zugriff erlaubt ist.- Returns:
- Dateiobjekt zum Zugriff auf die durch den Argumentwert identifizierten Datei.
- Throws:
java.lang.IllegalArgumentException- Wenn die identifizierte Datei nicht existiert oder nicht nicht lesbar oder nicht beschreibar ist.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asChangeableFile
public java.io.File asChangeableFile(boolean createIfNotExistent) throws java.io.IOExceptionGibt den Wert des Arguments als Datei-Identifikation einer änderbaren Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert und ob ein lesender und schreibender Zugriff erlaubt ist.- Parameters:
createIfNotExistent- Wenn die spezifizierte Datei nicht existiert und dieser Parameter den Werttruehat, wird eine neue Datei erzeugt.- Returns:
- Dateiobjekt zum Zugriff auf die durch den Argumentwert identifizierten Datei.
- Throws:
java.lang.IllegalArgumentException- Wenn die identifizierte Datei nicht existiert und nicht angelegt werden sollte oder nicht lesbar oder nicht beschreibar ist.java.io.IOException- Wenn die Datei nicht angelegt werden konnte.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asDirectory
public java.io.File asDirectory()
Gibt den Wert des Arguments als Datei-Identifikation eines Dateiverzeichnisses zurück. Der Argumentwert wird als Dateiname des Dateiverzeichnisses interpretiert. Es wird geprüft, ob die spezifizierte Datei existiert und ein Verzeichnis ist.- Returns:
- Dateiobjekt zum Zugriff auf das durch den Argumentwert identifizierte Dateiverzeichnis.
- Throws:
java.lang.IllegalArgumentException- Wenn die identifizierte Datei nicht existiert oder kein Verzeichnis ist.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asString
public java.lang.String asString()
Bestimmt den Wert des Arguments als Zeichenkette.- Returns:
- Wert des Arguments.
- Throws:
java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asNonEmptyString
public java.lang.String asNonEmptyString()
Bestimmt den Wert des Arguments als nicht leere Zeichenkette.- Returns:
- Wert des Arguments.
- Throws:
java.lang.IllegalArgumentException- Wenn der Argumentwert leer ist.java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
asValueCase
public ArgumentList.ValueCase asValueCase(ArgumentList.ValueSelection validValues)
-
asEnum
public <E> E asEnum(java.lang.Class<E> typeClass)
Bestimmt den Wert des Arguments als Enum-Konstante.- Parameters:
typeClass- Klasse von dem der Enum-Wert eingelesen werden soll. Unterstützt native Enum-Klassen und Enum-ähnliche Klassen, mit festen öffentlichen Konstanten. Groß- und Kleinschreibung wird ignoriert.- Returns:
- Wert des Arguments.
- Throws:
java.lang.IllegalArgumentException- Wenn der Argumentwert leer oder ungültig ist.
-
asTime
public long asTime()
Interpretiert den Wert des Arguments als Zeitangabe. Erkannt werden absolute Zeitangabe wie in der MethodeasAbsoluteTime()und relative Zeitangaben wie in der Methode @{link #asRelativeTime}. Wenn eine relative Zeitangabe angegeben wurde, wird der angegebene Wert vom aktuellen Zeitpunkt abgezogen d.h. das Ergebnis liegt bei positiven Angaben in der Vergangenheit liegt.- Returns:
- Anzahl Millisekunden seit 1970.
-
asAbsoluteTime
public long asAbsoluteTime()
Interpretiert den Wert des Arguments als absolute Zeitangabe. Das Argument muss aus einer Zeitangabe im Format HH:MM[:SS[,mmm]] und/oder aus einer Datumsangabe im Format TT.MM.[YY]YY bestehen. Die Reihenfolge von Datum und Zeit ist egal. Wenn nur eine Zeitangabe im Argument enthalten ist, wird als Datum der Tag benutzt, an dem das Programm gestartet wurde. Wenn nur eine Datumsangabe im Argument enthalten ist, dann wird als Zeitangabe 0:00 Uhr Lokalzeit benutzt. Bei Datumsangaben mit zweistelliger Jahreszahl wird ein Jahr gewählt, das im Bereich von 80 Jahren vor und 20 Jahren nach dem aktuellen Jahr liegt. Als spezieller Wert wird der Text "jetzt" erkannt und durch die beim Aufruf der Methode aktuelle Zeit interpretiert.- Returns:
- Anzahl Millisekunden seit 1970.
-
asRelativeTime
public long asRelativeTime()
Interpretiert den Wert des Arguments als relative Zeitangabe. Das Argument muss aus einer Liste von Zahlen und Einheiten bestehen. Als Einheiten sind "t" und "Tag[e]" für Tage, "h" und "Stunde[n]" für Stunden, "m" und "Minute[n]" für Minuten, "s" und "Sekunde[n]" für Sekunden sowie "ms" und "Millisekunden[e]" für Millisekunden erkannt. Die Einzelnen Werte werden in Millisekunden umgerechnet und aufsummiert. Als spezieller Wert wird der Text "jetzt" erkannt und als "0 Sekunden" interpretiert.- Returns:
- Relative Zeitangabe in Millisekunden.
-
asByteSize
public long asByteSize()
Interpretiert das Aufrufargument als eine Datenmenge, Beispielsweise würde "-test=10M" 10 Megabytes entsprechen.Diese Methode ist Fehlertolerant, folgende Werte sind gleichwertig: "10000k", "10000K", "10m", "10M", "10MB"
Diese Methode entspricht grob
asSiUnit("B"), unterscheidet sich aber in folgenden Punkten:- Es sind nur ganzzahlige Rückgabewerte erlaubt
- Groß- und Kleinschreibung wird ignoriert, d.h. m = Mega, nicht Milli
- Unterstützung für SI-konforme Binärpotenzen (z. B. 1KiB = 1024 bytes, 1KB = 1000 bytes)
- Returns:
- Anzahl Bytes
-
asSiUnit
public java.math.BigDecimal asSiUnit(java.lang.String siUnit)
Gibt den Wert dieses Arguments als Wert einer SI-Einheit zurück. Wird zum Beispiel ein Argument mitasSiUnit("m")angefragt, dann führen folgende Eingaben zu den entsprechenden Ergebnissen:"1m" → 1.0"1km" → 1000.0"1mm" → 0.001"1cm" → 0.01
"1" → 1.0"1m" → 1.0(!!!)"1mm" → 0.001"1k" → 1000.0"1c" → 0.01
asSiUnit("cm")angefragt, dann führen folgende Eingaben zu den entsprechenden Ergebnissen:"1m" → 100.0"1km" → 100000.0"1mm" → 0.1"1cm" → 1.0
- Parameters:
siUnit- Von Programm geforderte Einheit- Returns:
- Wert, der in die gewünschte Einheit umgerechnet wurde. Bietet dank
BigDecimalhier unbegrenzte Genauigkeit.
-
asDuration
public java.time.Duration asDuration()
Interpretiert den Wert des Arguments als Zeitdauer (KlasseDuration. Diese Methode liefert im Gegensatz zuasRelativeTime()eineDurationzurück und interpretiert allgemein mehr Formate. Beispielsweise werden folgende Werte unterstützt:12:55:12,23112:553 Tage 5 Minuten 2 Sekunden3 Tage, 12:55:12,231
Der Wert "jetzt" wird nicht unterstützt.
- Returns:
- Zeitdauer
-
asLocalDate
public java.time.LocalDate asLocalDate()
Gibt das angegebene Datum zurück, im Format dd.MM.yyyy.Das Jahr kann statt 4-stellig auch zweistellig angegeben werden, was aber nicht empfohlen wird, da Mehrdeutigkeiten entstehen können. Die verwendete Bibliothek interpretiert 87 bspw. als 2087, nicht als 1987.
- Returns:
- Datum
-
asLocalTime
public java.time.LocalTime asLocalTime()
Gibt die angegebene Zeit zurück, im Format HH:mm:ss,SSS. Die Millisekunden und Sekunden können optional weggelassen werden.- Returns:
- Zeit
-
asLocalDateTime
public java.time.LocalDateTime asLocalDateTime()
Ermittelt ein Datum alsLocalDateTime. Diese Klasse unterstützt folgende Formate:dd.MM.yyyy, HH:mm:ss,SSSdd.MM.yyyy, HH:mm:ssdd.MM.yyyy, HH:mmHH:mm:ss,SSS, dd.MM.yyyyHH:mm:ss, dd.MM.yyyyHH:mm, dd.MM.yyyy
Das Jahr kann statt 4-stellig auch zweistellig angegeben werden, was aber nicht empfohlen wird, da Mehrdeutigkeiten entstehen können. Die verwendete Bibliothek interpretiert 87 bspw. als 2087, nicht als 1987.
- Returns:
- Datum und Zeit
-
asInstant
public java.time.Instant asInstant()
Gibt die angegebene Datum+Uhrzeit alsInstantzurück (in der lokalen Standardzeitzone).- Returns:
- Angegebener Zeitpunkt
-
toString
public java.lang.String toString()
Erzeugt eine Zeichenkette, die den Namen und den Wert des Arguments enthält.- Overrides:
toStringin classjava.lang.Object- Returns:
- Zeichenkette mit Name und Wert des Arguments.
- Throws:
java.lang.IllegalStateException- Wenn das Argument keinen Wert hat.
-
-