GlideTime – Umfang

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 8 Minuten Lesedauer

    • Die GlideTime Die API bietet Methoden zum Ausführen von Vorgängen an GlideTime-Objekten, z. B. Instanziierung von GlideTime-Objekten oder Arbeiten mit GlideTime-Feldern.

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

    GlideTime: GlideTime()

    Instanziiert ein GlideTime-Objekt mit der aktuellen Zeit.

    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 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 Anwenders beispielsweise in einer Zeitzone befindet, die -8 Stunden von UTC entfernt ist und 1000 übergeben wird, ist die Zeit im GlideTime-Objekt 16:00:10 (00:00:00 – 8 Stunden + 10 Sekunden).

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Millisekunden Nummer Zeit zum Hinzufügen zu Mitternacht UTC.

    Einheit: Millisekunden

    Dieses Beispiel zeigt das Hinzufügen von 10 Sekunden zu Mitternacht (UTC), die dann an die Zeitzone angepasst wird, 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 (Zeichenfolgenformat)

    Gibt die Zeit im angegebenen Format zurück.

    Informationen zu den Zeitformaten, die Sie an diese Methode übergeben können, finden Sie unter Globales Datums- und Uhrzeitfeldformat . Sie können diese Werte in beliebiger Reihenfolge übergeben und Trennzeichen wie Bindestrich, Leerzeichen, umgekehrter Schrägstrich oder Doppelpunkt 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 Zeit verwendet werden soll.
    Wenn die aktuelle Zeit 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 = 10/30/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 Zeit im Anzeigeformat und in der Zeitzone des aktuellen Anwenders ab.

    Denken Sie beim Entwerfen von Business-Regeln oder Skripteinbindungen daran, dass diese Methode Werte in verschiedenen Formaten für verschiedene Anwender zurückgeben kann.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Zeichenfolge Die Zeit im Format und in der Zeitzone des Anwenders. 
    var gt = new GlideTime();
gt.setDisplayValue("12:00:00"); // User Time Zone
gs.info(gt.getDisplayValue()); // User Time Zone

    GlideTime – getDisplayValueEx (Zeichenfolgenstil)

    Gibt die Zeit mithilfe der Zeitzone des aktuellen Anwenders und eines angegebenen Formats zurück.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Stil Zeichenfolge Für die Zeit zu verwendendes Format.
    Gültige Werte (Groß-/Kleinschreibung wird nicht beachtet):
    • Kurz : HH:MM (AM/PM)
    • Mittel : HH:mm:ss (AM/PM)
    • Lang : HH:mm:ss (AM/PM) Zeitzonenabkürzung
    • Voll : Zeitzone HH:mm:ss (AM/PM)

    Die Zeit wird in der Sprache des aktuellen Anwenders zurückgegeben. Die Sprache bestimmt, ob die Zeit im 12-Stunden- oder 24-Stunden-Format zurückgegeben wird.
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    Zeichenfolge Die Zeit im angegebenen Format.

    Dieses Beispiel gibt die Zeit anhand der Zeitzone des aktuellen Anwenders und jeder Formatierungsoption zurück.

    var gt = new GlideTime();
gs.info(gt.getDisplayValueEx("short"));
gs.info(gt.getDisplayValueEx("medium"));
gs.info(gt.getDisplayValueEx("long"));
gs.info(gt.getDisplayValueEx("full"));

    Ausgabe:

    8:52 AM  //short
8:52:24 AM  //medium
8:52:24 AM PST  //long
8:52:24 AM Pacific Standard Time  //full

    GlideTime – getDisplayValueInternal()

    Ruft den Anzeigewert in der Zeitzone des aktuellen Anwenders und im internen Format (HH:mm:ss) ab.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    Zeichenfolge Der Zeitwert für das GlideTime-Objekt in der Zeitzone des aktuellen Anwenders und das interne 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 – getDisplayValueLang (Zeichenfolgenstil, Zeichenfolgensprache)

    Gibt die Zeit anhand der Zeitzone des aktuellen Anwenders und eines angegebenen Formats und einer angegebenen Sprache zurück.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Stil Zeichenfolge Für die Zeit zu verwendendes Format.
    Gültige Werte (Groß-/Kleinschreibung wird nicht beachtet):
    • Kurz : HH:MM (AM/PM)
    • Mittel : HH:mm:ss (AM/PM)
    • Lang : HH:mm:ss (AM/PM) Zeitzonenabkürzung
    • Voll : Zeitzone HH:mm:ss (AM/PM)
    language Zeichenfolge Optional. Sprache, in der die Zeit zurückgegeben werden soll, bereitgestellt als BCP 47-Sprach-Tag. Um beispielsweise die Zeit auf Japanisch zurückzugeben, verwenden Sie das Tag Ja .

    Die Sprache bestimmt, ob die Zeit im 12-Stunden- oder 24-Stunden-Format zurückgegeben wird. Beispielsweise verwenden Zeiten auf Englisch das 12-Stunden-Format, während Zeiten auf Japanisch das 24-Stunden-Format verwenden.

    Standard: Sprache des aktuellen Anwenders.
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    Zeichenfolge Die Zeit im angegebenen Format und in der angegebenen Sprache.

    Dieses Beispiel gibt die Zeit in Spanisch anhand der Zeitzone des aktuellen Anwenders und jeder Formatierungsoption zurück.

    var gt = new GlideTime();
