GlideTime – Scoped

Die bereichsbezogene GlideTime-Klasse stellt Methoden zum Ausführen von Operationen an GlideTime-Objekten bereit, z. B. zum Instantiieren von GlideTime-Objekten oder zum Arbeiten mit GlideTime-Feldern.

Anleitungen zu Datums-/Uhrzeit-Eingabezeichenfolgen mit einer Liste gängiger Formatkonflikte finden Sie unter Richtlinien für Datums- und Zeitformat.

Scoped GlideTime – getByFormat(String format)

Gibt die Uhrzeit im angegebenen Format zurück.

Weitere Informationen zu den Zeitformaten, die Sie an diese Methode übergeben können, finden Sie unter Globales Format für Datums- und Zeitfelder. Sie können diese Werte in beliebiger Reihenfolge übergeben und Trennzeichen wie Bindestrich, Leerzeichen, umgekehrten Schrägstrich oder Doppelpunkt hinzufügen. Darüber hinaus können Sie auch das Zeichen „a“ übergeben, um am/pm zurückzugeben.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
format	Zeichenfolge	Zeichenfolge zum Formatieren der Zeit. Wenn die aktuelle Uhrzeit beispielsweise 10:30:20 ist, gilt Folgendes: hh:mm:ss = 10:30:20 HH = 10 HH – ss = 10 – 20 hh a = 10 Uhr s:m:H ss:mm:hh = 20:30:10 20:30:10 HH:mm:ss.SSSZ = 10:30:20.000+0000 HH/MM/SS = 30.10.20

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Uhrzeit im angegebenen Format.

var gt = new GlideTime(); 
gt.setValue('12:00:00');
gs.info(gt.getByFormat("HH:mm"));

Ausgabe:

12:00

Scoped GlideTime – getDisplayValue()

Ruft die Uhrzeit im Anzeigeformat und in der Zeitzone des aktuellen Benutzers ab.

Beachten Sie beim Entwerfen von Business Rules oder Skript-Inhalten, dass diese Methode Werte in verschiedenen Formaten für verschiedene Benutzer zurückgeben kann.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Die Uhrzeit im Format und in der Zeitzone des Benutzers.

var gt = new GlideTime();
gt.setDisplayValue("12:00:00"); // User Time Zone
gs.info(gt.getDisplayValue()); // User Time Zone

Scoped GlideTime – getDisplayValueInternal()

Ruft den Anzeigewert in der Zeitzone des aktuellen Benutzers und das interne Format (HH:mm:ss) ab.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Der Zeitwert für das GlideTime-Objekt in der Zeitzone des aktuellen Benutzers und dem internen Zeitformat HH:mm:ss.

var gt = new GlideTime();
gt.setValue("01:00:00"); //Internal Time Zone , UTC
gs.info(gt.getDisplayValueInternal()); //User Time Zone

Scoped GlideTime – getHourLocalTime()

Gibt den Stundenteil der Zeit unter Verwendung der lokalen Zeitzone zurück.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. Ergebnisse

Typ	Beschreibung
Zahl	Die Stunden in der lokalen Zeitzone.

Scoped GlideTime – getHourOfDayLocalTime()

Gibt den Stundenteil der Zeit unter Verwendung der lokalen Zeitzone zurück. Die Anzahl der Stunden basiert auf der 24-Stunden-Angabe.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 10. Ergebnisse

Typ	Beschreibung
Zahl	Die Stunden in der lokalen Zeitzone. Die Anzahl der Stunden basiert auf der 24-Stunden-Angabe.

Scoped GlideTime – getHourOfDayUTC()

Gibt den Stundenteil der Uhrzeit in der UTC-Zeitzone zurück. Die Anzahl der Stunden basiert auf der 24-Stunden-Angabe.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 12. Ergebnisse

Typ	Beschreibung
Zahl	Die Stunden in der UTC-Zeitzone. Die Anzahl der Stunden basiert auf der 24-Stunden-Angabe.

Scoped GlideTime – getHourUTC()

Gibt den Stundenteil der Uhrzeit in der UTC-Zeitzone zurück. Die Anzahl der Stunden basiert auf der 12-Stunden-Angabe. Mittag und Mitternacht werden durch 0 und nicht durch 12 dargestellt.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 14. Ergebnisse

Typ	Beschreibung
Zahl	Die Stunden in der UTC-Zeitzone. Die Anzahl der Stunden basiert auf der 12-Stunden-Angabe. Mittag und Mitternacht werden durch 0 und nicht durch 12 dargestellt.

Scoped GlideTime – getMinutesLocalTime()

Gibt die Anzahl der Minuten in der lokalen Zeitzone zurück.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 16. Ergebnisse

