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

SUB_TIME

Script-Funktion: Subtrahiert zwei Zeiten.

Syntax

SUB_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

Mit der Script-Funktion subtrahieren Sie zwei Zeiten. Dabei wird der Wechsel von 00:00:00 auf 23:59:59 berücksichtigt.

Der Script-Funktion werden zwei Zeiten übergeben. Die Angabe 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.

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

Beispiele

Das erste Beispiel verwendet keine Zeitformate. Das Ergebnis ("110000") wird im Aktivierungsprotokoll ausgegeben.

:SET &TIME# = SUB_TIME("120000","010000")
:PRINT &TIME#

Das zweite Beispiel verwendet Zeitformat und Ausgabeformat. Das Ergebnis ist "23:00".

:SET &TIME# = SUB_TIME("040000", "HH;05", "HH:MM")
:PRINT &TIME#

Im dritten Beispiel werden von 00:00:10 31 Sekunden subtrahiert. Zeitformat wird verwendet, Ausgabeformat nicht. Das Ergebnis ("235940") entspricht dem Standardformat.

:SET &TIME# = SUB_TIME("HH:MM:SS;00:00:10", "SS;30")
:PRINT &TIME#

Gleiches Beispiel wie das dritte. Aber im Unterschied dazu wird als Ausgabeformat ein Teilbegriff verwendet. Das Ergebnis ("86380") entsteht durch Umrechnung von 23:59:40 in Sekunden.

:SET &TIME# = SUB_TIME("HHMMSS;000010", "SS;30", SS)
:PRINT &TIME#

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