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


---

# Dauerrechner -- Global

# Dauerrechner -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 Minuten Lesedauer

Die Dauerrechner Die Skripteinbindung bietet Methoden zur Berechnung von Dauer und Fälligkeitsdaten.

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

Konstruktor für Dauerrechner Klasse.
{#r_DC-DurationCalculator__table_ik1_1kp_4t__entry__3}

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

{#r_DC-DurationCalculator__table_ik1_1kp_4t}  

    var dc = new DurationCalculator();

## DurationCalculator -- calcDuration (Anzahl Sekunden) {#ariaid-title3}

Berechnet ein Enddatum und eine Endzeit basierend auf dem aktuellen Startdatum und der aktuellen Startzeit und der vergebenen Dauer (Sekunden).
Diese Methode legt auch fest this.endDateTime, this.seconds, Und this.totalSecondsEigenschaften mit den aktualisierten Werten. Die secondsDie Eigenschaft stellt die Gesamtzahl der Sekunden der Arbeit dar, die in der Dauer basierend auf dem Arbeitszeitplan ausgeführt werden soll. Die totalSecondsDie Eigenschaft stellt die Gesamtzahl der Sekunden zwischen den Start- und Endzeiten der Dauer dar, einschließlich Arbeit und nicht-Arbeit.

Bevor Sie diese Methode aufrufen, müssen Sie aufrufen SetStartdateTime() Mit der Startzeit, die für die Dauer verwendet werden soll.
{#r_DC-calcDuration_N__table_pw4_gvb_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Sekunden | Nummer | Anzahl der Sekunden, die dem Startdatum und der Startzeit hinzugefügt werden sollen, um die Werte für Enddatum und -Uhrzeit, Sekunden und Gesamtzeitsekunden zu berechnen. |
[Tabelle : 2. Parameter]

{#r_DC-calcDuration_N__table_pw4_gvb_4t} {#r_DC-calcDuration_N__table_qw4_gvb_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Falsch", wenn der Eingabewert keine Zahl ist. |
[Tabelle : 3. Rückgaben]

{#r_DC-calcDuration_N__table_qw4_gvb_4t}  

    var gdt = new GlideDateTime("2020-05-01 00:00:00");

    var dc = new DurationCalculator();
    dc.setStartDateTime(gdt);

    if(!dc.calcDuration(2*24*3600)){ // 2 days
      gs.log("*** Error calculating duration");
      return;
    }
    var secs = dc.getSeconds();
    var totalSecs = dc.getTotalSeconds();

    gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

Ausgabe

    ***SCHEDULE DURATION: SECS=172800 TOTALSECS=970534 ENDTIME = 2020-05-03 00:00:00

## DurationCalculator -- calcRelativeDueDate(GlideDateTime Start, Anzahl Tage, Zeichenfolgenendzeit ) {#ariaid-title4}

Berechnet das Fälligkeitsdatum ab der übergebenen Startzeit und addiert die Anzahl der Tage anhand des aktuellen Zeitplans und der Zeitzone.
Aus Definitionen der relativen Dauer aufgerufen, initiiert von CalcRelativeDuration() , Als `calculator.calcRelativeDueDate(calculator.startDateTime, Tage) `. Sobald der Tag bestimmt ist, an dem die Arbeit fällig ist, legt die Methode die Zeit auf die übergebene fest endTimeDes Tages. Wenn der Zeitplan nicht mehr genügend Tage enthält, wird der letzte Tag im Zeitplan verwendet.
{#r_DC-calcRelativeDueDate_GDT_N_S__table_vw4_gvb_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| start | GlideDateTime | GlideDateTime-Objekt, das das Startdatum für die Berechnung enthält. |
| Tage | Nummer | Anzahl der Tage, die dem Startdatum hinzugefügt werden sollen. |
| endTime | Zeichenfolge | Tageszeit, zu der die Arbeit am berechneten Fälligkeitsdatum fällig ist. Wenn leer, wird standardmäßig das Ende des Arbeitstags verwendet. Format: HH:mm:ss |
[Tabelle : 4. Parameter]

{#r_DC-calcRelativeDueDate_GDT_N_S__table_vw4_gvb_4t} {#r_DC-calcRelativeDueDate_GDT_N_S__table_ww4_gvb_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das Abschlussdatum innerhalb des Zeitplans liegt. Mögliche Werte: * Wahr: Das Abschlussdatum liegt innerhalb des Zeitplans. * Falsch: Das Abschlussdatum liegt außerhalb des Zeitplans. Nicht definiert, wenn vor dem Aufrufen dieser Methode kein Zeitplan festgelegt wurde. |
[Tabelle : 5. Rückgaben]

{#r_DC-calcRelativeDueDate_GDT_N_S__table_ww4_gvb_4t}  

    var dc = new DurationCalculator();
    var startTime = new GlideDateTime();

    // Settings for calculations
    // Optional: Specify the schedule to use for the following calculations
    dc.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
    // Optional: Specify a different timezone to use
    dc.setTimeZone("Los Angeles");
    // Optional: Set a start date and time, otherwise the current time is assumed
    dc.setStartDateTime("2020-04-10 08:00:00")
    // Calculate end time, from number of seconds required in the schedule
    dc.calcDuration(3*24*3600); // 3 days
    dc.calcRelativeDueDate(startTime, "3", "07:00:00");

## DurationCalculator -- calcRelativeDuration(Zeichenfolge relativeDurationID) {#ariaid-title5}

Berechnet die Dauer anhand des angegebenen Skripts für relative Dauer.
Nach Abschluss wird this.endDateTimeUnd this.secondsEigenschaften werden festgelegt, um die Ergebnisse der Berechnung anzugeben.
{#r_DC-calcRelativeDuration_S__table_rw4_gvb_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| RelativeDurationID | Zeichenfolge | sys_ID des Zeitplans für relative Dauer (Tabelle cmn_relative_duration). |
[Tabelle : 6. Parameter]

{#r_DC-calcRelativeDuration_S__table_rw4_gvb_4t} {#r_DC-calcRelativeDuration_S__table_sw4_gvb_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Das Ergebnis des Dauerskripts. |
[Tabelle : 7. Rückgaben]

{#r_DC-calcRelativeDuration_S__table_sw4_gvb_4t}  

    var dc = new DurationCalculator();
    dc.calcRelativeDuration('08fcd0830a0a1b2600074f56b1ad7cb');

## DurationCalculator -- calcScheduleDuration(Zeichenfolge startTime, Zeichenfolge endTime) {#ariaid-title6}

Gibt die Dauer zwischen zurück startTimeUnd endTimeInnerhalb des bereits angegebenen Zeitplans und der optional überschriebenen Zeitzone.
Diese Methode legt auch fest this.endDateTime, this.seconds, Und this.totalSecondsIm aktuellen Zeitplanobjekt.
{#r_DC-calcScheduleDuration_S_S__table_lw4_gvb_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| startTime | Zeichenfolge | Optional. Anzeigewert für die Endzeit. Standard: Verwendet das aktuelle Datum und die aktuelle Uhrzeit (festgelegt mit SetStartdateTime() ). Sie müssen einen Platzhalter übergeben, wenn dieser Parameter nicht übergeben wurde, z. B. `dur.calcScheduleDuration("", endDateTime); `. |
| endTime | Zeichenfolge | Optional. Anzeigewert für die Startzeit. Standard: Verwendet das aktuelle Datum und die aktuelle Uhrzeit (festgelegt mit SetEndDateTime() ). |
[Tabelle : 8. Parameter]

{#r_DC-calcScheduleDuration_S_S__table_lw4_gvb_4t} {#r_DC-calcScheduleDuration_S_S__table_mw4_gvb_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Zeitplandauer. Gibt 0 zurück, wenn endTimeIst vor startTime. Einheit: Sekunden |
[Tabelle : 9. Rückgaben]

{#r_DC-calcScheduleDuration_S_S__table_mw4_gvb_4t}  

    var dur = new DurationCalculator();

    // Set 9-5 weekday schedule. This is the schedule in which endDateTime, seconds, and totalseconds is set
    dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae');
    dur.calcScheduleDuration("2019-01-02 11:00:00", "2019-01-06 09:00:00");
    var secs = dur.getSeconds();
    var totalSecs = dur.getTotalSeconds();
    var endDateTime = dur.getEndDateTime() + "";

    gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

Ausgabe

    ***SCHEDULE DURATION: SECS=97200 TOTALSECS=338400 ENDTIME = 2019-01-06 09:00:00

## DurationCalculator -- calcScheduleDuration(GlideDateTime startTime, GlideDateTime endTime) {#ariaid-title7}

Gibt die Dauer zwischen zurück startTimeUnd endTimeInnerhalb des bereits angegebenen Zeitplans und der optional überschriebenen Zeitzone.
Diese Methode legt auch fest this.endDateTime, this.seconds, Und this.totalSecondsIm aktuellen Zeitplanobjekt.
{#r_DC-calcScheduleDuration_GDT_GDT__table_nw4_gvb_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| startTime | GlideDateTime | Optional. GlideDateTime-Objekt, das die zu verwendende Startzeit enthält. Standard: Verwendet das aktuelle Datum und die aktuelle Uhrzeit (festgelegt mit SetStartdateTime() ). Sie müssen einen Platzhalter übergeben, wenn dieser Parameter nicht übergeben wurde, z. B. `dur.calcScheduleDuration("", endDateTime); `. |
| endTime | GlideDateTime | Optional. GlideDateTime-Objekt, das die zu verwendende Endzeit enthält. Standard: Verwendet das aktuelle Datum und die aktuelle Uhrzeit (festgelegt mit SetEndDateTime() ). |
[Tabelle : 10. Parameter]

{#r_DC-calcScheduleDuration_GDT_GDT__table_nw4_gvb_4t} {#r_DC-calcScheduleDuration_GDT_GDT__table_mw4_gvb_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Zeitplandauer. Gibt 0 zurück, wenn endTimeIst vor startTime. Einheit: Sekunden |
[Tabelle : 11. Rückgaben]

{#r_DC-calcScheduleDuration_GDT_GDT__table_mw4_gvb_4t}  

    var startDateTime = new GlideDateTime("2020-11-02 11:00:00");
    // Instantiate a new GlideDateTime object which has the end date as the current date and time
    var endDateTime = new GlideDateTime(); 
    var dur = new DurationCalculator();

    // Set 9-5 weekday schedule. This is the schedule in which endDateTime, seconds, and totalseconds is set
    dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
    dur.calcScheduleDuration(startDateTime, endDateTime);
    var secs = dur.getSeconds();
    var totalSecs = dur.getTotalSeconds();

    gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

Ausgabe

    ***SCHEDULE DURATION: SECS=293734.24 TOTALSECS=970534 ENDTIME = 2020-11-13 16:35:34

## DurationCalculator -- getEndDateTime( ) {#ariaid-title8}

Ruft ab endDateTimeEigenschaft, die von festgelegt wurde Berechnungsdauer / KalkRelativeDauer , Gibt das Enddatum und die Endzeit für die Dauer an.
{#r_DC-getEndDateTime__table_gvv_nlz_nt__entry__3}

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

{#r_DC-getEndDateTime__table_gvv_nlz_nt} {#r_DC-getEndDateTime__table_hvv_nlz_nt__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideDateTime | Das Ende Datum/Uhrzeit . |
[Tabelle : 13. Rückgaben]

{#r_DC-getEndDateTime__table_hvv_nlz_nt}  

    var dc = new DurationCalculator();
    dc.calcDuration(52);
    gs.print(dc.getEndDateTime());

2012-04-17 20:57:27

## DurationCalculator -- getSeconds( ) {#ariaid-title9}

Gibt zurück this.secondsEigenschaft, die von festgelegt wurde Berechnungsdauer / KalkRelativeDauer , Gibt die Gesamtzahl der Sekunden der Arbeit an, die für die Dauer ausgeführt werden soll.
Dies ist die Gesamtarbeitszeit, nicht die Gesamtzeit zwischen Start- und Endzeiten und kann verwendet werden, um Prozentsätze der Arbeitszeit zu bestimmen.
{#r_DC-getSeconds__table_ivv_nlz_nt__entry__3}

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

{#r_DC-getSeconds__table_ivv_nlz_nt} {#r_DC-getSeconds__table_jvv_nlz_nt__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Die Gesamtarbeitszeit in Sekunden. |
[Tabelle : 15. Rückgaben]

{#r_DC-getSeconds__table_jvv_nlz_nt}  

    var startDateTime = new GlideDateTime("2020-11-02 11:00:00");
    // Instantiate a new GlideDateTime object which has the end date as the current date and time
    var endDateTime = new GlideDateTime(); 
    var dur = new DurationCalculator();

    // Set 9-5 weekday schedule. This is the schedule in which endDateTime, seconds, and totalseconds is set
    dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
    dur.calcScheduleDuration(startDateTime, endDateTime);
    var secs = dur.getSeconds();
    var totalSecs = dur.getTotalSeconds();

    gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

Ausgabe

    ***SCHEDULE DURATION: SECS=293734.24 TOTALSECS=970534 ENDTIME = 2020-11-13 16:35:34

## DurationCalculator -- getTotalSeconds( ) {#ariaid-title10}

Gibt zurück totalSecondsWert, der durch einen Aufruf auf festgelegt wurde Berechnen (Datensatz) .
Die totalSecondsDie Eigenschaft stellt die Gesamtzahl der Sekunden zwischen den Start- und Endzeiten der Dauer dar, einschließlich Arbeit und nicht-Arbeit.
{#r_DC-getTotalSeconds__table_qjq_bs1_4t__entry__3}

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

{#r_DC-getTotalSeconds__table_qjq_bs1_4t} {#r_DC-getTotalSeconds__table_rjq_bs1_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Die Gesamtzahl der Sekunden. |
[Tabelle : 17. Rückgaben]

{#r_DC-getTotalSeconds__table_rjq_bs1_4t}  

    var startDateTime = new GlideDateTime("2020-11-02 11:00:00");
    // Instantiate a new GlideDateTime object which has the end date as the current date and time
    var endDateTime = new GlideDateTime(); 
    var dur = new DurationCalculator();

    // Set 9-5 weekday schedule. This is the schedule in which endDateTime, seconds, and totalseconds is set
    dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
    dur.calcScheduleDuration(startDateTime, endDateTime);
    var secs = dur.getSeconds();
    var totalSecs = dur.getTotalSeconds();

    gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

Ausgabe

    ***SCHEDULE DURATION: SECS=293734.24 TOTALSECS=970534 ENDTIME = 2020-11-13 16:35:34

## DurationCalculator -- isAfter(GlideDateTime dt, Zeichenfolge tm) {#ariaid-title11}

Vergleicht die in der Zeit übergebene mit dem Zeitwert im übergebenen GlideDateTime-Objekt.
{#r_DC-isAfter_GDT_S__table_tw4_gvb_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| DT | GlideDateTime oder Zeichenfolge | Entweder ein GlideDateTime-Objekt oder ein Datum und Uhrzeit des Anzeigewerts, der mit dem übergebenen verglichen werden soll tmWert. Wenn Sie ein Datum und eine Uhrzeit eines Anzeigewerts übergeben, konvertiert die Methode es in ein GlideDateTime-Objekt. |
| TM | Zeichenfolge | Anzeigewert für die Zeit, die mit dem Zeitwert im GlideDateTime-Objekt verglichen werden soll. Geht von demselben Datum aus. Format: HH:mm:ss |
[Tabelle : 18. Parameter]

{#r_DC-isAfter_GDT_S__table_tw4_gvb_4t} {#r_DC-isAfter_GDT_S__table_uw4_gvb_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der in der Zeit übergebene Wert ( tm) Liegt nach der Zeit im GlideDateTime-Objekt ( dt). Mögliche Werte: * Wahr: tmIst nach dt. * Falsch tmIst nicht nach dt. |
[Tabelle : 19. Rückgaben]

{#r_DC-isAfter_GDT_S__table_uw4_gvb_4t}  

    var dc = new DurationCalculator();
    gs.print(dc.isAfter("2020-04-10 08:00:00", "09:00:00"));

\*\*\* Skript: Wahr

## DurationCalculator -- setSchedule (Zeichenfolge schedId, Zeichenfolgenzeitzone ) {#ariaid-title12}

Legt den Zeitplan und die Zeitzone für die Berechnung des Fälligkeitsdatums fest.
{#r_DC-setSchedule_S_S__table_y5v_nlz_nt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SchedId | Zeichenfolge | SYS_ID des festzulegenden Zeitplans. Tabelle: Zeitplan \[cmn_schedule\]. |
| Feld | Zeichenfolge | Optional. Festzulegende Zeitzone. Standard: Zeitzone des Anwenders. |
[Tabelle : 20. Parameter]

{#r_DC-setSchedule_S_S__table_y5v_nlz_nt} {#r_DC-setSchedule_S_S__table_z5v_nlz_nt__entry__2}

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

{#r_DC-setSchedule_S_S__table_z5v_nlz_nt}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var startDateTime = new GlideDateTime("2020-11-02 11:00:00");
    // Instantiate a new GlideDateTime object which has the end date as the current date and time
    var endDateTime = new GlideDateTime(); 
    var dur = new DurationCalculator();

    // Set 9-5 weekday schedule. This is the schedule in which endDateTime, seconds, and totalseconds is set
    dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
    dur.calcScheduleDuration(startDateTime, endDateTime);
    var secs = dur.getSeconds();
    var totalSecs = dur.getTotalSeconds();

    gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

Ausgabe:

    ***SCHEDULE DURATION: SECS=293734.24 TOTALSECS=970534 ENDTIME = 2020-11-13 16:35:34

## DurationCalculator -- setStartDateTime (Zeichenfolgenstart ) {#ariaid-title13}

Legt das Startdatum und die Startzeit für die Berechnungen der Dauer fest.
{#r_DC-setStartDateTime_S__table_cvv_nlz_nt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| start | Zeichenfolge | Anzeigewert für die Startzeit in GMT für nachfolgende Berechnungen. |
[Tabelle : 22. Parameter]

{#r_DC-setStartDateTime_S__table_cvv_nlz_nt} {#r_DC-setStartDateTime_S__table_dvv_nlz_nt__entry__2}

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

{#r_DC-setStartDateTime_S__table_dvv_nlz_nt}  

    var dc = new DurationCalculator();
    dc.setStartDateTime("2020-04-10 08:00:00")

## DurationCalculator -- setStartDateTime (GlideDateTime- Beschreibung) {#ariaid-title14}

Legt das Startdatum und die Startzeit für die Berechnungen der Dauer fest.
{#r_DC-setStartDateTime_GDT_N__table_evv_nlz_nt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Beschreibung | GlideDateTime | GlideDateTime-Objekt, das die Startzeit in GMT für nachfolgende Berechnungen enthält. |
[Tabelle : 24. Parameter]

{#r_DC-setStartDateTime_GDT_N__table_evv_nlz_nt} {#r_DC-setStartDateTime_GDT_N__table_fvv_nlz_nt__entry__2}

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

{#r_DC-setStartDateTime_GDT_N__table_fvv_nlz_nt}  

    var startDateTime = new GlideDateTime("2020-11-02 11:00:00"); 
    var dur = new DurationCalculator();

    // Set 9-5 weekday schedule.
    dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
    dur.setStartDateTime(startDateTime);

## DurationCalculator -- setTimeZone(Zeichenfolgenzeitzone ) {#ariaid-title15}

Legt die Zeitzone fest, die für die Berechnung des Fälligkeitsdatums verwendet werden soll.
{#r_DC-setTimeZone_S__table_avv_nlz_nt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Feld | Zeichenfolge | Wert der Zeitzone. |
[Tabelle : 26. Parameter]

{#r_DC-setTimeZone_S__table_avv_nlz_nt} {#r_DC-setTimeZone_S__table_bvv_nlz_nt__entry__2}

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

{#r_DC-setTimeZone_S__table_bvv_nlz_nt}  

    var dc = new DurationCalculator();
    dc.setTimeZone("Los Angeles");