gs.info(gt.getDisplayValueLang("short", "es"));
gs.info(gt.getDisplayValueLang("medium", "es"));
gs.info(gt.getDisplayValueLang("long", "es"));
gs.info(gt.getDisplayValueLang("full", "es"));

    Ausgabe:

    9:25  //short
9:25:44  //medium
9:25:44 PST  //long
9:25:44 (hora estándar del Pacífico)  //full

    GlideTime – getHourLocalTime()

    Gibt den Stundenanteil der Zeit mithilfe der lokalen Zeitzone zurück.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    Nummer Die Stunden unter Verwendung der lokalen Zeitzone.

    GlideTime – getHourOfDayLocalTime()

    Gibt den Stundenanteil der Zeit mithilfe der lokalen Zeitzone zurück. Die Anzahl der Stunden basiert auf einer 24-Stunden-Uhr.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. Rückgaben
    Typ Beschreibung
    Nummer Die Stunden unter Verwendung der lokalen Zeitzone. Die Anzahl der Stunden basiert auf einer 24-Stunden-Uhr.

    GlideTime – getHourOfDay UTC()

    Gibt den Stundenanteil der Zeit mithilfe der UTC-Zeitzone zurück. Die Anzahl der Stunden basiert auf einer 24-Stunden-Uhr.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. Rückgaben
    Typ Beschreibung
    Nummer Die Stunden, die die UTC-Zeitzone verwenden. Die Anzahl der Stunden basiert auf einer 24-Stunden-Uhr.

    GlideTime – getHourUTC()

    Gibt den Stundenanteil der Zeit mithilfe der UTC-Zeitzone zurück. Die Anzahl der Stunden basiert auf einer 12-Stunden-Uhr. Mittag und Mitternacht werden durch 0 und nicht durch 12 dargestellt.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 20. Rückgaben
    Typ Beschreibung
    Nummer Die Stunden, die die UTC-Zeitzone verwenden. Die Anzahl der Stunden basiert auf einer 12-Stunden-Uhr. Mittag und Mitternacht werden durch 0 und nicht durch 12 dargestellt.

    GlideTime – getMinutesLocalTime()

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

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 22. Rückgaben
    Typ Beschreibung
    Nummer Die Anzahl der Minuten unter Verwendung der lokalen Zeitzone.

    GlideTime – getMinutesUTC()

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

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 24. Rückgaben
    Typ Beschreibung
    Nummer Die Anzahl der Minuten in der Stunde unter Verwendung der UTC-Zeitzone.

    GlideTime – getSeconds()

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

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 26. Rückgaben
    Typ Beschreibung
    Nummer Die Anzahl der Sekunden in der Minute.

    GlideTime – getValue()

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

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 28. Rückgaben
    Typ Beschreibung
    Zeichenfolge Der Zeitwert in der internen Fomat und Systemzeitzone. 
    var gt = new GlideTime();
gs.info(gt.getValue()); // Internal Time Zone, UTC

    GlideTime – setDisplayValue(Zeichenfolge asDisplayed)

    Legt einen Zeitwert mithilfe des Anzeigeformats und der Zeitzone des aktuellen Anwenders fest.

    Tabelle : 29. Parameter
    Name Typ Beschreibung
    AsDisplays Zeichenfolge Die Zeit im Anzeigeformat und in der Zeitzone des aktuellen Anwenders. Der Parameter muss mit dem bevorzugten Anzeigeformat des aktuellen Anwenders formatiert werden, z. B. HH:mm:ss.
    Tabelle : 30. Rückgaben
    Typ Beschreibung
    Keine 
    var gt = new GlideTime();
