Class ArgumentList.Argument

java.lang.Object
de.bsvrz.sys.funclib.commandLineArgs.ArgumentList.Argument
Enclosing class:
ArgumentList

public static class ArgumentList.Argument
extends java.lang.Object
Klasse zum Zugriff auf Name und Wert eines Aufrufarguments.
  • Field Summary

    Fields
    Modifier and Type Field Description
    static java.util.regex.Pattern BYTE_DELIM_PATTERN  
    static java.util.regex.Pattern BYTE_UNIT_PATTERN  
    static java.util.regex.Pattern DURATION_PATTERN  
    static java.util.regex.Pattern DURATION_PATTERN_2  
  • Method Summary

    Modifier and Type Method Description
    long asAbsoluteTime()
    Interpretiert den Wert des Arguments als absolute Zeitangabe.
    long asByteSize()
    Interpretiert das Aufrufargument als eine Datenmenge, Beispielsweise würde "-test=10M" 10 Megabytes entsprechen.
    java.io.File asChangeableFile()
    Gibt den Wert des Arguments als Datei-Identifikation einer änderbaren Datei zurück.
    java.io.File asChangeableFile​(boolean createIfNotExistent)
    Gibt den Wert des Arguments als Datei-Identifikation einer änderbaren Datei zurück.
    java.io.File asDirectory()
    Gibt den Wert des Arguments als Datei-Identifikation eines Dateiverzeichnisses zurück.
    java.time.Duration asDuration()
    Interpretiert den Wert des Arguments als Zeitdauer (Klasse Duration.
    <E> E asEnum​(java.lang.Class<E> typeClass)
    Bestimmt den Wert des Arguments als Enum-Konstante.
    java.io.File asExistingFile()
    Gibt den Wert des Arguments als Datei-Identifikation einer existierenden Datei zurück.
    java.io.File asFile()
    Gibt den Wert des Arguments als Datei-Identifikation zurück.
    java.time.Instant asInstant()
    Gibt die angegebene Datum+Uhrzeit als Instant zurück (in der lokalen Standardzeitzone).
    java.time.LocalDate asLocalDate()
    Gibt das angegebene Datum zurück, im Format dd.MM.yyyy.
    java.time.LocalDateTime asLocalDateTime()
    Ermittelt ein Datum als LocalDateTime.
    java.time.LocalTime asLocalTime()
    Gibt die angegebene Zeit zurück, im Format HH:mm:ss,SSS.
    java.lang.String asNonEmptyString()
    Bestimmt den Wert des Arguments als nicht leere Zeichenkette.
    java.nio.file.Path asPath()
    Gibt den Wert des Arguments als Datei-Identifikation zurück.
    java.io.File asReadableFile()
    Gibt den Wert des Arguments als Datei-Identifikation einer lesbaren Datei zurück.
    long asRelativeTime()
    Interpretiert den Wert des Arguments als relative Zeitangabe.
    java.math.BigDecimal asSiUnit​(java.lang.String siUnit)
    Gibt den Wert dieses Arguments als Wert einer SI-Einheit zurück.
    java.lang.String asString()
    Bestimmt den Wert des Arguments als Zeichenkette.
    long asTime()
    Interpretiert den Wert des Arguments als Zeitangabe.
    ArgumentList.ValueCase asValueCase​(ArgumentList.ValueSelection validValues)  
    java.io.File asWritableFile()
    Gibt den Wert des Arguments als Datei-Identifikation einer beschreibaren Datei zurück.
    java.io.File asWritableFile​(boolean createIfNotExistent)
    Gibt den Wert des Arguments als Datei-Identifikation einer beschreibaren Datei zurück.
    boolean booleanValue()
    Gibt den Wert des Arguments als boolean Wert zurück.
    byte byteValue()
    Gibt den Wert des Arguments als byte Wert zurück.
    byte byteValueBetween​(byte minimum, byte maximum)
    Gibt den Wert des Arguments als byte Wert zurück.
    double doubleValue()
    Gibt den Wert des Arguments als double Wert zurück.
    double doubleValueBetween​(double minimum, double maximum)
    Gibt den Wert des Arguments als double Wert zurück.
    float floatValue()
    Gibt den Wert des Arguments als float Wert zurück.
    float floatValueBetween​(float minimum, float maximum)
    Gibt den Wert des Arguments als float Wert zurück.
    java.lang.String getName()
    Bestimmt den Namen des Arguments.
    java.lang.String getValue()
    Bestimmt den Wert des Arguments.
    boolean hasValue()
    Überprüft, ob das Argument einen Wert hat.
    int intValue()
    Gibt den Wert des Arguments als int Wert zurück.
    int intValueBetween​(int minimum, int maximum)
    Gibt den Wert des Arguments als int Wert zurück.
    long longValue()
    Gibt den Wert des Arguments als long Wert zurück.
    long longValueBetween​(long minimum, long maximum)
    Gibt den Wert des Arguments als long Wert zurück.
    short shortValue()
    Gibt den Wert des Arguments als short Wert zurück.
    short shortValueBetween​(short minimum, short maximum)
    Gibt den Wert des Arguments als short Wert zurück.
    ArgumentList.Argument toArgumentWithNameAsValue()
    Erzeugt ein neues Argument dessen Wert aus dem Namen dieses Arguments übernommen wird.
    java.lang.String toString()
    Erzeugt eine Zeichenkette, die den Namen und den Wert des Arguments enthält.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Field Details

    • 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 Details

    • 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; sonst false.
    • 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.IllegalArgumentException
      Gibt den Wert des Arguments als boolean Wert zurück. Die Argumentwerte "wahr", "ja", "1" werden zum Boolschen Wert true konvertiert; die Argumentwerte "falsch", "nein", "0" werden zum Boolschen Wert false konvertiert. Die Groß-/Kleinschreibung des Argumentwerts hat beim Vergleich keine Relevanz. Wenn das Argument keinen Wert hat, dann wird als Ergebnis der Konvertierung true zurückgegeben.
      Returns:
      Der konvertierte Argumentwert.
      Throws:
      java.lang.IllegalArgumentException - Wenn der Argumentwert nicht konvertiert werden konnte.
    • byteValue

      public byte byteValue() throws java.lang.NumberFormatException
      Gibt den Wert des Arguments als byte Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ byte konvertiert.
      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.NumberFormatException
      Gibt den Wert des Arguments als short Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ short konvertiert.
      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.NumberFormatException
      Gibt den Wert des Arguments als int Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ int konvertiert.
      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.NumberFormatException
      Gibt den Wert des Arguments als long Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ long konvertiert.
      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.NumberFormatException
      Gibt den Wert des Arguments als float Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ float konvertiert.
      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.NumberFormatException
      Gibt den Wert des Arguments als double Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ double konvertiert.
      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.NumberFormatException
      Gibt den Wert des Arguments als byte Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ byte konvertiert 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.NumberFormatException
      Gibt den Wert des Arguments als short Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ short konvertiert 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.NumberFormatException
      Gibt den Wert des Arguments als int Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ int konvertiert 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.NumberFormatException
      Gibt den Wert des Arguments als long Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ long konvertiert 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.NumberFormatException
      Gibt den Wert des Arguments als float Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ float konvertiert 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.NumberFormatException
      Gibt den Wert des Arguments als double Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ double konvertiert 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.IOException
      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.
      Parameters:
      createIfNotExistent - Wenn die spezifizierte Datei nicht existiert und dieser Parameter den Wert true hat, 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.IOException
      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.
      Parameters:
      createIfNotExistent - Wenn die spezifizierte Datei nicht existiert und dieser Parameter den Wert true hat, 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 Methode asAbsoluteTime() 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 mit asSiUnit("m") angefragt, dann führen folgende Eingaben zu den entsprechenden Ergebnissen:
      • "1m" → 1.0
      • "1km" → 1000.0
      • "1mm" → 0.001
      • "1cm" → 0.01
      Die Basis-Einheit kann vom Benutzer weggelassen werden, sofern dadurch keine Unklarheit entsteht:
      • "1" → 1.0
      • "1m" → 1.0 (!!!)
      • "1mm" → 0.001
      • "1k" → 1000.0
      • "1c" → 0.01
      Der Programmierer kann den Wert auch in einer bereits skalierten Einheit abfragen. Wird zum Beispiel ein Argument mit asSiUnit ("cm") angefragt, dann führen folgende Eingaben zu den entsprechenden Ergebnissen:
      • "1m" → 100.0
      • "1km" → 100000.0
      • "1mm" → 0.1
      • "1cm" → 1.0
      Groß-und Kleinschreibung der Einheiten ist in beiden Fällen wesentlich (Beispiel: m = Milli, M = Mega)
      Parameters:
      siUnit - Von Programm geforderte Einheit
      Returns:
      Wert, der in die gewünschte Einheit umgerechnet wurde. Bietet dank BigDecimal hier unbegrenzte Genauigkeit.
    • asDuration

      public java.time.Duration asDuration()
      Interpretiert den Wert des Arguments als Zeitdauer (Klasse Duration. Diese Methode liefert im Gegensatz zu asRelativeTime() eine Duration zurück und interpretiert allgemein mehr Formate. Beispielsweise werden folgende Werte unterstützt:
      • 12:55:12,231
      • 12:55
      • 3 Tage 5 Minuten 2 Sekunden
      • 3 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 als LocalDateTime. Diese Klasse unterstützt folgende Formate:
      • dd.MM.yyyy, HH:mm:ss,SSS
      • dd.MM.yyyy, HH:mm:ss
      • dd.MM.yyyy, HH:mm
      • HH:mm:ss,SSS, dd.MM.yyyy
      • HH:mm:ss, dd.MM.yyyy
      • HH:mm, dd.MM.yyyy

      Das Komma zwischen Datum und Zeit ist dabei optional, das Leerzeichen ist aber erforderlich.

      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 als Instant zurü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:
      toString in class java.lang.Object
      Returns:
      Zeichenkette mit Name und Wert des Arguments.
      Throws:
      java.lang.IllegalStateException - Wenn das Argument keinen Wert hat.