intervalValue()

Die Systemfunktion dateTimeLib.intervalValue() gibt einen INTERVAL-Wert von einer Quellenzeichenfolge zurück. EGL stellt diese Funktion für die Kompatibilität mit früheren Versionen zur Verfügung. Neuer Code kann die Zeichenfolge einfach der TIME-Variable zuordnen.

Die Funktion erwartet eine sechsstellige Eingabezeichenfolge. Die ersten vier Stellen geben die Anzahl der Jahre im Intervall an und die beiden letzten Stellen die Anzahl der Monate. Wenn Sie ein anderes Muster als "yyyyMM" angeben wollen, verwenden Sie dateTimeLib.intervalValueWithPattern().

Um einen Zeichenfolgewert in einen INTERVAL-Wert zu konvertieren, verwendet EGL die folgenden Methoden in einer bestimmten Reihenfolge:
  1. EGL versucht, den Text mithilfe der Maske "yyyyMM" in einen INTERVAL-Wert zu parsen. Wenn EGL den Text nicht auf diese Weise parsen kann, wird ein Versuch mit der nächsten Methode unternommen.
  2. EGL parst den Text in zwei Gruppen von Ziffern: vier Stellen für das Jahr und zwei Stellen für den Monat - als Trennzeichen zwischen den Ziffern werden Zeichen verwendet, die keine Ziffern sind:
    1. EGL ignoriert zuerst alle Zeichen am Textanfang, die keine Ziffern sind.
    2. EGL verwendet anschließend die folgenden Ziffern für das Jahresfeld des INTERVAL-Werts. EGL fügt keine weiteren Ziffern zu diesem Feld hinzu, wenn ein Zeichen im Text erreicht wird, das keine Ziffer ist, oder wenn ein vierstelliger Bereich erreicht wird.
    3. EGL überspringt alle folgenden Zeichen, die keine Ziffern sind.
    4. EGL wiederholt anschließend die Schritte b und c für jede der beiden Ziffern im Monatsfeld.
    5. Wenn alle Felder gefüllt wurden, werden alle übrigen Ziffern und alle anderen Zeichen im Text ignoriert.
    Wenn dieser Prozess nicht mindestens eine Ziffer für jedes Feld im Muster hervorbringt, schlägt der Prozess fehl und löst eine Typumwandlungs-Ausnahmebedingung (TypeCastException) aus.

    Beispiele für diesen Parsing-Prozess finden Sie in dateValue().

Syntax

  dateTimeLib.intervalValue(Intervallzeichenfolge STRING? in)
  returns (Ergebnis INTERVAL?)
Intervallzeichenfolge
Eine Zeichenfolge, die sechs Ziffern enthält, deren Bedeutung durch das Intervallmuster "yyyyMM" interpretiert wird.
Ergebnis
Eine INTERVAL-Variable. Wenn die Intervallzeichenfolge null ist, gibt die Funktion einen Nullwert zurück.

Kompatibilität

Tabelle 1. Überlegungen zur Kompatibilität für intervalValue
Plattform Problem
Rich-UI INTERVAL-Werte werden nicht unterstützt.

Feedback