Drucken      PDF-Version der Onlinehilfe öffnen


Vorheriges Thema

Nächstes Thema

Duration

Die Funktion Duration in Expression Builder gibt eine Zahl zurück, die eine Periode in Tagen oder Tagesabschnitten angibt, so wie vom Periodenargument angegeben.

Syntax

Duration(period)

ErgebnistypEs folgen einige

Anzahl

Argumente

In der folgenden Tabelle werden die Argumente für die Funktion beschrieben.

Argument

Beschreibung

period

Gibt die Periode an, die zurückgegeben werden soll. Der Wert kann ein Zeichenfolgenliteral im Format PnYnMnDTnHnM sein oder ein Ausdruck, der eine Zeichenfolge im Format PnYnMnDTnHnM ergibt.

Die Abkürzungen in der Zeichenfolge PnYnMnDTnHnM stehen für Folgendes:

  • P ist der Periodenindikator
  • nY gibt die Anzahl der Jahre an
  • nM gibt die Anzahl der Monate an
  • nD gibt die Anzahl der Tage an
  • T trennt die Datums- und Uhrzeitangaben
  • nH gibt die Anzahl der Stunden an
  • nM gibt die Anzahl der Minuten an

Angenommen, Sie möchten eine Periode von 50 Monaten angeben. Sie können die Periode als Zeichenfolgenliteral angeben, z.B. als P4Y2M oder als P50M. Wenn Sie alternativ eine Periode angeben möchten, die sich abhängig von einem Wert in einem Feld ändert, können Sie dieses Feld in einem Ausdruck im Argument verwenden.

Im folgenden Beispiel ist das Feld für die Abgrenzungsperiode ein benutzerdefiniertes Feld, das zum Speichern eines Wertes für eine Periode in Monaten eingerichtet wurde. Der Wert im Feld für die Abgrenzungsperiode wird zum Berechnen der Periode verwendet:

Duration('P'+ FieldValue([{nDeferral_Period}])+'M')

Wenn also der Wert im Feld für die Abgrenzungsperiode 12 ist, ergibt der Ausdruck P12M, eine gültige Zeichenfolge für das Argument. Wenn der Wert im Feld für die Abgrenzungsperiode 50 ist, ergibt der Ausdruck P50M, ebenfalls eine gültige Zeichenfolge.

Sie können im Zeichenfolgenliteral eine beliebige Anzahl von Jahren, Monaten, Tagen, Stunden oder Minuten angeben. Wenn das Argument einen Ausdruck enthält, gibt es für die Zahl, die vom Ausdruck zurückgegeben werden kann, auch keine Begrenzung.

Für das Periodenargument ist Folgendes zu beachten:

  • Kennzeichnen Sie positive Werte nicht mit einem Pluszeichen (+).
  • Negative Zeiträume können Sie mit -Duration(period) oder Duration(-period) angeben.
  • Die Angabe von Sekunden wird nicht unterstützt.
  • Ist die Anzahl der Jahre, Monate, Tage, Stunden oder Minuten gleich null, können Sie die Zahl und ihren Designator weglassen.
  • Wenn keine Zeitkomponente im Zeitraum vorhanden ist, muss der Designator T nicht angegeben werden.
  • Der Designator P muss immer im Zeitraum vorhanden sein.

Beispiele

Es folgen einige Beispiele für die Durationfunktion:

Duration('P0Y1M1DT2H5M')

Duration('P0Y0DT1H')

Duration('P1D')

Duration('P0Y0M0DT0H0M')

Duration('P0DT1M')

Duration('P24M')

Duration('P500D')

Duration('P'+ FieldValue([{nDeferral_Period}])+'M')

Duration('PT1000H3M')

Duration('-P1Y200M')

Verwandte Themen

Weitere zugehörige Informationen zu Expression Builder finden Sie unter folgenden Themen:


Veröffentlicht August 2018 Copyright © 2005, 2018, Oracle. Alle Rechte vorbehalten. Legal Notices.