gt.setDisplayValue('01:00:00');   // User Time Zone
gs.info(gt.getDisplayValueInternal()); // User Time Zone

    GlideTime – setDisplayValueEx(Zeichenfolgenzeit, Zeichenfolgenstil)

    Legt die Zeit anhand der Zeitzone des aktuellen Anwenders und eines angegebenen Formats fest.

    Tabelle : 31. Parameter
    Name Typ Beschreibung
    Zeitreihendiagramm Zeichenfolge Wert, der für die Zeit festgelegt werden soll.
    Die GetDisplayValueEx() Die Methode gibt Zeiten in einem gültigen Format zurück, oder Zeiten können wie unten gezeigt formatiert werden.
    • HH:MM (AM/PM)
    • HH:mm:ss (AM/PM)
    • HH:mm:ss (AM/PM) Zeitzonenabkürzung
    • Zeitzone HH:mm:ss (AM/PM)
    Die Sprache des aktuellen Anwenders bestimmt, ob 12-Stunden-Zeitwerte (AM/PM) oder 24-Stunden-Zeitwerte akzeptiert werden. Beispiel: Wenn die Sprache des aktuellen Anwenders Englisch ist 18:25 UHR PST Ist ein gültiger Wert während 18:25 UHR (PST Ist nicht.
    Stil Zeichenfolge Für die Zeit zu verwendendes Format.

    Sie müssen dasselbe Format wie angegeben verwenden timeWert.

    Gültige Werte (Groß-/Kleinschreibung wird nicht beachtet):
    • Kurz : HH:MM (AM/PM)
    • Mittel : HH:mm:ss (AM/PM)
    • Lang : HH:mm:ss (AM/PM) Zeitzonenabkürzung
    • Voll : Zeitzone HH:mm:ss (AM/PM)
    Tabelle : 32. Rückgaben
    Typ Beschreibung
    Keine

    Dieses Beispiel legt die Zeit anhand der Zeitzone des aktuellen Anwenders und eines angegebenen Formats fest.

    gt = new GlideTime();
gt.setDisplayValueEx("8:25:25 AM", "medium");
gs.info(gt.getDisplayValueEx("full"));

    Ausgabe:

    8:25:25 AM Pacific Standard Time

    GlideTime – setDisplayValueLang (Zeichenfolgenzeit, Zeichenfolgenstil, Zeichenfolgensprache)

    Legt die Zeit anhand der Zeitzone des aktuellen Anwenders und eines angegebenen Formats und einer angegebenen Sprache fest.

    Tabelle : 33. Parameter
    Name Typ Beschreibung
    Zeitreihendiagramm Zeichenfolge Wert, der für die Zeit festgelegt werden soll.
    Die GetDisplayValueLang() Und GetDisplayValueEx() Methoden geben Zeiten in einem gültigen Format zurück, oder Zeiten können wie unten gezeigt formatiert werden.
    • HH:MM (AM/PM)
    • HH:mm:ss (AM/PM)
    • HH:mm:ss (AM/PM) Zeitzonenabkürzung
    • Zeitzone HH:mm:ss (AM/PM)
    Die languageParameter bestimmt, ob 12-Stunden-Zeitwerte (AM/PM) oder 24-Stunden-Zeitwerte akzeptiert werden. Beispiel: Wenn die Sprache lautet en (Englisch), 18:25 UHR PST Ist ein gültiger Wert während 18:25 UHR (PST Ist nicht.
    Stil Zeichenfolge Für die Zeit zu verwendendes Format.

    Sie müssen dasselbe Format wie angegeben verwenden timeWert.

    Gültige Werte (Groß-/Kleinschreibung wird nicht beachtet):
    • Kurz : HH:MM (AM/PM)
    • Mittel : HH:mm:ss (AM/PM)
    • Lang : HH:mm:ss (AM/PM) Zeitzonenabkürzung
    • Voll : Zeitzone HH:mm:ss (AM/PM)
    language Zeichenfolge Sprache zum Festlegen der Zeit, bereitgestellt als BCP 47-Sprach-Tag. Um beispielsweise die Zeit auf Japanisch festzulegen, verwenden Sie das Tag Ja .
    Tabelle : 34. Rückgaben
    Typ Beschreibung
    Keine

    Dieses Beispiel legt die Zeit in Englisch anhand der Zeitzone des aktuellen Anwenders fest und ruft sie auf Spanisch ab.

    gt = new GlideTime();
gt.setDisplayValueLang("4:15:00 PM PST", "long", "en");
gs.info(gt.getDisplayValueLang("full", "es"));

    Ausgabe:

    16:15:00 (hora estándar del Pacífico)

    GlideTime – setValue(Zeichenfolge o)

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

    Tabelle : 35. Parameter
    Name Typ Beschreibung
    o Zeichenfolge Die Zeit im Format hh:mm:ss.
    Tabelle : 36. Rückgaben
    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 – subtrahieren (GlideTime startTime, GlideTime endTime)

    Ruft die Dauerdifferenz zwischen zwei GlideTime-Objektwerten ab.

    Tabelle : 37. Parameter
    Name Typ Beschreibung
    startTime GlideTime Der Startwert.
    endTime GlideTime Der Endwert.
    Tabelle : 38. Rückgaben
    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());