Automation Engine Script-Leitfaden > Funktionelle Gliederung > Datum und Zeit > DIFF_TIME

DIFF_TIME

Script-Funktion: Ermittelt die Differenz zwischen zwei Zeitangaben.

DIFF_TIME(Time1, Time2, [Output Format])

Syntax	Beschreibung/Format
Zeit1 und Zeit2	Angabe einer Zeit im Format „HHMMSS“. Format: Script-Literal oder Script-Variable Es ist möglich, ein anderes Zeitformat auszuwählen. Geben Sie dazu zuerst das gewünschte Zeitformat, ein Trennzeichen (;) und danach die Zeit an. Die Angabe des Zeitformats ist optional.
Ausgabeformat	Formatvorgabe für die ermittelte Zeit. Format: AE-Name, Script-Literal oder Script-Variable Standardwert: "HHMMSS"

Syntax

Beschreibung/Format

Zeit1
und
Zeit2

Angabe einer Zeit im Format „HHMMSS“.

Format: Script-Literal oder Script-Variable

Es ist möglich, ein anderes Zeitformat auszuwählen. Geben Sie dazu zuerst das gewünschte Zeitformat, ein Trennzeichen (;) und danach die Zeit an. Die Angabe des Zeitformats ist optional.

Ausgabeformat

Formatvorgabe für die ermittelte Zeit.
Format: AE-Name, Script-Literal oder Script-Variable
Standardwert: "HHMMSS"

Rückgabewert
Zeit im angegebenen Format

Anmerkungen

Die Script-Funktion ermittelt die Differenz zwischen Zeit1 und Zeit2. Es wird immer der Abstand von der jeweils kleineren zur größeren Zeit errechnet. Dabei ist unerheblich, ob die größere Zeit mit Zeit1 oder Zeit2 angegeben wurde.

Der Script-Funktion werden zwei Zeiten übergeben. Die eines Zeitformats ist dabei optional. Wird kein bestimmtes Zeitformat verwendet, muss die Zeit im Format "HHMMSS" angegeben werden. Als Trennzeichen zwischen Zeitformat und Zeit ist nur Semikolon erlaubt. Werden Teilbegriffe beim Zeitformat verwendet, wird mit der angegebenen Anzahl von Stunden, Minuten oder Sekunden gerechnet. Für die fehlenden Informationen wird jeweils "00" gesetzt.

Ausgabeformat ist optional. Wird Ausgabeformat nicht verwendet, liefert die Script-Funktion eine Zeit mit dem Standardformat "HHMMSS" zurück.

Beispiele

Das erste Beispiel ermittelt die Differenz zwischen den Zeitangaben. Die Zeiten verwenden das Standardformat "HHMMSS". Das Ergebnis "003000" wird im Report ausgegeben.

:SET &DIFF# = DIFF_TIME("230000", "223000")
:PRINT &DIFF#

In diesem Beispiel wird bei der zweiten Zeit ein Teilbegriff verwendet. Damit sind deren Stunden und Sekunden automatisch "00". Ein Ausgabeformat wird vorgegeben. Das Ergebnis "00:09" erscheint im Report.

:SET &DIFF# = DIFF_TIME("HH:MM:SS;00:01:30", "MM;11", "HH:MM")
:PRINT &DIFF#

Im dritten Beispiel werden die Zeiten den Script-Variablen zugewiesen. Die Script-Funktion wird mit diesen Script-Variablen aufgerufen. Da die Zeiten kein Standardformat verwenden, muss auch bei den Script-Variablen das spezielle Zeitformat angegeben werden. Das Ergebnis "120000" wird im Report ausgegeben.

:SET &TIME1# = "00:00:00"
:SET &TIME2# = "12:00:00"
:SET &DIFF# = DIFF_TIME("HH:MM:SS;&TIME1#", "HH:MM:SS;&TIME2#")
:PRINT &DIFF#

Siehe auch:

Script-Sprachmittel - Datum und Zeit

Datums-, Zeit- und Periodenformate

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support