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

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideSchedule: Bereichsbezogen

# GlideSchedule: Bereichsbezogen {#ariaid-title1}

Die bereichsbezogene GlideSchedule- API bietet Methoden zum Ausführen von Vorgängen für GlideSchedule-Objekte, z. B. das Hinzufügen neuer Zeitplansegmente zu einem Zeitplan, das Bestimmen, ob ein Datum/eine Uhrzeit im Zeitplan liegt, oder das Festlegen der Zeitplanzeitzone.

## 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(String sysID, String timeZone) {#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 | 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 im Feld Zeitzone in der Tabelle Benutzer \[sys_user\]. Weitere Informationen zu Zeitzonen finden Sie unter [Time zones](https://www.servicenow.com/docs/access?context=r_TimeZones&version=xanadu&pubname=xanadu-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 -- add(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 | Startdatum des neuen Zeitplansegments. |
| offSet | GlideDuration | 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. Ergebnisse]

{#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 Datum-/Uhrzeit-Werten anhand der Zeitzone des Zeitplans oder, falls nicht anders angegeben, der Zeitzone der Sitzung.
{#r_SGSCH-Duration_GDT_GDT__table_dlk_j3g_1r__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| startDate | GlideDateTime | Datum/Uhrzeit Anfang. |
| endDate | GlideDateTime | Datum/Uhrzeit Ende. |
[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 | Unterschied zwischen Datum/Uhrzeit Anfang und Datum/Uhrzeit Ende. |
[Tabelle : 6. Ergebnisse]

{#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 | Name des aktuellen Zeitplans. |
[Tabelle : 8. Ergebnisse]

{#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-Zeit) {#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 |
|-|-|-|
| time | 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. Ergebnisse]

{#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 | „True", wenn der Zeitplan gültig ist. |
[Tabelle : 11. Ergebnisse]

{#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 -- laden (Zeichenfolge „sysID", Zeichenfolge „timeZone", 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 | System-ID des Zeitplans. |
| timeZone | Zeichenfolge | (Optional) Zeitzone. Wenn keine Zeitzone angegeben ist oder sie NULL ist, wird die aktuelle Sitzungszeitzone für den Zeitplan verwendet. |
| excludeSpanID | Zeichenfolge | Jede Spanne, die ausgeschlossen werden soll. |
[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 |
|-|-|
| void |   |
[Tabelle : 13. Ergebnisse]

{#r_SGSCH-Load_S_S_S__table_tcd_rwg_1r}  

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

## GlideSchedule -- setTimeZone(String timeZone) {#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 im Feld Zeitzone in der Tabelle Benutzer \[sys_user\]. Weitere Informationen zu Zeitzonen finden Sie unter [Time zones](https://www.servicenow.com/docs/access?context=r_TimeZones&version=xanadu&pubname=xanadu-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 |
|-|-|
| void |   |
[Tabelle : 15. Ergebnisse]

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

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

## GlideSchedule - wennNext(GlideDateTime time, String timeZone) {#ariaid-title11}

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

| Name | Typ | Beschreibung |
|-|-|-|
| time | GlideDateTime | Auszuwertende Zeit |
| Zeitzone | 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. Ergebnisse]

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