GlideDateTime : Bereichsbezogen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 26 Minuten Lesedauer
  • Die bereichsbezogene GlideDateTime- Klasse bietet Methoden zum Ausführen von Vorgängen für GlideDateTime-Objekte.

    Verwenden Sie die GlideDateTime -Methoden für Datum/Uhrzeit-Vorgänge, z. B. das Instanziieren eines GlideDateTime-Objekts, Datum/Uhrzeit-Berechnungen, Formatieren von Datum/Uhrzeit oder Konvertieren zwischen Datum/Uhrzeit-Formaten.

    Anleitungen zu Datums-/Uhrzeiteingabezeichenfolgen mit einer Liste häufiger Formatkonflikte finden Sie unter Richtlinien für das Datums- und Uhrzeitformat.

    Scoped GlideDateTime – GlideDateTime()

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

    Instanziiert ein neues GlideDateTime- Objekt anhand des übergebenen Datums- und Uhrzeitwerts.

    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 dieser 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/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/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 nicht unterstützt:
    • jjjj-MM-tt'T'HH:mm:ss.SSANZ
    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge UTC-Datum und -Uhrzeit, die im GlideDateTime- Objekt festgelegt werden sollen.

    In diesem Beispiel wird gezeigt, wie ein GlideDateTime- Objekt mithilfe einer Zeichenfolge instanziiert wird.

    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)

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

    Dieses Beispiel zeigt, wie ein GlideDateTime- Objekt (gdt1) mit einer Zeichenfolge im Format jjjj-MM-tt HH:mm:ssund ein zweites GlideDateTime- Objekt (gdt2) mit gdt1 instanziiert werden.

    var gdt1 = new GlideDateTime("2025-01-28 12:00:00"); // GlideDateTime(String g)
    var gdt2 = new GlideDateTime(gdt1); // GlideDateTime(GlideDateTime g)
    gs.info(gdt1);
    gs.info(gdt2);

    Ausgabe:

    2025-01-28 12:00:00
    2025-01-28 12:00:00

    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 zum angegebenen GlideDateTime-Objekt addiert werden soll.
    Tabelle : 5. Rückgaben
    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 den Abgleich.
    Tabelle : 27. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts nach dem vom Parameter angegebenen Datum und der angegebenen Uhrzeit liegen.
    Mögliche Werte:
    • „wahr“: Datum und Uhrzeit des GlideDateTime-Objekts liegen nach dem Datum und der Uhrzeit des angegebenen Objekts.
    • „falsch“: Datum und Uhrzeit des GlideDateTime-Objekts liegen vor dem Datum und der Uhrzeit des angegebenen Objekts oder sind gleich diesem.
    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 den Abgleich.
    Tabelle : 29. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts vor dem vom Parameter angegebenen Datum und Uhrzeit liegen.
    Mögliche Werte:
    • „wahr“: 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 sind gleich 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 Zeitzone des Systems (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()

    Gibt den vom GlideDateTime-Objekt gespeicherten Wochentag zurück, ausgedrückt in der UTC-Zeitzone.

    Tabelle : 42. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 43. Ergebnisse
    Typ Beschreibung
    Nummer 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.getDayOfWeekUTC());

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

    Bereichsbezogene GlideDateTime - getDisplayValueLang(Zeichenfolgenstil, Zeichenfolgensprache)

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

    Tabelle : 52. Parameter
    Name Typ Beschreibung
    Stil Zeichenfolge Gibt das Format für Datum und Uhrzeit an.
    Gültige Werte:
    • full: gibt das Datum im Format zurück<weekday, month, day, and year> je nach Gebietsschema des Anwenders (z. B. Montag, 24. Oktober 2022).
    • lang: gibt das Datum im Format zurück<month, day, and year> je nach Gebietsschema des Anwenders (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 Anwenders 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 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 Britisches Englisch. Eine vollständige Liste der akzeptierten Werte finden Sie unter BCP 47-Sprachcodeliste.
    Tabelle : 53. Rückgaben
    Typ Beschreibung
    Zeichenfolge Eine Zeichenfolgendarstellung des Datums im angegebenen Stil und im entsprechenden Format für das Gebietsschema des aktuellen Anwenders.

    Im folgenden Beispiel werden Datum und Uhrzeit des Gebietsschemas des Anwenders in allen Sprach- und Datumsstilen zurückgegeben.

    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 Anwenders 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 Uhrzeit 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 vom GlideDateTime-Objekt gespeicherten Datums- und Uhrzeitwert im internen Format jjjj-MM-tt HH:mm:ss in der UTC-Zeitzone zurück.

    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 den Abgleich.
    Tabelle : 93. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts am oder nach dem im Parameter angegebenen Datum und Uhrzeit liegen.
    Mögliche Werte:
    • „wahr“: Datum und Uhrzeit des GlideDateTime-Objekts liegen am oder nach dem Datum und der Uhrzeit des angegebenen Objekts.
    • „falsch“: 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 den Abgleich.
    Tabelle : 95. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts am oder vor dem vom Parameter angegebenen Datum und Uhrzeit liegen.
    Mögliche Werte:
    • „wahr“: Datum und Uhrzeit des GlideDateTime-Objekts liegen am oder vor dem Datum und der Uhrzeit des angegebenen Objekts.
    • „falsch“: 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 einer Variablen in einem Workflow-Skript das aktuelle Datum und die aktuelle Uhrzeit zuzuweisen, verwenden Sie die Variable .setDisplayValue(gs.nowDateTime);.
    Tabelle : 101. Rückgaben
    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 Uhrzeitformat 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 Anwenders.
    format Zeichenfolge Datums- und Uhrzeitformat, das zum Analysieren des Parameters value verwendet wird.
    Verwenden Sie die folgenden Werte, um den Parameter value zu beschreiben:
    • tt: 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. Rückgaben
    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

    Bereichsbezogene GlideDateTime - setDisplayValueLang(Zeichenfolge dateTime, Zeichenfolgenstil)

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

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

    Wenn Sie beispielsweise die Ausgabe aus dem Beispiel getDisplayValueLang(Zeichenfolgenstil, Zeichenfolgensprache) weiter oben in diesem Thema verwenden, sind „28.11.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> je nach Gebietsschema des Anwenders (z. B. Montag, 24. Oktober 2022).
    • lang: gibt das Datum im Format zurück<month, day, and year> je nach Gebietsschema des Anwenders (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 Anwenders 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 zwischen Groß- und Kleinschreibung unterschieden.

    Tabelle : 107. Rückgaben
    Typ Beschreibung
    void

    Im folgenden Beispiel werden das Datum und die Uhrzeit im kurzen und vollständigen Stil zurückgegeben.

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

    Ausgabe:

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

    Bereichsbezogene GlideDateTime - setDisplayValueLang(String dateTime, Zeichenfolgenstil, Zeichenfolgensprache)

    Legt ein Datum und eine Uhrzeit unter Verwendung eines bestimmten Stils, einer bestimmten Sprache und eines bestimmten Formats entsprechend dem Gebietsschema des aktuellen Anwenders fest.

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

    Wenn Sie beispielsweise die Ausgabe aus dem Beispiel getDisplayValueLang(Zeichenfolgenstil, Zeichenfolgensprache) weiter oben in diesem Thema verwenden, sind „28.11.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> je nach Gebietsschema des Anwenders (z. B. Montag, 24. Oktober 2022).
    • lang: gibt das Datum im Format zurück<month, day, and year> je nach Gebietsschema des Anwenders (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 Anwenders 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 zwischen Groß- und Kleinschreibung unterschieden.

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

    Im folgenden Beispiel werden Datum und Uhrzeit in kurzen und vollständigen Stilen 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 Instanziierung eines neuen GlideDateTime-Objekts mit dem Konstruktor GlideDateTime(String value). 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 Uhrzeitformat 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 Konstruktor GlideDateTime(GlideDateTime g).
    • Eine JavaScript-Zahl. Legt den Wert des Objekts mit dem Zahlenwert als Millisekunden nach dem 1. Januar 1970 00:00:00 UTC fest.
    Tabelle : 117. Rückgaben
    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 Uhrzeitformat 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

    Bereichsbezogene GlideDateTime – subtrahieren (Anzahl Millisekunden)

    Subtrahiert die angegebene Anzahl von Millisekunden vom GlideDateTime-Objekt.

    Tabelle : 126. Parameter
    Name Typ Beschreibung
    milliseconds Nummer Anzahl der zu subtrahierenden Millisekunden.
    Tabelle : 127. Rückgaben
    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 Differenz bei der Dauer zwischen zwei angegebenen GlideDateTime-Objekten zurück.

    Tabelle : 128. Parameter
    Name Typ Beschreibung
    Start GlideDateTime Startdatumsobjekt.
    Ende GlideDateTime Enddatumsobjekt.
    Tabelle : 129. Rückgaben
    Typ Beschreibung
    GlideDuration Differenz bei der Dauer 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