GlideDuration – Scoped

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

    • Die GlideDuration -Klasse stellt Methoden zum Arbeiten mit Zeitspannen bereit, die als Dauer bezeichnet werden.

    GlideDuration-Objekte speichern die Dauer als Anzahl der Tage und Uhrzeit ab dem 1. Januar 1970, 00:00:00. setValue() und getValue() verwenden daher das GlideDateTime-Objekt für Parameter und Rückgabewerte.

    Scoped GlideDuration – add(GlideDuration duration)

    Fügt die Dauer des angegebenen GlideDuration-Objekts dem aktuellen GlideDuration-Objekt hinzu.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    duration GlideDuration GlideDuration-Objekt, das den Dauerwert enthält, der dem aktuellen GlideDuration-Objekt hinzugefügt werden soll.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    GlideDuration Neues GlideDuration-Objekt, dessen Dauer die Summe der Dauer der beiden GlideDuration-Objekte ist. 
    var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.add(duration2);
gs.info(answer.getDisplayValue());

    Ausgabe:

    3 Days 15 Hours

    Scoped GlideDuration – getByFormat(String format)

    Gibt den Wert für die Dauer im angegebenen Format zurück.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    format Zeichenfolge Dauerformat.

    Format: Globales Format für Datums- und Zeitfelder
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Aktuelle Dauer im angegebenen Format. 
    var dur = new GlideDuration('3 22:00:00');
gs.info(dur.getByFormat('HH:mm'));

    Ausgabe

    22:00

    Scoped GlideDuration – getDayPart()

    Gibt die Anzahl der Tage zurück.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Nummer Anzahl der Tage in der Dauer. 
    var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getDayPart());

    Ausgabe

    3

    Scoped GlideDuration – getDisplayValue()

    Gibt den Anzeigewert der Dauer in Tagen, Stunden und Minuten zurück.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Anzahl der Tage, Stunden und Minuten, z. B. 2 Tage 10 Stunden 36 Minuten.

    Format: Anzeigewert: „n“ Tage, „n“ Stunden, „n“ Minuten

    		 
    var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getDisplayValue());

    Ausgabe

    3 Days 12 Hours

    Scoped GlideDuration – GlideDuration()

    Instantiiert ein GlideDuration-Objekt.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine

    Scoped GlideDuration – getDurationValue()

    Gibt den Dauerwert im Format „d HH:mm:ss“ zurück.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Dauerwert.

    Format: d HH:mm:ss, wobei „d“ die Anzahl der Tage ist.

    		 
    var dur = new GlideDuration(60000);
gs.info(dur.getDurationValue());

    Ausgabe

    00:01:00

    Scoped GlideDuration – getRoundedDayPart()

    Gibt die gerundete Anzahl von Tagen zurück. Wenn der Zeitabschnitt mehr als 12 Stunden beträgt, wird der Rückgabewert aufgerundet. Ansonsten wird er abgerundet.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 13. Ergebnisse
    Typ Beschreibung
    Nummer Tageswert des Anzeigewerts gerundet. 
    var dur = new GlideDuration('3 14:00:00');
gs.info(dur.getRoundedDayPart());

    Ausgabe

    4

    Scoped GlideDuration – getValue()

    Gibt den internen Datums-/Uhrzeitwert des aktuellen GlideDuration-Objekts zurück.

    GlideDuration-Objekte speichern die Dauer als Datum und Uhrzeit ab dem 1. Januar 1970 um 00:00:00 Uhr.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 15. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Aktuelle Dauer innerhalb des GlideDuration-Objekts.

    Format: JJJJ-MM-TT HH:mm:ss

    		 
    var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getValue());
    Ausgabe:
    1970-01-04 12:00:00

    Scoped GlideDuration – GlideDuration(GlideDuration another)

    Instanziiert ein GlideDuration-Objekt, indem die Werte des übergebenen GlideDuration-Objekts geklont werden.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    another GlideDuration GlideDuration-Objekt. 
    var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration(duration);
gs.info(duration2.getDisplayValue());

    Ausgabe

    3 Days 12 Hours

    Scoped GlideDuration – GlideDuration(Number milliseconds)

    Instantiiert ein GlideDuration-Objekt mit der angegebenen Dauer in Millisekunden.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    milliseconds Nummer Dauerwert.

    Einheit: Millisekunden

    		 
    var dur = new GlideDuration(60000);
gs.info(dur.getDurationValue());

    Ausgabe

    00:01:00

    Scoped GlideDuration – GlideDuration(String displayValue)

    Instantiiert ein GlideDuration-Objekt mit dem angegebenen Anzeigewert für die Dauer.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    displayValue Zeichenfolge Dauerwert.

    Format: d HH:mm:ss, wobei „d“ die Anzahl der Tage ist.

    		 
    var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.add(duration2);
gs.info(answer.getDisplayValue());

    Ausgabe

    3 Days 15 Hours

    Scoped GlideDuration – setDisplayValue(String asDisplayed)

    Legt den Anzeigewert für die Dauer fest.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    asDisplayed Zeichenfolge Festzulegender Wert für die Anzeigedauer.

    Format: d HH:mm:ss, wobei „d“ die Anzahl der Tage ist
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    Keine 
    var dur = new GlideDuration(); 
dur.setDisplayValue('3 08:00:00');
gs.info(dur.getDisplayValue());

    Ausgabe

    3 Days 8 Hours

    Scoped GlideDuration – setValue(Object o)

    Legt den internen Datums-/Uhrzeitwert des GlideDuration-Objekts fest.

    Die Methode legt den Wert für die Dauer auf die Differenz des übergebenen Datums/der übergebenen Uhrzeit zum Basisdatum/-zeitwert vom 1. Januar 1970, 00:00:00 fest. Das übergebene Datums-/Uhrzeitobjekt (Zeichenfolge) wird in ein GlideDateTime-Objekt analysiert.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    o Objekt Datum und Uhrzeit, die als Endpunkt für die berechnete Dauer verwendet werden sollen.

    Format: JJJJ-MM-TT HH:mm:ss
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Keine 
    var dur = new GlideDuration();
dur.setValue('1970-01-05 08:00:00'); // sets internal DateTime value. The String is parsed into a GlideDateTime object.
gs.info(dur.getDisplayValue());
    Ausgabe:
    4 Days 8 Hours

    Scoped GlideDuration – subtract(GlideDuration duration)

    Subtrahiert die Dauer des angegebenen GlideDuration-Objekts vom aktuellen GlideDuration-Objekt.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    duration GlideDuration GlideDuration-Objekt, das den Dauerwert enthält, der vom aktuellen GlideDuration-Objekt subtrahiert werden soll.
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    GlideDuration Neues GlideDuration-Objekt, dessen Dauer das Ergebnis der Subtraktion der Dauer der beiden GlideDuration-Objekte enthält. 
    var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.subtract(duration2);
gs.info(answer.getDisplayValue());
    Ausgabe:
    3 Days 9 Hours