GlideTime : Bereichsbezogen

Die GlideTime- API bietet Methoden zum Ausführen von Vorgängen für GlideTime-Objekte, z. B. das Instanziieren von GlideTime-Objekten oder das Arbeiten mit GlideTime-Feldern.

Anleitungen zu Datums-/Uhrzeiteingabezeichenfolgen mit einer Liste häufiger Formatkonflikte finden Sie unter Richtlinien für das Datums- und Uhrzeitformat.

GlideTime: GlideTime()

Instantiiert ein GlideTime-Objekt mit der aktuellen Uhrzeit.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

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

GlideTime: GlideTime (Anzahl Millisekunden)

Instanziiert ein GlideTime-Objekt mit seiner um Mitternacht (UTC) beginnenden Zeit plus dem übergebenen Wert.

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

Tabelle : 2. Parameter

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

Dieses Beispiel zeigt, wie bis Mitternacht (UTC) 10 Sekunden addiert werden. Anschließend wird der Wert an die Zeitzone angepasst, in der sich die Instanz befindet. In diesem Fall -8 Stunden ab UTC.

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

Ausgabe:

16:00:10

GlideTime – getByFormat(String-Format)

Gibt die Uhrzeit im angegebenen Format zurück.

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

Tabelle : 3. Parameter

Name	Typ	Beschreibung
format	Zeichenfolge	Zeichenfolge, die zum Formatieren der Uhrzeit verwendet wird. Wenn die aktuelle Uhrzeit beispielsweise 10:30:20 ist, dann: 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 = 30/10/20

Tabelle : 4. Rückgaben

Typ	Beschreibung
Zeichenfolge	Zeit im angegebenen Format.

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

Ausgabe:

12:00

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 : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. 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

GlideTime – getDisplayValueInternal()

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

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. 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

GlideTime – getHourLocalTime()

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

Tabelle : 9. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 10. Ergebnisse

Typ	Beschreibung
Zahl	Die Stunden in der lokalen Zeitzone.

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 : 11. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 12. Ergebnisse

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

GlideTime – getHourOfDayUTC()

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

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 24-Stunden-Angabe.

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 : 15. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 16. 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.

GlideTime – getMinutesLocalTime()

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

Tabelle : 17. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 18. Ergebnisse

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

GlideTime – getMinutesUTC()

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

Tabelle : 19. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 20. Ergebnisse

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

GlideTime – getSeconds()

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

Tabelle : 21. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 22. Ergebnisse

Typ	Beschreibung
Zahl	Die Anzahl der Sekunden in der Minute.

GlideTime – getValue()

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

Tabelle : 23. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 24. 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

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

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'));

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());