---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideTime -- Umfang

# GlideTime -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 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](https://servicenow-prod.fluidtopics.net/oQfsITLmYDkL95UEc1aX9g#date-and-time-format-guidelines "Sie können ein Datumsformat mit einer Sequenz bestimmter Datums- und Zeitmusterzeichenfolgen angeben. Eine Musterzeichenfolge besteht aus einem oder mehreren Groß- und Kleinbuchstaben von A bis Z. Jeder Text in Anführungszeichen wird ignoriert und stattdessen in die Datumsausgabe kopiert.").

## GlideTime: GlideTime() {#ariaid-title2}

Instanziiert ein GlideTime-Objekt mit der aktuellen Zeit.
{#r_ScopedGlideTimeGlideTime__table_cxr_tsb_2r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#r_ScopedGlideTimeGlideTime__table_cxr_tsb_2r}  

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

## GlideTime -- GlideTime (Anzahl Millisekunden) {#ariaid-title3}

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).
{#r_ScopedGlideTimeGlideTime_Number__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Millisekunden | Nummer | Zeit zum Hinzufügen zu Mitternacht UTC. Einheit: Millisekunden |
[Tabelle : 2. Parameter]

{#r_ScopedGlideTimeGlideTime_Number__table_vy2_525_jq}  
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) {#ariaid-title4}

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](https://www.servicenow.com/docs/access?context=r_FormatDateAndTimeFields&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). 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.
{#r_ScopedGlideTimeGetByFormat_String__table_vy2_525_jq__entry__3}

| 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 {#r_ScopedGlideTimeGetByFormat_String__ul_cdw_4zy_jkb} |
[Tabelle : 3. Parameter]

{#r_ScopedGlideTimeGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideTimeGetByFormat_String__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Zeit im angegebenen Format. |
[Tabelle : 4. Rückgaben]

{#r_ScopedGlideTimeGetByFormat_String__table_qpt_3f5_jq}  

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

Ausgabe:

    12:00

## GlideTime -- getDisplayValue() {#ariaid-title5}

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.
{#r_ScopedGlideTimeGetDisplayValue__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 5. Parameter]

{#r_ScopedGlideTimeGetDisplayValue__table_vy2_525_jq} {#r_ScopedGlideTimeGetDisplayValue__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die Zeit im Format und in der Zeitzone des Anwenders. |
[Tabelle : 6. Rückgaben]

{#r_ScopedGlideTimeGetDisplayValue__table_qpt_3f5_jq}  

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

## GlideTime -- getDisplayValueInternal() {#ariaid-title6}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 7. Parameter]

{#r_ScopedGlideTimeGetDisplayValueInternal__table_vy2_525_jq} {#r_ScopedGlideTimeGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Zeitwert für das GlideTime-Objekt in der Zeitzone des aktuellen Anwenders und das interne Zeitformat „HH:mm:ss". |
[Tabelle : 8. Rückgaben]

{#r_ScopedGlideTimeGetDisplayValueInternal__table_qpt_3f5_jq}  

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

## GlideTime -- getHourLocalTime() {#ariaid-title7}

Gibt den Stundenanteil der Zeit mithilfe der lokalen Zeitzone zurück.
{#r_SGT-getHourLocalTime__table_pwr_c2d_kw__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 9. Parameter]

{#r_SGT-getHourLocalTime__table_pwr_c2d_kw} {#r_SGT-getHourLocalTime__table_qwr_c2d_kw__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Die Stunden unter Verwendung der lokalen Zeitzone. |
[Tabelle : 10. Rückgaben]

{#r_SGT-getHourLocalTime__table_qwr_c2d_kw}

## GlideTime -- getHourOfDayLocalTime() {#ariaid-title8}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 11. Parameter]

{#r_SGT-getHourOfDayLocalTime__table_lrw_4dd_kw} {#r_SGT-getHourOfDayLocalTime__table_mrw_4dd_kw__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Die Stunden unter Verwendung der lokalen Zeitzone. Die Anzahl der Stunden basiert auf einer 24-Stunden-Uhr. |
[Tabelle : 12. Rückgaben]

{#r_SGT-getHourOfDayLocalTime__table_mrw_4dd_kw}

## GlideTime -- getHourOfDay UTC() {#ariaid-title9}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 13. Parameter]

{#r_SGT-getHourOfDayUTC__table_bv5_zxc_kw} {#r_SGT-getHourOfDayUTC__table_cv5_zxc_kw__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Die Stunden, die die UTC-Zeitzone verwenden. Die Anzahl der Stunden basiert auf einer 24-Stunden-Uhr. |
[Tabelle : 14. Rückgaben]

{#r_SGT-getHourOfDayUTC__table_cv5_zxc_kw}

## GlideTime -- getHourUTC() {#ariaid-title10}

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.
{#r_SGT-getHourUTC__table_cfh_nyc_kw__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 15. Parameter]

{#r_SGT-getHourUTC__table_cfh_nyc_kw} {#r_SGT-getHourUTC__table_dfh_nyc_kw__entry__2}

| 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. |
[Tabelle : 16. Rückgaben]

{#r_SGT-getHourUTC__table_dfh_nyc_kw}

## GlideTime -- getMinutesLocalTime() {#ariaid-title11}

Gibt die Anzahl der Minuten anhand der lokalen Zeitzone zurück.
{#r_SGT-getMinutesLocalTime__table_gx3_q2d_kw__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 17. Parameter]

{#r_SGT-getMinutesLocalTime__table_gx3_q2d_kw} {#r_SGT-getMinutesLocalTime__table_hx3_q2d_kw__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Die Anzahl der Minuten unter Verwendung der lokalen Zeitzone. |
[Tabelle : 18. Rückgaben]

{#r_SGT-getMinutesLocalTime__table_hx3_q2d_kw}

## GlideTime -- getMinutesUTC() {#ariaid-title12}

Gibt die Anzahl der Minuten in der Stunde basierend auf der UTC-Zeitzone zurück.
{#r_SGT-getMinutesUTC__table_qvr_xcd_kw__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 19. Parameter]

{#r_SGT-getMinutesUTC__table_qvr_xcd_kw} {#r_SGT-getMinutesUTC__table_rvr_xcd_kw__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Die Anzahl der Minuten in der Stunde unter Verwendung der UTC-Zeitzone. |
[Tabelle : 20. Rückgaben]

{#r_SGT-getMinutesUTC__table_rvr_xcd_kw}

## GlideTime -- getSeconds() {#ariaid-title13}

Gibt die Anzahl der Sekunden in der aktuellen Minute zurück.
{#r_SGT-getSeconds__table_dkh_1fd_kw__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 21. Parameter]

{#r_SGT-getSeconds__table_dkh_1fd_kw} {#r_SGT-getSeconds__table_ekh_1fd_kw__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Die Anzahl der Sekunden in der Minute. |
[Tabelle : 22. Rückgaben]

{#r_SGT-getSeconds__table_ekh_1fd_kw}

## GlideTime -- getValue() {#ariaid-title14}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 23. Parameter]

{#r_ScopedGlideTimeGetValue__table_vy2_525_jq} {#r_ScopedGlideTimeGetValue__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Zeitwert in der internen Fomat und Systemzeitzone. |
[Tabelle : 24. Rückgaben]

{#r_ScopedGlideTimeGetValue__table_qpt_3f5_jq}  

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

## GlideTime -- setDisplayValue(Zeichenfolge asDisplayed) {#ariaid-title15}

Legt einen Zeitwert mithilfe des Anzeigeformats und der Zeitzone des aktuellen Anwenders fest.
{#r_ScopedGlideTimeSetDisplayValue_String__table_vy2_525_jq__entry__3}

| 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 : 25. Parameter]

{#r_ScopedGlideTimeSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideTimeSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 26. Rückgaben]

{#r_ScopedGlideTimeSetDisplayValue_String__table_qpt_3f5_jq1}  

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

## GlideTime -- setValue(Zeichenfolge o) {#ariaid-title16}

Legt die Zeit des GlideTime-Objekts in der internen Zeitzone fest.
{#r_ScopedGlideTimeSetValue_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| o | Zeichenfolge | Die Zeit im Format hh:mm:ss. |
[Tabelle : 27. Parameter]

{#r_ScopedGlideTimeSetValue_String__table_vy2_525_jq} {#r_ScopedGlideTimeSetValue_String__table_qpt_3f5_jq1__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 28. Rückgaben]

{#r_ScopedGlideTimeSetValue_String__table_qpt_3f5_jq1}  

    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) {#ariaid-title17}

Ruft die Dauerdifferenz zwischen zwei GlideTime-Objektwerten ab.
{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| startTime | GlideTime | Der Startwert. |
| endTime | GlideTime | Der Endwert. |
[Tabelle : 29. Parameter]

{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_vy2_525_jq} {#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideDuration | Die Dauer zwischen den beiden Werten. |
[Tabelle : 30. Rückgaben]

{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_qpt_3f5_jq}  

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


