---
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


---

# GlideSchedule -- Umfang

# GlideSchedule -- Umfang {#ariaid-title1}

Der Umfang ist festgelegt GlideSchedule Die API bietet Methoden für die Ausführung von Vorgängen an GlideSchedule-Objekten, z. B. das Hinzufügen neuer Zeitplansegmente zu einem Zeitplan, das Bestimmen, ob ein Datum/eine Uhrzeit innerhalb des Zeitplans liegt, oder das Festlegen der Zeitzone des Zeitplans.

## GlideSchedule -- GlideSchedule() {#ariaid-title2}

Instanziiert ein leeres GlideSchedule-Objekt.
{#r_ScopedGlideScheduleGlideSchedule__table_ulv_hhr_2r__entry__3}

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

{#r_ScopedGlideScheduleGlideSchedule__table_ulv_hhr_2r}

## GlideSchedule -- GlideSchedule (Zeichenfolge sysID, Zeichenfolgenzeitzone) {#ariaid-title3}

Instanziiert ein GlideSchedule-Objekt und lädt die Zeitplaninformationen. Wenn keine Zeitzone angegeben ist, wird die Zeitzone der aktuellen Sitzung verwendet.
{#r_SGSCH-GlideSchedule_S_S__table_emk_4cg_1r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sysID | Zeichenfolge | Die System-ID für den Zeitplan. |
| timeZone | Zeichenfolge | Optional. Die zu verwendende Zeitzone. Standard: Die Zeitzone der aktuellen Sitzung. Zeitzonen können in den folgenden Formaten angegeben werden. * `Land/Stadt `. Beispiel: `Amerika/Los_Angeles `. * `Land/Zeitzone `. Beispiel: `USA/Pazifik `. * `Zeitzonenabkürzung `. Beispiel: `PST `. {#r_SGSCH-GlideSchedule_S_S__ul_up2_zln_lwb}Eine vollständige Liste der gültigen Zeitzonen finden Sie unter Zeitzone Feld in der Anwendertabelle \[sys_user\]. Weitere Informationen zu Zeitzonen finden Sie unter [Time zones](https://www.servicenow.com/docs/access?context=r_TimeZones&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). |
[Tabelle : 2. Parameter]

{#r_SGSCH-GlideSchedule_S_S__table_emk_4cg_1r}  

    var schedule = new GlideSchedule('090eecae0a0a0b260077e1dfa71da828', 'US/Pacific');

## GlideSchedule -- hinzufügen(GlideDateTime startDate, GlideDuration Offset) {#ariaid-title4}

Fügt dem aktuellen Zeitplan ein neues Zeitplansegment hinzu.
{#r_SGSCH-Add_GDT_GD__table_kws_rdg_1r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| startDate | GlideDateTime | Das Startdatum des neuen Zeitplansegments. |
| Offset | GlideDuration | Der Zeitversatz des neuen Zeitplansegments. |
[Tabelle : 3. Parameter]

{#r_SGSCH-Add_GDT_GD__table_kws_rdg_1r} {#r_SGSCH-Add_GDT_GD__table_mws_rdg_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideDateTime | Der Zeitplan wurde mit dem neuen Zeitplansegment aktualisiert. |
[Tabelle : 4. Rückgaben]

{#r_SGSCH-Add_GDT_GD__table_mws_rdg_1r}  

    var startDate = new GlideDateTime('2014-01-02');
    var days = 2;
    var dur = new GlideDuration(60 * 60 * 24 * 1000 * days);
    var schedule = new GlideSchedule();
    var end = schedule.add(startDate, dur);
    gs.info(end);

Ausgabe:

    2014-01-04 00:00:00

## GlideSchedule -- Dauer (GlideDateTime startDate, GlideDateTime endDate) {#ariaid-title5}

Bestimmt die verstrichene Zeit im Zeitplan zwischen zwei Datums-/Uhrzeitwerten anhand der Zeitzone des Zeitplans oder, wenn dies nicht angegeben ist, der Zeitzone der Sitzung.
{#r_SGSCH-Duration_GDT_GDT__table_dlk_j3g_1r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| startDate | GlideDateTime | Das Startdatum/-Uhrzeit. |
| endDate | GlideDateTime | Das Enddatum/-Uhrzeit. |
[Tabelle : 5. Parameter]

{#r_SGSCH-Duration_GDT_GDT__table_dlk_j3g_1r} {#r_SGSCH-Duration_GDT_GDT__table_flk_j3g_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideDuration | Die Differenz zwischen Start- und Enddatum/-Zeit. |
[Tabelle : 6. Rückgaben]

{#r_SGSCH-Duration_GDT_GDT__table_flk_j3g_1r}  

    var startDate = new GlideDateTime('2014-10-16 02:00:00');
    var endDate = new GlideDateTime('2014-10-18 04:00:00');
    var schedule = new GlideSchedule();
     
    schedule.load('090eecae0a0a0b260077e1dfa71da828'); // loads "8-5 weekdays excluding holidays" schedule
    var duration = schedule.duration(startDate, endDate);
    gs.info(duration.getDurationValue()); // gets the elapsed time in schedule

## GlideSchedule -- getName() {#ariaid-title6}

Ruft den Zeitplannamen ab.
{#r_ScopedGlideScheduleGetName__table_onn_hhr_2r__entry__3}

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

{#r_ScopedGlideScheduleGetName__table_onn_hhr_2r} {#r_ScopedGlideScheduleGetName__table_tcd_rwg_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Name des aktuellen Zeitplans. |
[Tabelle : 8. Rückgaben]

{#r_ScopedGlideScheduleGetName__table_tcd_rwg_1r}  

    sys_id ='04e664654a36232701a2247dcd8fc4cf'; // sys_id for "Application" schedule record
    var sched = new GlideSchedule(sys_id);
    gs.info(sched.getName());

## GlideSchedule -- isInSchedule(GlideDateTime) {#ariaid-title7}

Bestimmt, ob das angegebene Datum und die angegebene Uhrzeit innerhalb des aktuellen Zeitplans liegen.
{#r_SGSCH-IsInSchedule_GDT__table_lvd_jkg_1r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Zeitreihendiagramm | GlideDateTime | Zu überprüfender Datums- und Uhrzeitwert. |
[Tabelle : 9. Parameter]

{#r_SGSCH-IsInSchedule_GDT__table_lvd_jkg_1r} {#r_SGSCH-IsInSchedule_GDT__table_nvd_jkg_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das angegebene Datum und die angegebene Uhrzeit innerhalb des Zeitplans liegen. Gültige Werte: * Wahr: Datum und Uhrzeit liegen innerhalb des Zeitplans. * Falsch: Datum und Uhrzeit liegen außerhalb des Zeitplans. {#r_SGSCH-IsInSchedule_GDT__ul_ujh_rxv_p4b} |
[Tabelle : 10. Rückgaben]

{#r_SGSCH-IsInSchedule_GDT__table_nvd_jkg_1r}  

    var glide = new GlideRecord('cmn_schedule');
    glide.addQuery('type', 'blackout');
    glide.query();
    if (glide.next()) {
       var sched = new GlideSchedule(glide.sys_id);
       var date = new GlideDateTime();
       date.setDisplayValue("2007-09-18 12:00:00");
       if (sched.isInSchedule(date)) 
          gs.info("Is in the schedule");
       else
          gs.info("Is NOT in the schedule");
    }

## GlideSchedule -- isValid() {#ariaid-title8}

Bestimmt, ob der aktuelle Zeitplan gültig ist. Ein Zeitplan ist gültig, wenn er mindestens eine Zeitplanspanne hat.
{#r_ScopedGlideScheduleIsValid__table_th1_plg_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn der Zeitplan gültig ist. |
[Tabelle : 11. Rückgaben]

{#r_ScopedGlideScheduleIsValid__table_th1_plg_1r}  

    var glide = new GlideRecord('cmn_schedule');
    glide.addQuery('type', 'blackout');
    glide.query();
    if (glide.next()) {
       var sched = new GlideSchedule(glide.sys_id);
       var date = new GlideDateTime();
       date.setDisplayValue("2007-09-18 12:00:00");
       if (sched.isValid()) 
          gs.info("Is valid");
     
       else
          gs.info("Is not valid");
    }

## GlideSchedule -- load(Zeichenfolge sysID, Zeichenfolgenzeitzone, Zeichenfolge excludeSpanID) {#ariaid-title9}

Lädt einen Zeitplan mit den Zeitplaninformationen.
{#r_SGSCH-Load_S_S_S__table_ztn_lxg_1r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sysID | Zeichenfolge | Die System-ID des Zeitplans. |
| timeZone | Zeichenfolge | (Optional) die Zeitzone. Wenn keine Zeitzone angegeben ist oder Null ist, wird die aktuelle Sitzungszeitzone für den Zeitplan verwendet. |
| ExcludeSpanID | Zeichenfolge | Beliebiger auszuschließender Bereich. |
[Tabelle : 12. Parameter]

{#r_SGSCH-Load_S_S_S__table_ztn_lxg_1r} {#r_SGSCH-Load_S_S_S__table_tcd_rwg_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 13. Rückgaben]

{#r_SGSCH-Load_S_S_S__table_tcd_rwg_1r}  

    var x = new GlideSchedule();
    x.load('08fcd0830a0a0b2600079f56b1adb9ae');

## GlideSchedule -- setTimeZone (Zeichenfolgenzeitzone) {#ariaid-title10}

Legt die Zeitzone für den aktuellen Zeitplan fest.
{#r_SGSCH-SetTimeZone_S__table_sdh_hzg_1r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| timeZone | Zeichenfolge | Die zu verwendende Zeitzone. Zeitzonen können in den folgenden Formaten angegeben werden. * `Land/Stadt `. Beispiel: `Amerika/Los_Angeles `. * `Land/Zeitzone `. Beispiel: `USA/Pazifik `. * `Zeitzonenabkürzung `. Beispiel: `PST `. {#r_SGSCH-SetTimeZone_S__ul_up2_zln_lwb}Eine vollständige Liste der gültigen Zeitzonen finden Sie unter Zeitzone Feld in der Anwendertabelle \[sys_user\]. Weitere Informationen zu Zeitzonen finden Sie unter [Time zones](https://www.servicenow.com/docs/access?context=r_TimeZones&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). |
[Tabelle : 14. Parameter]

{#r_SGSCH-SetTimeZone_S__table_sdh_hzg_1r} {#r_SGSCH-SetTimeZone_S__table_tcd_rwg_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 15. Rückgaben]

{#r_SGSCH-SetTimeZone_S__table_tcd_rwg_1r}  
In diesem Beispiel wird die Zeitzone für den Zeitplan auf USA/Pazifik festgelegt.

    var schedule = new GlideSchedule();
    schedule.setTimeZone('US/Pacific');

## GlideSchedule -- WhiNext(GlideDateTime, Zeichenfolgenzeitzone) {#ariaid-title11}

Bestimmt, wie viel Zeit (in Millisekunden) bis zur Startzeit des nächsten Zeitplanelements liegt.
Diese Funktion soll aufgerufen werden, wenn sich das GlideSchedule-Objekt (Tabelle „cmn_schedule") derzeit nicht im Zeitplanfenster befindet. Der Aufruf „WhiNext()" gibt die Dauer (in ms) zurück, bis sich das GlideSchedule-Objekt innerhalb des Zeitplans befindet. Diese Funktion gibt keinen aussagekräftigen Wert zurück, wenn sie aufgerufen wird, wenn sich das GlideSchedule-Objekt innerhalb des Zeitplans befindet.
{#r_SGSCH-WhenNext_GDT_S__table_i1b_myg_1r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Zeitreihendiagramm | GlideDateTime | Auszuwertende Zeit |
| timeZone | Zeichenfolge | Zeitzone |
[Tabelle : 16. Parameter]

{#r_SGSCH-WhenNext_GDT_S__table_i1b_myg_1r} {#r_SGSCH-WhenNext_GDT_S__table_k1b_myg_1r__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Anzahl der Millisekunden bis zur Startzeit des nächsten Zeitplanelements. Gibt -1 zurück, wenn nie. |
[Tabelle : 17. Rückgaben]

{#r_SGSCH-WhenNext_GDT_S__table_k1b_myg_1r}  

    var startDate = new GlideDateTime('2014-10-25 08:00:00');
    var glideSchedule = new GlideSchedule('08fcd0830a0a0b2600079f56b1adb9ae', 'UTC');
    gs.info(glideSchedule.whenNext(startDate));

Ausgabe:

    172800000

    testScript(); 
    function testScript() { 
    var now = new GlideDateTime(); //current date and time
    var sched = new GlideSchedule("<sys_id>"); // Use a cmn_schedule sys_id 
    if (sched.isInSchedule(now)){ 
    gs.info('We are in an active schedule window so whenNext() is not helpful'); 
    } else{  
    gs.info('Not currently in schedule so call whenNext()'); 
    var msUntilNext = sched.whenNext(new GlideDateTime(), 'US/Pacific'); 
    gs.info('Next schedule starts in '+msUntilNext+' milliseconds'); 
    } 
    }
    \\ Output [schedule inactive)]:
    \\ *** Script: Not currently in schedule so call whenNext() 
    \\ *** Script: Next schedule starts in -1 milliseconds

Ausgabe:

    [Scheduled for future] *** Script: Not currently in schedule *** Script: Next schedule starts in 332894000 milliseconds


