GlideDateTime – Scoped

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 26 Minuten Lesedauer
  • Die bereichsbezogene GlideDateTime -Klasse stellt Methoden zum Ausführen von Vorgängen an GlideDateTime-Objekten bereit, z. B. Instanziieren von GlideDateTime-Objekten oder Arbeiten mit glide_date_time-Feldern.

    Verwenden Sie die GlideDateTime -Methoden, um Datum/Uhrzeit-Operationen auszuführen, z. B. Instanziieren eines GlideDateTime -Objekts, Ausführen von Datum/Uhrzeit-Berechnungen, Formatieren von Datum/Uhrzeit oder Konvertieren zwischen Datum/Uhrzeit-Formaten.

    Anleitungen zu Datums-/Uhrzeit-Eingabezeichenfolgen mit einer Liste gängiger Formatkonflikte finden Sie unter Richtlinien für Datums- und Zeitformat.

    Scoped GlideDateTime – GlideDateTime()

    Instantiiert ein neues GlideDateTime- Objekt mit dem aktuellen Datum und der aktuellen Uhrzeit.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine

    In diesem Beispiel wird ein GlideDateTime- Objekt instanziiert.

    var gdt = new GlideDateTime();
    gs.info(gdt);

    Ausgabe:

    2022-08-08 16:51:44

    Scoped GlideDateTime – GlideDateTime(String value)

    Instantiiert ein neues GlideDateTime -Objekt mit dem übergebenen Datums- und Uhrzeitwert.

    Das System versucht, den übergebenen Wert mit dem angegebenen internen Systemformat abzugleichen. Wenn das Argument nicht mit dem Systemformat übereinstimmt, versucht das System, es einem der folgenden Formate in der folgenden Reihenfolge zuzuordnen:
    • JJJJ-MM-TT hh:mm:ss
    • MM/tt/jjjj HH:mm:ss
    • MM-TT-JJJJ hh:mm:ss
    • MM-TT-JJJJ HH:mm
    • MM-TT-JJJJ
    • MM/tt/jj HH:mm:ss
    • MM/TT/JJJJ
    • TT-MM-JJJJ hh:mm:ss
    • TT-MM-JJJJ HH.MM.SS
    • TT-MM-JJJJ HH.MM
    • TT-MM-JJ HH:mm:ss
    • TT-MM-JJ HH.MM.SS
    • TT/MM/JJJJ
    • TT-MM-JJJJ
    • jjjj-MM-tt HH:mm
    • JJJJ-MM-TT
    • TT.MM.JJJJ HH:MM:SS
    • TT.MM.JJJJ HH.MM.SS
    • TT.MM.JJJJ hh:mm:ss a
    • TT.MM.JJJJ hh.mm.ss a
    • TT.MM.JJJJ
    Hinweis:
    Das folgende Format wird derzeit nicht unterstützt:
    jjjj-MM-tt'T'HH:mm:ss.SSSZ
    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge UTC-Datum und -Uhrzeit, die im GlideDateTime- Objekt festgelegt werden sollen.
    var gdt = new GlideDateTime("2023-01-01 12:00:00");
    gs.info(gdt);

    Ausgabe:

    2023-01-01 12:00:00

    Scoped GlideDateTime – GlideDateTime(GlideDateTime g)

    Instantiiert ein neues GlideDateTime- Objekt, das auf die Zeit eines angegebenen GlideDateTime- Objekts festgelegt ist.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    g GlideDateTime Objekt, das zum Einstellen der Uhrzeit des neuen Objekts verwendet wird.

    In diesem Beispiel wird ein GlideDateTime -Objekt im Format jjjj-MM-tt'T'HH:mm:ss.SSSZ instanziiert.

    var gdt1 = new GlideDateTime("2023-07-04T12:08:56.235-0700");
    var gdt2 = new GlideDateTime(gdt1);
    gs.info(gdt1);
    gs.info(gdt2);

    Ausgabe:

    2023-07-04 19:08:56
    2023-07-04 19:08:56

    Scoped GlideDateTime – add(GlideTime gd)

    Fügt dem aktuellen GlideDateTime-Objekt ein GlideTime-Objekt hinzu.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    gd GlideTime GlideTime-Objekt, dessen Zeitwert dem angegebenen GlideDateTime-Objekt hinzugefügt werden soll.
    Tabelle : 5. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    var gtime1 = new GlideTime();
    gtime1.setValue("00:00:20");
    gdt.add(gtime1);
    var gtime2 = gdt.getTime();
    gs.info(gtime2.getByFormat('hh:mm:ss'));

    Ausgabe:

    08:00:20

    Scoped GlideDateTime – add(Number milliseconds)

    Fügt dem aktuellen GlideDateTime-Objekt die angegebene Anzahl von Millisekunden hinzu.

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    milliseconds Zahl Die Anzahl der Millisekunden, die hinzugefügt werden sollen.
    Tabelle : 7. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.getNumericValue());
    gdt.add(10);
    gs.info(gdt.getNumericValue());
    Ausgabe:
    1314777600000 1314777600010

    Scoped GlideDateTime – addDaysLocalTime(Number days)

    Fügt eine angegebene Anzahl an Tagen zum aktuellen GlideDateTime-Objekt hinzu. Ein negativer Parameter zieht Tage ab. Die Methode ermittelt das lokale Datum und die lokale Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Tage unter Verwendung der lokalen Datums- und Uhrzeitwerte.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    days Zahl Die Anzahl der Tage, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert.
    Tabelle : 9. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addDaysLocalTime(-1);
    gs.info(gdt.getLocalDate());

    Ausgabe:

    2011-08-30

    Scoped GlideDateTime – addDaysUTC(Number days)

    Fügt eine angegebene Anzahl an Tagen zum aktuellen GlideDateTime-Objekt hinzu. Ein negativer Parameter zieht Tage ab. Die Methode ermittelt das UTC-Datum und die UTC-Zeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Tage unter Verwendung der UTC-Datums- und Uhrzeitwerte.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    days Zahl Die Anzahl der Tage, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren eine negative Zahl.
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addDaysUTC(-1);
    gs.info(gdt.getDate());

    Ausgabe:

     2011-08-30

    Scoped GlideDateTime – addMonthsLocalTime(Number months)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Monaten hinzu. Ein negativer Parameter zieht Monate ab. Die Methode ermittelt das lokale Datum und die lokale Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Monate mit den lokalen Datums- und Uhrzeitwerten.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    months Zahl Die Anzahl der Monate, die hinzugefügt werden sollen. Verwenden Sie zum Abzug einen negativen Wert.
    Tabelle : 13. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addMonthsLocalTime(2);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-10-31

    Scoped GlideDateTime – addMonthsUTC(Number months)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Monaten hinzu. Ein negativer Parameter zieht Monate ab. Die Methode ermittelt das UTC-Datum und die UTC-Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann die Monate mit den UTC-Datums- und -Uhrzeitwerten.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    months Zahl Die Anzahl der Monate, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert.
    Tabelle : 15. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addMonthsUTC(2);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-10-31

    Scoped GlideDateTime – addSeconds(Number seconds)

    Fügt dem aktuellen GlideDateTime-Objekt die angegebene Anzahl von Sekunden hinzu.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    seconds Zahl Die Anzahl der Sekunden, die hinzugefügt werden sollen.
    Tabelle : 17. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-12-07 08:00:00");
    gdt.addSeconds(1000);
    gs.info(gdt.getValue());

    Ausgabe:

    2011-12-07 08:16:40

    Scoped GlideDateTime – addWeeksLocalTime (Number weeks)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Wochen hinzu. Ein negativer Parameter zieht Wochen ab. Die Methode ermittelt das lokale Datum und die lokale Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann die Wochen mit den lokalen Datums- und Uhrzeitwerten.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    weeks Zahl Die Anzahl der Wochen, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert.
    Tabelle : 19. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addWeeksLocalTime(-1);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-08-24

    Scoped GlideDateTime – addWeeksUTC(Number weeks)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Wochen hinzu. Ein negativer Parameter zieht Wochen ab. Die Methode ermittelt das UTC-Datum und die UTC-Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Wochen mit den UTC-Datums- und Uhrzeitwerten.

    Tabelle : 20. Parameter
    Name Typ Beschreibung
    weeks Zahl Die Anzahl der Wochen, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert.
    Tabelle : 21. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addWeeksUTC(-1);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-08-24

    Scoped GlideDateTime – addYearsLocalTime(Number years)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Jahren hinzu. Ein negativer Parameter zieht Jahre ab. Die Methode ermittelt das lokale Datum und die lokale Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann die Jahre mit den lokalen Datums- und Uhrzeitwerten.

    Tabelle : 22. Parameter
    Name Typ Beschreibung
    years Zahl Die Anzahl der Jahre, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert.
    Tabelle : 23. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2010-08-31 08:00:00");
    gdt.addYearsLocalTime(1);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-08-31

    Scoped GlideDateTime – addYearsUTC(Number years)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Jahren hinzu. Ein negativer Parameter zieht Jahre ab. Der Datums- und Uhrzeitwert, der vom GlideDateTime-Objekt gespeichert wird, wird als in der UTC-Zeitzone interpretiert.

    Tabelle : 24. Parameter
    Name Typ Beschreibung
    years Zahl Die Anzahl der Jahre, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert.
    Tabelle : 25. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2010-08-31 08:00:00");
    gdt.addYearsUTC(1);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-08-31

    Scoped GlideDateTime – after(GlideDateTime gdt)

    Bestimmt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts nach dem Datum und der Uhrzeit des angegebenen Objekts liegen.

    Tabelle : 26. Parameter
    Name Typ Beschreibung
    gDT GlideDateTime Datum und Uhrzeit für die Überprüfung.
    Tabelle : 27. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts nach dem durch den Parameter angegebenen Datum und Uhrzeit liegen.
    Mögliche Werte:
    • true: Datum und Uhrzeit des GlideDateTime-Objekts liegen nach dem Datum und der Uhrzeit des angegebenen Objekts.
    • false: Datum und Uhrzeit des GlideDateTime-Objekts liegen vor dem angegebenen Objekt.
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.after(gdt2)); 

    Ausgabe:

    False

    Scoped GlideDateTime – before(GlideDateTime gdt)

    Bestimmt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts vor dem Datum und der Uhrzeit des angegebenen GlideDateTime-Objekts liegen.

    Tabelle : 28. Parameter
    Name Typ Beschreibung
    gDT GlideDateTime Datum und Uhrzeit für die Überprüfung.
    Tabelle : 29. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts vor dem durch den Parameter angegebenen Datum und Uhrzeit liegen.
    Mögliche Werte:
    • true: Datum und Uhrzeit des GlideDateTime-Objekts liegen vor dem angegebenen Datum und der angegebenen Uhrzeit.
    • false: Datum und Uhrzeit des GlideDateTime-Objekts liegen nach dem angegebenen Datum und der angegebenen Uhrzeit oder entsprechen diesem.
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.before(gdt2));  

    Ausgabe

    true

    Scoped GlideDateTime – compareTo(Object o)

    Vergleicht zwei Datums- und Uhrzeitobjekte, um festzustellen, ob sie gleichwertig sind oder vor- oder nacheinander auftreten.

    Tabelle : 30. Parameter
    Name Typ Beschreibung
    o Objekt Datums- und Uhrzeitobjekt im GlideDateTime-Format
    Tabelle : 31. Ergebnisse
    Typ Beschreibung
    Zahl
    • 0 = Daten sind gleich
    • 1 = Das Datum des Objekts liegt nach dem im Parameter angegebenen Datum
    • -1 = Das Datum des Objekts liegt vor dem im Parameter angegebenen Datum
    var initDate = new GlideDateTime("2011-08-01 12:00:00");
    var compDate1 = new GlideDateTime("2011-08-01 12:00:00");
    var compDate2 = new GlideDateTime("2011-07-31 12:00:00");
    var compDate3 = new GlideDateTime("2011-08-04 16:00:00");
     
    gs.info(initDate.compareTo(compDate1)); // Equals (0)
    gs.info(initDate.compareTo(compDate2)); // initDate is after compDate2 (1)
    gs.info(initDate.compareTo(compDate3)); // initDate is before compDate3 (-1)

    Ausgabe:

    0
    1
    -1

    Scoped GlideDateTime – equals(Object dateTime)

    Vergleicht eine Datumszeit mit einem vorhandenen Wert auf Gleichheit.

    Tabelle : 32. Parameter
    Name Typ Beschreibung
    dateTime GlideDateTime-Objekt oder Zeichenfolge Die Datumszeit, die verglichen werden soll.
    Tabelle : 33. Ergebnisse
    Typ Beschreibung
    Boolean Gibt „true“ zurück, wenn sie gleich sind, ansonsten „false“.
    var gdt = new GlideDateTime("2011-08-31 00:00:00");
    gs.info(gdt.equals("2011-09-30 00:12:01"));

    Ausgabe:

    false

    Scoped GlideDateTime – getDate()

    Gibt das vom GlideDateTime-Objekt gespeicherte Datum zurück. Ausgedrückt im Standardformat jjjj-MM-tt und in der Systemzeitzone (standardmäßig GMT).

    Tabelle : 34. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 35. Ergebnisse
    Typ Beschreibung
    Objekt Datum in der Systemzeitzone.
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.getDate());

    Ausgabe:

    2011-08-31

    Scoped GlideDateTime – getDayOfMonthLocalTime()

    Ruft den Tag des Monats ab, der vom GlideDateTime-Objekt gespeichert wird, ausgedrückt in der Zeitzone des aktuellen Benutzers.

    Tabelle : 36. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 37. Ergebnisse
    Typ Beschreibung
    Zahl Der Tag des Monats in der Zeitzone des Benutzers, von 1 bis 31.
    var gdt = new GlideDateTime("2011-12-02 12:00:00");
    gs.info(gdt.getDayOfMonthLocalTime());

    Ausgabe:

    2

    Scoped GlideDateTime – getDayOfMonthUTC()

    Ruft den Tag des Monats ab, der vom GlideDateTime-Objekt gespeichert wird, ausgedrückt in der UTC-Zeitzone.

    Tabelle : 38. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 39. Ergebnisse
    Typ Beschreibung
    Zahl Der Tag des Monats in der UTC-Zeitzone, von 1 bis 31.
    var gdt = new GlideDateTime("2011-12-02 12:00:00");
    gs.info(gdt.getDayOfMonthUTC());

    Ausgabe:

    02

    Scoped GlideDateTime – getDayOfWeekLocalTime()

    Ruft den Wochentag ab, der vom GlideDateTime-Objekt gespeichert wird, ausgedrückt in der Zeitzone des Benutzers.

    Tabelle : 40. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 41. Ergebnisse
    Typ Beschreibung
    Zahl Der Wochentagswert in der Zeitzone des Benutzers von 1 bis 7. Montag entspricht 1, Sonntag entspricht 7.
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//Thursday
    gs.info(gdt.getDayOfWeekLocalTime());

    Ausgabe:

    4

    Scoped GlideDateTime – getDayOfWeekUTC()

    Ruft den Wochentag ab, der vom GlideDateTime-Objekt gespeichert wird, ausgedrückt in der UTC-Zeitzone.

    Tabelle : 42. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 43. Ergebnisse
    Typ Beschreibung
    Zahl Der Wochentagswert von 1 bis 7. Montag entspricht 1, Sonntag entspricht 7.
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//Thursday
    gs.info(gdt.getDayOfWeekLocalTime());

    Ausgabe:

    4

    Scoped GlideDateTime – getDaysInMonthLocalTime()

    Ruft die vom GlideDateTime-Objekt gespeicherte Anzahl von Tagen im Monat ab, die in der Zeitzone des aktuellen Benutzers angegeben ist.

    Tabelle : 44. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 45. Ergebnisse
    Typ Beschreibung
    Zahl Die Anzahl der Tage des aktuellen Monats in der Zeitzone des Benutzers.
    var gdt = new GlideDateTime("2011-12-02 12:00:00"); //December
    gs.info(gdt.getDaysInMonthLocalTime());

    Ausgabe:

    30

    Scoped GlideDateTime – getDaysInMonthUTC()

    Ruft die Anzahl der Tage des Monats ab, die vom GlideDateTime-Objekt gespeichert werden, ausgedrückt in der UTC-Zeitzone.

    Tabelle : 46. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 47. Ergebnisse
    Typ Beschreibung
    Zahl Die Anzahl der Tage im Monat, die vom GlideDateTime-Objekt gespeichert werden, ausgedrückt in der UTC-Zeitzone.
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
    gs.info(gdt.getDaysInMonthUTC());

    Ausgabe:

    30

    Scoped GlideDateTime – getDisplayValue()

    Ruft den Datums- und Uhrzeitwert im Anzeigeformat und in der Zeitzone des aktuellen Benutzers ab.

    Tabelle : 48. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 49. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Datum und Uhrzeit im Format und in der Zeitzone des Benutzers. Denken Sie beim Entwerfen von Business Rules oder Skripteinbindungen daran, dass diese Methode Werte in verschiedenen Formaten für verschiedene Benutzer zurückgeben kann.
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.getDisplayValue()); //uses current user session time zone (US/Pacific)

    Ausgabe:

    2011-08-31 01:00:00

    Scoped GlideDateTime – getDisplayValueInternal()

    Ruft den Anzeigewert im internen Format ab (JJJJ-MM-TT hh:mm:ss).

    Tabelle : 50. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 51. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die Datums- und Uhrzeitwerte für das GlideDateTime-Objekt in der Zeitzone des aktuellen Benutzers und im internen Datums- und Uhrzeitformat JJJJ-MM-TT hh:mm:ss.
    var gdt = new GlideDateTime("2011-08-31 08:00:00"); 
    gs.info(gdt.getDisplayValueInternal()); //uses current user session time zone (US/Pacific)

    Ausgabe:

    2011-08-31 01:00:00

    Scoped GlideDateTime – getDisplayValueLang(String stil, String language)

    Gibt einen Datums- und Uhrzeitwert im Gebietsschema des aktuellen Benutzers gemäß einer angegebenen Sprache und einem angegebenen Datumsstil zurück.

    Tabelle : 52. Parameter
    Name Typ Beschreibung
    -Stil Zeichenfolge Gibt das Datums- und Uhrzeitformat an.
    Gültige Werte:
    • full: Gibt das Datum im Format zurück<weekday, month, day, and year> entsprechend dem Gebietsschema des Benutzers (z. B. Montag, 24. Oktober 2022).
    • long: gibt das Datum im Format zurück<month, day, and year> entsprechend dem Gebietsschema des Benutzers (z. B. 24. Oktober 2022).
    • mittel: ähnlich wie lang, gibt jedoch das Datum mit einem abgekürzten Monat zurück (z. B. 24. Oktober 2022).
    • short: Gibt das Datum im Format MM/TT/JJ oder TT/MM/JJ entsprechend dem Gebietsschema des Benutzers zurück (z. B. 24.10.2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, verwendet die API standardmäßig mittel. Bei akzeptierten Werten wird nicht zwischen Groß- und Kleinschreibung unterschieden.

    language Zeichenfolge Gibt das Datum gemäß einem angegebenen Sprachwert zurück. Akzeptiert Sprach-Tags, die dem BCP-47-Standard entsprechen. Zum Beispiel „fr“ für Französisch oder „en-UK“ für englisches Englisch. Eine vollständige Liste der akzeptierten Werte finden Sie unter BCP 47-Sprachcodeliste.
    Tabelle : 53. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Eine Zeichenfolgendarstellung des Datums im angegebenen Stil und im entsprechenden Format für das Gebietsschema des aktuellen Benutzers.

    Das folgende Beispiel gibt das Datum und die Uhrzeit des Gebietsschemas des Benutzers in allen Sprach- und Datumsstilen zurück.

    var gdt = new GlideDateTime(); // This will fetch the current date
    
    
    gs.info('date: ' + gdt.getDisplayValue());
    
    gs.info('date: ' + gdt.getDisplayValueLang("full", "fr"));
    gs.info('date: ' + gdt.getDisplayValueLang("long", "en-GB"));
    gs.info('date: ' + gdt.getDisplayValueLang("medium", "de"));
    gs.info('date: ' + gdt.getDisplayValueLang("short", "es-MX"));```

    Ausgabe:

    date: 2023-01-18 06:49:02
    mercredi 18 janvier 2023 06:49:02
    18 January 2023 06:49:02
    18.01.2023 06:49:02
    18/01/23 06:49:02

    Scoped GlideDateTime – getDSTOffset()

    Ruft die Zeit ab, um die die Sommerzeit verschoben ist.

    Tabelle : 54. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 55. Ergebnisse
    Typ Beschreibung
    Zahl Zeit in Millisekunden, um die die Sommerzeit verschoben ist. Gibt 0 zurück, wenn die Zeit nicht verschoben ist oder wenn es sich nicht um Sommerzeit handelt.
    var gdt = new GlideDateTime("2014-08-31 08:00:00"); 
    gs.info(gdt.getDSTOffset()); //uses current user session time zone (US/Pacific)

    Ausgabe:

    3600000

    Scoped GlideDateTime – getErrorMsg()

    Ruft die aktuelle Fehlermeldung ab.

    Tabelle : 56. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 57. Ergebnisse
    Typ Beschreibung
    Objekt Die Fehlermeldung.
    var gdt = new GlideDateTime(); 
    gdt.setDisplayValue("2011-aa-01 00:00:00"); 
    gs.info(gdt.getErrorMsg());

    Ausgabe:

    Could not parse DateTime: 2011-aa-01 00:00:00

    Scoped GlideDateTime – getInternalFormattedLocalTime()

    Gibt die Zeit des Objekts in der lokalen Zeitzone und im internen Format zurück.

    Tabelle : 58. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 59. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die Uhrzeit des Objekts in der lokalen Zeitzone und dem internen Format.

    In diesem Beispiel wird die Uhrzeit im Systemzeitformat der Zeitzone des Benutzers angezeigt.

    var gdt = new GlideDateTime('2022-10-08 01:00:00');
    gs.info(gdt.getDisplayValue());
    gs.info(gdt.getInternalFormattedLocalTime());

    Ausgabe

    2022-10-07 06:00:00 PM
    18:00:00

    Scoped GlideDateTime – getLocalDate()

    Ruft das vom GlideDateTime-Objekt gespeicherte Datum ab, das im Standardformat (JJJJ-MM-TT) und in der Zeitzone des aktuellen Benutzers angegeben ist.

    Tabelle : 60. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 61. Ergebnisse
    Typ
    GlideDate Das Datum in der Zeitzone des Benutzers.
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.getLocalDate());

    Ausgabe:

    2011-08-31

    Scope GlideDateTime – getLocalTime()

    Gibt ein GlideTime-Objekt zurück, das den Zeitabschnitt des GlideDateTime-Objekts in der Zeitzone des Benutzers darstellt.

    Tabelle : 62. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 63. Ergebnisse
    Typ Beschreibung
    GlideTime Die Zeit in der Zeitzone des Benutzers.
    var gdt = new GlideDateTime("2014-08-31 08:00:00");
    gt = gdt.getLocalTime();
    gs.info("local time is " + gt.getByFormat('hh:mm:ss'));

    Ausgabe:

    local time is 01:00:00

    Scoped GlideDateTime – getMonthLocalTime()

    Ruft den vom GlideDateTime-Objekt gespeicherten Monat ab, der in der Zeitzone des aktuellen Benutzers angegeben ist.

    Tabelle : 64. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 65. Ergebnisse
    Typ Beschreibung
    Zahl Der numerische Wert des Monats.
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
    gs.info(gdt.getMonthLocalTime());

    Ausgabe:

    11

    Scoped GlideDateTime – getMonthUTC()

    Ruft den vom GlideDateTime-Objekt gespeicherten Monat ab, der in der UTC-Zeitzone angegeben ist.

    Tabelle : 66. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 67. Ergebnisse
    Typ Beschreibung
    Zahl Der numerische Wert des Monats.
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
    gs.info(gdt.getMonthUTC());

    Ausgabe:

    11

    Scoped GlideDateTime – getNumericValue()

    Ruft die Anzahl der Millisekunden seit dem 1. Januar 1970 um 00:00:00 GMT ab.

    Tabelle : 68. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 69. Ergebnisse
    Typ Beschreibung
    Zahl Die Anzahl der Millisekunden seit dem 1. Januar 1970, 00:00:00 GMT.
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.getNumericValue());

    Ausgabe:

    1314777600000

    Scoped GlideDateTime – getTime()

    Gibt ein GlideTime-Objekt zurück, das den Zeitabschnitt des GlideDateTime-Objekts darstellt.

    Tabelle : 70. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 71. Ergebnisse
    Typ Beschreibung
    GlideTime Der Unix-Zeitstempel im Systemformat basierend auf der GMT-Zeit.
    var gdt = new GlideDateTime("2014-08-31 08:00:00");
    gt = gdt.getTime();
    gs.info(gt.getByFormat('hh:mm:ss'));

    Ausgabe:

    08:00:00

    Scoped GlideDateTime – getTZOffset()

    Ruft die Zeitzonenverschiebung in Millisekunden ab.

    Tabelle : 72. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 73. Ergebnisse
    Typ Beschreibung
    Zahl Die Anzahl der Millisekunden der Zeitzonenverschiebung.
    var gdt = new GlideDateTime();
    gdt.getLocalTime(); // PST local time
    gs.info(gdt.getTZOffset());

    Ausgabe:

    -25200000

    Scoped GlideDateTime – getUserFormattedLocalTime()

    Gibt die Zeit des Objekts in der lokalen Zeitzone und im Format des Benutzers zurück.

    Tabelle : 74. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 75. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die Uhrzeit des Objekts in der lokalen Zeitzone und im Format des Benutzers.

    Dieses Beispiel zeigt die Zeit des Objekts in der lokalen Zeitzone.

    var gdt = new GlideDateTime('2022-10-08 01:00:00');
    gs.info(gdt.getDisplayValue());
    gs.info(gdt.getUserFormattedLocalTime());

    Ausgabe:

    2022-10-07 06:00:00 PM
    06:00:00 PM

    Scoped GlideDateTime – getValue()

    Gibt den Datums- und Uhrzeitwert zurück, der vom GlideDateTime-Objekt im internen Format jjjj-MM-tt HH:mm:ss in der UTC-Zeitzone gespeichert wird.

    Tabelle : 76. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 77. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Datum und Uhrzeit im internen Format und in der Systemzeitzone.

    Format: jjjj-MM-tt HH:mm:ss in der UTC-Zeitzone.

    var gdt = new GlideDateTime("2014-08-31 08:00:00");
    gs.info(gdt.getValue());

    Ausgabe:

    2014-08-31 08:00:00

    Scoped GlideDateTime – getWeekOfYearLocalTime()

    Ruft die im GlideDateTime-Objekt gespeicherte Nummer der Woche ab, die in der Zeitzone des aktuellen Benutzers angegeben ist.

    Alle Wochen beginnen am Sonntag. Die erste Woche des Jahres ist die Woche, die mindestens einen Tag des neuen Jahres enthält. Die Woche, die am Sonntag 2015-12-27 beginnt, gilt als erste Woche des Jahres 2016, da diese Woche den 1. und 2. Januar enthält.

    Tabelle : 78. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 79. Ergebnisse
    Typ Beschreibung
    Zahl Die Nummer der aktuellen Woche. Die höchste Wochennummer pro Jahr beträgt entweder 52 oder 53.
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in december 
    gs.info(gdt.getWeekOfYearLocalTime());

    Ausgabe:

    49

    Scoped GlideDateTime – getWeekOfYearUTC()

    Ruft die Zahl der Woche ab, die vom GlideDateTime-Objekt gespeichert wird, ausgedrückt in der UTC-Zeitzone.

    Alle Wochen beginnen am Sonntag. Die erste Woche des Jahres ist die Woche, die mindestens einen Tag des neuen Jahres enthält. Die Woche, die am Sonntag 2015-12-27 beginnt, gilt als erste Woche des Jahres 2016, da diese Woche den 1. und 2. Januar enthält.

    Tabelle : 80. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 81. Ergebnisse
    Typ Beschreibung
    Zahl Die Nummer der aktuellen Woche in UTC-Zeit. Die höchste Wochennummer pro Jahr beträgt entweder 52 oder 53.
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in December 
    gs.info(gdt.getWeekOfYearUTC());

    Ausgabe:

    49

    Scoped GlideDateTime – getYearLocalTime()

    Ruft das vom GlideDateTime-Objekt gespeicherte Jahr ab, ausgedrückt in der Zeitzone des aktuellen Benutzers.

    Tabelle : 82. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 83. Ergebnisse
    Typ Beschreibung
    Zahl Vierstellige Jahreszahl in der Zeitzone des Benutzers.
    var gdt = new GlideDateTime("2011-11-02 12:00:00");
    gs.info(gdt.getYearLocalTime());

    Ausgabe:

    2011

    Scoped GlideDateTime – getYearUTC()

    Ruft das vom GlideDateTime-Objekt gespeicherte Jahr ab, das in der UTC-Zeitzone angegeben wird.

    Tabelle : 84. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 85. Ergebnisse
    Typ Beschreibung
    Zahl Vierstelliger Jahreswert in der UTC-Zeitzone.
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); 
    gs.info(gdt.getYearUTC());

    Ausgabe:

    2011

    Scoped GlideDateTime – hasDate()

    Bestimmt, ob das Datum eines Objekts festgelegt ist.

    Tabelle : 86. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 87. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn das Objektdatum eingestellt ist. Andernfalls wird „false“ zurückgegeben.
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.hasDate());

    Ausgabe:

    true

    Scoped GlideDateTime – isDST()

    Bestimmt, ob die Zeit eines Objekts eine Sommerzeitverschiebung verwendet.

    Tabelle : 88. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 89. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn die Zeit Sommerzeit ist. Andernfalls wird „false“ zurückgegeben.
    var gdt = new GlideDateTime("2014-08-31 00:00:00");
    gs.info(gdt.isDST()); //true

    Ausgabe:

    var gdt = new GlideDateTime("2014-08-31 00:00:00");
    gs.info(gdt.isDST()); //true

    Scoped GlideDateTime – isValid()

    Bestimmt, ob ein Wert ein gültiges Datum und eine gültige Uhrzeit ist.

    Tabelle : 90. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 91. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn Wert gültig ist, andernfalls wird „false“ zurückgegeben.
    var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); 
    gs.info(gdt.isValid()); //true
    gs.info(gdt.getErrorMsg()); //reason

    Ausgabe:

    false
    Invalid date time: '2011-aa-31 aa:00:00', ignored

    Scoped GlideDateTime – onOrAfter(GlideDateTime gdt)

    Bestimmt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts am oder nach dem Datum und der Uhrzeit des angegebenen GlideDateTime-Objekts liegen.

    Tabelle : 92. Parameter
    Name Typ Beschreibung
    gDT GlideDateTime Datum und Uhrzeit für die Überprüfung.
    Tabelle : 93. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts am oder nach dem durch den Parameter angegebenen Datum und Uhrzeit liegen.
    Mögliche Werte:
    • true: Datum und Uhrzeit des GlideDateTime-Objekts liegen am oder nach dem Datum und der Uhrzeit des angegebenen Objekts.
    • false: Datum und Uhrzeit des GlideDateTime-Objekts liegen vor dem Datum und der Uhrzeit des angegebenen Objekts.
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.onOrAfter(gdt2));   

    Ausgabe

    false

    Scoped GlideDateTime – onOrBefore(GlideDateTime gdt)

    Bestimmt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts am oder vor dem Datum und der Uhrzeit des angegebenen GlideDateTime-Objekts liegen.

    Tabelle : 94. Parameter
    Name Typ Beschreibung
    gDT GlideDateTime Datum und Uhrzeit für die Überprüfung.
    Tabelle : 95. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts am oder vor dem durch den Parameter angegebenen Datum und Uhrzeit liegen.
    Mögliche Werte:
    • true: Datum und Uhrzeit des GlideDateTime-Objekts liegen am oder vor dem Datum und der Uhrzeit des angegebenen Objekts.
    • false: Datum und Uhrzeit des GlideDateTime-Objekts liegen nach dem Datum und der Uhrzeit des angegebenen Objekts.
    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.onOrBefore(gdt2));   

    Ausgabe

    true

    Scoped GlideDateTime – setDayOfMonthLocalTime(Number day)

    Legt den Tag des Monats auf einen angegebenen Wert in der Zeitzone des aktuellen Benutzers fest.

    Tabelle : 96. Parameter
    Name Typ Beschreibung
    day Zahl Der Tag des Monats, zu dem Sie wechseln möchten, von 1 bis 31. Wenn dieser Wert die maximale Anzahl von Tagen im Monat überschreitet, wird der Wert auf den letzten Tag des Monats festgelegt.
    Tabelle : 97. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setDayOfMonthLocalTime(9);
    gs.info(gdt.getDayOfMonthLocalTime());

    Ausgabe:

    9

    Scoped GlideDateTime – setDayOfMonthUTC(Number day)

    Legt den Tag des Monats auf einen angegebenen Wert in der UTC-Zeitzone fest.

    Tabelle : 98. Parameter
    Name Typ Beschreibung
    day Zahl Der Tag des Monats, zu dem Sie wechseln möchten, von 1 bis 31. Wenn dieser Wert die maximale Anzahl von Tagen im Monat überschreitet, wird der Wert auf den letzten Tag des Monats festgelegt.
    Tabelle : 99. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setDayOfMonthUTC(9);
    gs.info(gdt.getDayOfMonthUTC());

    Ausgabe:

    9

    Scoped GlideDateTime – setDisplayValue(String asDisplayed)

    Legt einen Datums- und Uhrzeitwert unter Verwendung des Anzeigeformats und der Zeitzone des aktuellen Benutzers fest.

    Tabelle : 100. Parameter
    Name Typ Beschreibung
    asDisplayed Zeichenfolge Datum und Uhrzeit im Anzeigeformat und in der Zeitzone des aktuellen Benutzers. Der Parameter muss mit dem bevorzugten Anzeigeformat des aktuellen Benutzers formatiert werden, z. B. MM-TT-JJJJ hh:mm:ss. Um das aktuelle Datum und die aktuelle Uhrzeit einer Variablen in einem Workflow-Skript zuzuweisen, verwenden Sie die Variable .setDisplayValue(gs.nowDateTime);.
    Tabelle : 101. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2014-02-02 12:00:00");
    gdt.setDisplayValue("2014-01-01 12:00:00");//uses current user session time zone (US/Pacific) 
    gs.info(gdt.getValue());

    Ausgabe:

    2014-01-01 20:00:00

    Scoped GlideDateTime – setDisplayValue(String value, String format)

    Legt einen Datums- und Uhrzeitwert unter Verwendung der Zeitzone des aktuellen Benutzers und des angegebenen Datums- und Uhrzeitformats fest.

    Diese Methode löst eine Laufzeitausnahme aus, wenn das im Parameter value verwendete Datums- und Zeitformat nicht mit dem Parameter format übereinstimmt. Sie können die Fehlermeldung durch Aufrufen von getErrorMsg() für das GlideDateTime-Objekt abrufen, nachdem die Ausnahme abgefangen wurde.

    Tabelle : 102. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge Datum und Uhrzeit in der Zeitzone des aktuellen Benutzers.
    format Zeichenfolge Datums- und Uhrzeitformat, das zum Analysieren des Parameters value verwendet werden soll.
    Verwenden Sie die folgenden Werte, um den Parameter value zu beschreiben:
    • dd: Tag des Monats
    • MM: Monat des Jahres
    • jjjj: Jahr
    • HH: Stunde
    • mm: Minuten
    • ss: Sekunden

    Beispiel: „TT-MM-JJJJ HH:MM:SS“ oder „MM-TT-JJJJ HH:MM“.

    Tabelle : 103. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-02-02 12:00:00");
    gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss"); //uses current user session time zone
    gs.info(gdt.getValue());

    Ausgabe

    "20-05-2011 12:00:00"

    Scoped GlideDateTime – setDisplayValueInternal(String value)

    Legt einen Datums- und Zeitwert mit dem internen Format (JJJJ-MM-TT hh:mm:ss) und der Zeitzone des aktuellen Benutzers fest.

    Tabelle : 104. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge Datum und Uhrzeit im internen Format.
    Tabelle : 105. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2014-02-02 12:00:00");
    gdt.setDisplayValueInternal("2014-01-01 12:00:00"); //uses current user session time zone (US/Pacific)
    gs.info(gdt.getValue());

    Ausgabe:

    2014-01-01 20:00:00

    Scoped GlideDateTime – setDisplayValueLang(String dateTime, String Style)

    Legt ein Datum und eine Uhrzeit mit einem angegebenen Stil und Format entsprechend dem Gebietsschema des aktuellen Benutzers fest.

    Tabelle : 106. Parameter
    Name Typ Beschreibung
    dateTime Zeichenfolge Datums- und Uhrzeitwert für das GlideDate-Objekt in der Zeitzone des aktuellen Benutzers. Gültige Werte sind alle Datums- und Uhrzeitausgaben der Funktion getDisplayValueLang().

    Wenn Sie beispielsweise die Ausgabe aus dem Beispiel getDisplayValueLang(String Style, String Language) weiter oben in diesem Thema verwenden, sind 28. November 2022 07:03:41 oder 28.11.2022 07:03:41 akzeptierte Werte.

    -Stil Zeichenfolge Gibt das Datumsformat an.
    Gültige Werte:
    • full: Gibt das Datum im Format zurück<weekday, month, day, and year> entsprechend dem Gebietsschema des Benutzers (z. B. Montag, 24. Oktober 2022).
    • long: gibt das Datum im Format zurück<month, day, and year> entsprechend dem Gebietsschema des Benutzers (z. B. 24. Oktober 2022).
    • mittel: ähnlich wie lang, gibt jedoch das Datum mit einem abgekürzten Monat zurück (z. B. 24. Oktober 2022).
    • short: Gibt das Datum im Format MM/TT/JJ oder TT/MM/JJ entsprechend dem Gebietsschema des Benutzers zurück (z. B. 24.10.2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, verwendet die API standardmäßig mittel. Bei akzeptierten Werten wird nicht zwischen Groß- und Kleinschreibung unterschieden.

    Tabelle : 107. Ergebnisse
    Typ Beschreibung
    void

    Im folgenden Beispiel werden Datum und Uhrzeit in Kurzform und Vollformat zurückgegeben.

    var glideDateFR = new GlideDateTime();
    
    glideDateTime.setDisplayValueLang("2/3/2023 17:27:56", "short");
    
    gs.info('date: ' + glideDateTime.getDisplayValue());
    gs.info('date: ' + glideDateTime.getDisplayValueLang("full"));

    Ausgabe:

    date: 2023-02-03 17:27:56
    date: Friday, February 3, 2023 17:27:56

    Scoped GlideDateTime – setDisplayValueLang(String dateTime, String stil, String language)

    Legt ein Datum und eine Uhrzeit mit einem angegebenen Stil, einer Sprache und einem Format entsprechend dem Gebietsschema des aktuellen Benutzers fest.

    Tabelle : 108. Parameter
    Name Typ Beschreibung
    dateTime Zeichenfolge Datums- und Uhrzeitwert für das GlideDate-Objekt in der Zeitzone des aktuellen Benutzers. Gültige Werte sind alle Datums- und Uhrzeitausgaben der Funktion getDisplayValueLang().

    Wenn Sie beispielsweise die Ausgabe aus dem Beispiel getDisplayValueLang(String Style, String Language) weiter oben in diesem Thema verwenden, sind 28. November 2022 07:03:41 oder 28.11.2022 07:03:41 akzeptierte Werte.

    -Stil Zeichenfolge Gibt das Datumsformat an.
    Gültige Werte:
    • full: Gibt das Datum im Format zurück<weekday, month, day, and year> entsprechend dem Gebietsschema des Benutzers (z. B. Montag, 24. Oktober 2022).
    • long: gibt das Datum im Format zurück<month, day, and year> entsprechend dem Gebietsschema des Benutzers (z. B. 24. Oktober 2022).
    • mittel: ähnlich wie lang, gibt jedoch das Datum mit einem abgekürzten Monat zurück (z. B. 24. Oktober 2022).
    • short: Gibt das Datum im Format MM/TT/JJ oder TT/MM/JJ entsprechend dem Gebietsschema des Benutzers zurück (z. B. 24.10.2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, verwendet die API standardmäßig mittel. Bei akzeptierten Werten wird nicht zwischen Groß- und Kleinschreibung unterschieden.

    language Zeichenfolge Legt die Sprache mithilfe eines Sprach-Tags fest, das dem BCP-47-Standard entspricht. Zum Beispiel „fr“ für Französisch oder „en-UK“ für englisches Englisch. Eine vollständige Liste der akzeptierten Werte finden Sie unter BCP 47-Sprachcodeliste.
    Tabelle : 109. Ergebnisse
    Typ Beschreibung
    void

    Im folgenden Beispiel werden Datum und Uhrzeit in Kurz- und Vollformat für Englisch und Französisch zurückgegeben.

    var glideDateFR = new GlideDateTime(); 
    
    glideDateUS.setDisplayValueLang("2/3/2023 18:00:00", "short", "en-US" );
    glideDateFR.setDisplayValueLang("2/3/2023 18:00:00", "short", "fr-FR" );
    
    gs.info('en-US date: ' + glideDateUS.getDisplayValue());
    gs.info('en-US date: ' + glideDateUS.getDisplayValueLang("full"));
    
    gs.info('fr-FR date: ' + glideDateFR.getDisplayValue());
    gs.info('fr-FR date: ' + glideDateFR.getDisplayValueLang("full"));

    Ausgabe:

    en-US date: 2023-02-03 18:00:00
    en-US date: Friday, February 3, 2023 18:00:00
    fr-FR date: 2023-03-02 18:00:00
    fr-FR date: Thursday, March 2, 2023 18:00:00

    Scoped GlideDateTime – setGlideDateTime(GlideDateTime g)

    Legt das Datum und die Uhrzeit des aktuellen Objekts mit einem vorhandenen GlideDateTime-Objekt fest. Diese Methode entspricht der Instantiierung eines neuen Objekts mit einem GlideDateTime-Parameter.

    Tabelle : 110. Parameter
    Name Typ Beschreibung
    g GlideDateTime Das Objekt, das zum Festlegen des datetime-Werts verwendet wird.
    Tabelle : 111. Ergebnisse
    Typ Beschreibung
    Keine
    var dt1 = new GlideDateTime("2011-01-01 12:00:00");
    var dt2 = new GlideDateTime("2011-02-02 08:00:00");
    dt1.setGlideDateTime(dt2);
    gs.info(dt1.getValue());

    Ausgabe:

    2011-02-02 08:00:00

    Scoped GlideDateTime – setMonthLocalTime(Number month)

    Legt den vom GlideDateTime-Objekt gespeicherten Monat mit der Zeitzone des aktuellen Benutzers auf den angegebenen Wert fest.

    Tabelle : 112. Parameter
    Name Typ Beschreibung
    month Zahl Der Monat, zu dem Sie wechseln möchten
    Tabelle : 113. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setMonthLocalTime(1);
    gs.info(gdt.getMonthLocalTime());

    Ausgabe:

    1

    Scoped GlideDateTime – setMonthUTC(Number month)

    Legt den vom GlideDateTime-Objekt gespeicherten Monat unter Verwendung der UTC-Zeitzone auf den angegebenen Wert fest.

    Tabelle : 114. Parameter
    Name Typ Beschreibung
    month Zahl Der Monat, zu dem Sie wechseln möchten
    Tabelle : 115. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setMonthUTC(1);
    gs.info(gdt.getMonthUTC());

    Ausgabe:

    1

    Scoped GlideDateTime – setValue(String o)

    Legt das Datum und die Uhrzeit des GlideDateTime-Objekts fest.

    Tabelle : 116. Parameter
    Name Typ Beschreibung
    o Zeichenfolge Das Datum und die Uhrzeit, die verwendet werden sollen. Dieser Parameter kann einer von mehreren Typen sein:
    • Eine Zeichenfolge in der UTC-Zeitzone und dem internen Format JJJJ-MM-TT hh:mm:ss. Legt den Wert des Objekts auf das angegebene Datum und die Uhrzeit fest. Die Verwendung der Methode auf diese Weise entspricht der Instantiierung eines neuen GlideDateTime-Objekts mit dem GlideDateTime(String-Wert)-Konstruktor. Wenn das verwendete Datums- und Uhrzeitformat nicht mit dem internen Format übereinstimmt, versucht die Methode, Datum und Uhrzeit unter Verwendung anderer verfügbarer Formate einzustellen. Werden Datum und Uhrzeit auf diese Art aufgelöst, kann es aufgrund von Mehrdeutigkeiten in den Tages- und Monatswerten zu ungenauen Daten kommen. Wenn Sie ein nicht standardmäßiges Datums- und Zeitformat verwenden, verwenden Sie stattdessen setValueUTC(String dt, String format).
    • Ein GlideDateTime-Objekt. Legt den Wert des Objekts auf das Datum und die Uhrzeit fest, die von der im Parameter übergebenen GlideDateTime gespeichert werden. Die Verwendung der Methode auf diese Weise entspricht der Instanziierung eines neuen GlideDateTime-Objekts mit dem GlideDateTime(GlideDateTime g)-Konstruktor.
    • Eine JavaScript-Zahl. Legt den Wert des Objekts unter Verwendung des Zahlenwerts in Millisekunden nach dem 1. Januar 1970 um 00:00:00 UTC fest.
    Tabelle : 117. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-01-01 12:00:00");
    gdt.setValue("2011-02-02 08:00:00");  // value set =  2011-02-02 08:00:00
    gs.info(gdt.getValue());

    Ausgabe:

    2011-02-02 08:00:00

    Scoped GlideDateTime – setValueUTC(String dt, String format)

    Legt einen Datums- und Uhrzeitwert unter Verwendung der UTC-Zeitzone und des angegebenen Datums- und Uhrzeitformats fest. Diese Methode löst eine Laufzeitausnahme aus, wenn das im Parameter dt verwendete Datums- und Zeitformat nicht mit dem Parameter format übereinstimmt. Sie können die Fehlermeldung durch Aufrufen von getErrorMsg() für das GlideDateTime-Objekt abrufen, nachdem die Ausnahme abgefangen wurde.

    Tabelle : 118. Parameter
    Name Typ Beschreibung
    dt Zeichenfolge Das Datum und die Uhrzeit, die verwendet werden sollen.
    format Zeichenfolge Das Datums- und Uhrzeitformat, das verwendet werden soll.
    Tabelle : 119. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-01-01 12:00:00");
    gdt.setValueUTC("15-02-2011 08:00:00", "dd-MM-yyyy HH:mm:ss");
    gs.info(gdt.getValue());

    Ausgabe:

    2011-02-15 08:00:00

    Scoped GlideDateTime – setYearLocalTime(Number year)

    Legt das vom GlideDateTime-Objekt gespeicherte Jahr unter Verwendung der Zeitzone des aktuellen Benutzers auf den angegebenen Wert fest.

    Tabelle : 120. Parameter
    Name Typ Beschreibung
    year Zahl Das Jahr, zu dem Sie wechseln möchten.
    Tabelle : 121. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setYearLocalTime(2013);
    gs.info(gdt.getYearLocalTime());

    Ausgabe:

    2013

    Scoped GlideDateTime – setYearUTC(Number year)

    Legt das vom GlideDateTime-Objekt gespeicherte Jahr unter Verwendung der UTC-Zeitzone auf den angegebenen Wert fest.

    Tabelle : 122. Parameter
    Name Typ Beschreibung
    year Zahl Das Jahr, zu dem Sie wechseln möchten.
    Tabelle : 123. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setYearUTC(2013);
    gs.info(gdt.getYearUTC());

    Ausgabe:

    2013

    Scoped GlideDateTime – subtract(GlideTime time)

    Subtrahiert eine bestimmte Zeit vom aktuellen GlideDateTime-Objekt.

    Tabelle : 124. Parameter
    Name Typ Beschreibung
    time GlideTime Der Zeitwert, der abgezogen werden soll.
    Tabelle : 125. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    var gtime1 = new GlideTime();
    gtime1.setValue("00:00:20");
    gdt.subtract(gtime1);
    var gtime2 = gdt.getTime();
    gs.info(gtime2.getByFormat('hh:mm:ss'));

    Ausgabe:

    07:59:40

    Scoped GlideDateTime – subtract(Number milliseconds)

    Subtrahiert die angegebene Anzahl von Millisekunden vom GlideDateTime-Objekt.

    Tabelle : 126. Parameter
    Name Typ Beschreibung
    milliseconds Nummer Anzahl der Millisekunden, die abgezogen werden sollen.
    Tabelle : 127. Ergebnisse
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-12-07 08:00:00");
    gdt.subtract(1000);
    gs.info(gdt.getValue());

    Ausgabe:

    2011-12-07 07:59:59

    Scoped GlideDateTime – subtract(GlideDateTime start, GlideDateTime end)

    Gibt die Dauerdifferenz zwischen zwei angegebenen GlideDateTime-Objekten zurück.

    Tabelle : 128. Parameter
    Name Typ Beschreibung
    Start GlideDateTime Startdatumsobjekt.
    Ende GlideDateTime Enddatumsobjekt.
    Tabelle : 129. Ergebnisse
    Typ Beschreibung
    GlideDuration Dauerunterschied zwischen den beiden angegebenen Daten.
    var gdt1 = new GlideDateTime("2011-08-28 09:00:00");
    var gdt2 = new GlideDateTime("2011-08-31 08:00:00");
     
    var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2
    gs.info(dur.getDisplayValue());

    Ausgabe:

    2 Days 23 Hours

    Scoped GlideDateTime – toString()

    Ruft den Datums- und Uhrzeitwert ab, der vom GlideDateTime-Objekt im internen Format (JJJJJ-MM-TT hh:mm:ss) und der Systemzeitzone UTC (standardmäßig) gespeichert wird. Diese Methode entspricht getValue().

    Tabelle : 130. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 131. Ergebnisse
    Typ
    Zeichenfolge Das Datum und die Uhrzeit, die vom GlideDateTime-Objekt in der Systemzeitzone und im Systemformat gespeichert werden.
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.toString());

    Ausgabe:

    2011-08-31 08:00:00