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

ADD_TIME

Script-Funktion: Addiert zwei Zeiten.

Syntax

ADD_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 addieren 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 bestimmten Zeitformats ist dabei optional. Wird kein 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 Defaultformat "HHMMSS" zurück.

Beispiele

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

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

Das zweite Beispiel verwendet Zeitformat und Ausgabeformat. Das Ergebnis ist "04:59".

:SET &TIME# = ADD_TIME("235959", "HH;05", "HH:MM")
:PRINT &TIME#

Im dritten Beispiel werden zu 23:59:59 71 Sekunden addiert. Zeitformat wird verwendet, Ausgabeformat nicht. Das Ergebnis ("000110") entspricht dem Standardformat.

:SET &TIME# = ADD_TIME("HH:MM:SS;23:59:59", "SS;71")
:PRINT &TIME#

Gleiches Beispiel wie das Dritte. Aber im Unterschied dazu wird als Ausgabeformat ein Teilbegriff verwendet. Das Ergebnis ("70") wird in Sekunden im Aktivierungsprotokoll ausgegeben.

:SET &TIME# = ADD_TIME("HHMMSS;235959", "SS;71", 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