Typ	Beschreibung
Zahl	Die Anzahl der Minuten in der lokalen Zeitzone.

Scoped GlideTime – getMinutesUTC()

Gibt die Anzahl der Minuten in der Stunde basierend auf der UTC-Zeitzone zurück.

Tabelle : 17. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 18. Ergebnisse

Typ	Beschreibung
Zahl	Die Anzahl der Minuten in der Stunde in der UTC-Zeitzone.

Scoped GlideTime – getSeconds()

Gibt die Anzahl der Sekunden in der aktuellen Minute zurück.

Tabelle : 19. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 20. Ergebnisse

Typ	Beschreibung
Zahl	Die Anzahl der Sekunden in der Minute.

Scoped GlideTime – getValue()

Ruft den in der Datenbank gespeicherten Zeitwert vom GlideTime-Objekt im internen Format (HH:mm:ss) und der Systemzeitzone ab.

Tabelle : 21. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 22. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Der Zeitwert im internen Format und in der Systemzeitzone.

var gt = new GlideTime();
gs.info(gt.getValue()); // Internal Time Zone, UTC

Scoped GlideTime – GlideTime()

Instantiiert ein GlideTime-Objekt mit der aktuellen Uhrzeit.

Tabelle : 23. Parameter

Name	Typ	Beschreibung
Keine

var gt = new GlideTime(); 
gs.info(gt.getDisplayValue());

Scoped GlideTime – GlideTime(Number milliseconds)

Instanziiert ein GlideTime-Objekt mit seiner Zeit, die um Mitternacht UTC beginnt, plus dem übergebenen Wert.

Der Wert wird an die Zeitzone angepasst, in der sich die Instanz befindet. Wenn sich die Instanz des Benutzers beispielsweise in einer Zeitzone befindet, die -8 Stunden von der UTC entfernt ist, und 1000 übergeben wird, lautet die Zeit im GlideTime-Objekt 16:00:10 (00:00:00 - 8 Stunden +10 Sekunden.)

Tabelle : 24. Parameter

Name	Typ	Beschreibung
milliseconds	Nummer	Zeit zum Hinzufügen zu Mitternacht UTC. Einheit: Millisekunden

Dieses Beispiel zeigt das Hinzufügen von 10 Sekunden zu Mitternacht (UTC), was dann an die Zeitzone angepasst wird, in der sich die Instanz befindet. In diesem Fall -8 Stunden nach UTC.

var gt = new GlideTime(10000); 
gs.info(gt.getDisplayValue());

Ausgabe

16:00:10

Scoped GlideTime – setDisplayValue(String asDisplayed)

Legt einen Zeitwert unter Verwendung des Anzeigeformats und der Zeitzone des aktuellen Benutzers fest.

Tabelle : 25. Parameter

Name	Typ	Beschreibung
asDisplayed	Zeichenfolge	Die Uhrzeit im Anzeigeformat und in der Zeitzone des aktuellen Benutzers. Der Parameter muss mit dem bevorzugten Anzeigeformat des aktuellen Benutzers formatiert werden, z. B. HH:mm:ss.

Tabelle : 26. Ergebnisse

Typ	Beschreibung
Keine

var gt = new GlideTime();
gt.setDisplayValue('01:00:00');   // User Time Zone
gs.info(gt.getDisplayValueInternal()); // User Time Zone

Scoped GlideTime – setValue(String o)

Legt die Zeit des GlideTime-Objekts in der internen Zeitzone fest.

Tabelle : 27. Parameter

Name	Typ	Beschreibung
o	Zeichenfolge	Die Uhrzeit im Format hh:mm:ss.

Tabelle : 28. Ergebnisse

Typ	Beschreibung
Keine

var gt = new GlideTime();
gt.setValue('01:00:00');  //Internal Time Zone, UTC
gs.info("time is "+ gt.getByFormat('hh:mm:ss'));

Scoped GlideTime – subtract(GlideTime startTime, GlideTime endTime)

Ruft die Laufzeitdifferenz zwischen zwei GlideTime-Objektwerten ab.

Tabelle : 29. Parameter

Name	Typ	Beschreibung
startTime	GlideTime	Der Startwert.
endTime	GlideTime	Der Endwert.

Tabelle : 30. Ergebnisse

Typ	Beschreibung
GlideDuration	Die Dauer zwischen den beiden Werten.

var gd1 = new GlideTime(); 
gd1.setDisplayValue("09:00:00"); 
var gd2 = new GlideTime(); 
gd2.setDisplayValue("09:10:00"); 
 
var dur = GlideDate.subtract(gd1, gd2); //the difference between gdt1 and gdt2 
gs.info(dur.getDisplayValue());