Class ArgumentList.Argument

  • Enclosing class:
    ArgumentList

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

      All Methods Instance Methods Concrete Methods 
      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 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; 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.
      • 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.