GlideDateTime – Umfang

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 26 Minuten Lesedauer
  • Der Umfang ist festgelegt GlideDateTime Die Klasse stellt Methoden zum Ausführen von Vorgängen für GlideDateTime-Objekte bereit.

    Verwenden Sie GlideDateTime Methoden zum Ausführen von Datum/Uhrzeit-Vorgängen, z. B. Instanziierung eines GlideDateTime-Objekts, Durchführung von Berechnungen von Datum/Uhrzeit, Formatieren von Datum/Uhrzeit oder Konvertierung von Datums-/Uhrzeitformaten.

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

    Bereichsbezogener GlideDateTime – GlideDateTime()

    Instanziiert eine neue GlideDateTime Objekt mit dem aktuellen Datum und der aktuellen Uhrzeit.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine

    In diesem Beispiel wird ein instanziiert GlideDateTime Objekt.

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

    Ausgabe:

    2022-08-08 16:51:44

    Bereichsbezogener GlideDateTime – GlideDateTime (Zeichenfolgenwert)

    Instanziiert eine neue GlideDateTime Objekt, das den übergebenen Datums- und Uhrzeitwert verwendet.

    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.SSSZ
    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge UTC-Datum und -Uhrzeit, die in festgelegt werden sollen GlideDateTime Objekt.

    Dieses Beispiel zeigt, wie ein instanziiert wird GlideDateTime Objekt mit einer Zeichenfolge.

    var gdt = new GlideDateTime("2023-01-01 12:00:00");
    gs.info(gdt);

    Ausgabe:

    2023-01-01 12:00:00

    Bereichsbezogener GlideDateTime – GlideDateTime (GlideDateTime g)

    Instanziiert eine neue GlideDateTime Objekt auf die Zeit eines angegebenen festgelegt GlideDateTime Objekt.

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

    Dieses Beispiel zeigt, wie ein instanziiert wird GlideDateTime Objekt (gdt1), das eine Zeichenfolge im Format verwendet jjjj-MM-tt HH:mm:ss , Und eine Sekunde GlideDateTime Objekt (gdt2) mit gdt1.

    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

    Bereichsbezogener GlideDateTime – hinzufügen (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. 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

    Bereichsbezogene GlideDateTime – hinzufügen (Anzahl Millisekunden)

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

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    Millisekunden Nummer Die Anzahl der hinzuzufügenden Millisekunden.
    Tabelle : 7. Rückgaben
    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

    Bereichsbezogene GlideDateTime – addDaysLocalTime (Anzahl Tage)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Tagen hinzu. Ein negativer Parameter subtrahiert Tage. Die Methode bestimmt das lokale Datum und die lokale Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Tage mithilfe der lokalen Datums- und Uhrzeitwerte.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Tage Nummer Die Anzahl der hinzuzufügenden Tage. Verwenden Sie einen negativen Wert, um abzuziehen.
    Tabelle : 9. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addDaysLocalTime(-1);
    gs.info(gdt.getLocalDate());

    Ausgabe:

    2011-08-30

    Bereichsbezogener GlideDateTime – addDaysUTC(Anzahl Tage)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Tagen hinzu. Ein negativer Parameter subtrahiert Tage. Die Methode bestimmt das UTC-Datum und die UTC-Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Tage mithilfe der UTC-Datums- und -Uhrzeitwerte.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Tage Nummer Die Anzahl der hinzuzufügenden Tage. Verwenden Sie eine negative Zahl, um abzuziehen.
    Tabelle : 11. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addDaysUTC(-1);
    gs.info(gdt.getDate());

    Ausgabe:

     2011-08-30

    Bereichsbezogene GlideDateTime – addMonthsLocalTime (Anzahl Monate)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Monaten hinzu. Ein negativer Parameter subtrahiert Monate. Die Methode bestimmt das lokale Datum und die lokale Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Monate mithilfe der lokalen Datums- und Uhrzeitwerte.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Monate Nummer Die Anzahl der hinzuzufügenden Monate. Verwenden Sie einen negativen Wert, um abzuziehen.
    Tabelle : 13. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addMonthsLocalTime(2);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-10-31

    Bereichsbezogener GlideDateTime – addMonthsUTC(Anzahl Monate)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Monaten hinzu. Ein negativer Parameter subtrahiert Monate. Die Methode bestimmt das UTC-Datum und die UTC-Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Monate mithilfe der UTC-Datums- und -Uhrzeitwerte.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    Monate Nummer Die Anzahl der hinzuzufügenden Monate. Verwenden Sie einen negativen Wert, um abzuziehen.
    Tabelle : 15. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addMonthsUTC(2);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-10-31

    Bereichsbezogene GlideDateTime – addSeconds (Anzahl Sekunden)

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

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    Sekunden Nummer Die Anzahl der hinzuzufügenden Sekunden.
    Tabelle : 17. Rückgaben
    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

    Bereichsbezogener GlideDateTime – addWeeksLocalTime (Anzahl Wochen)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Wochen hinzu. Ein negativer Parameter subtrahiert Wochen. Die Methode bestimmt das lokale Datum und die lokale Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Wochen anhand der lokalen Datums- und Uhrzeitwerte.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    Wochen Nummer Die Anzahl der hinzuzufügenden Wochen. Verwenden Sie einen negativen Wert, um abzuziehen.
    Tabelle : 19. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addWeeksLocalTime(-1);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-08-24

    Bereichsbezogener GlideDateTime – addWeeksUTC(Anzahl Wochen)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Wochen hinzu. Ein negativer Parameter subtrahiert Wochen. Die Methode bestimmt das UTC-Datum und die UTC-Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Wochen mithilfe der UTC-Datums- und -Uhrzeitwerte.

    Tabelle : 20. Parameter
    Name Typ Beschreibung
    Wochen Nummer Die Anzahl der hinzuzufügenden Wochen. Verwenden Sie einen negativen Wert, um abzuziehen.
    Tabelle : 21. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addWeeksUTC(-1);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-08-24

    Bereichsbezogene GlideDateTime – addYearsLocalTime (Anzahl Jahre)

    Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Jahren hinzu. Ein negativer Parameter subtrahiert Jahre. Die Methode bestimmt das lokale Datum und die lokale Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Jahre anhand der lokalen Datums- und Uhrzeitwerte.

    Tabelle : 22. Parameter
    Name Typ Beschreibung
    years Nummer Die Anzahl der hinzuzufügenden Jahre. Verwenden Sie einen negativen Wert, um abzuziehen.
    Tabelle : 23. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2010-08-31 08:00:00");
    gdt.addYearsLocalTime(1);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-08-31

    Bereichsbezogener GlideDateTime – addYearsUTC(Anzahl Jahre)

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

    Tabelle : 24. Parameter
    Name Typ Beschreibung
    years Nummer Die Anzahl der hinzuzufügenden Jahre. Verwenden Sie einen negativen Wert, um abzuziehen.
    Tabelle : 25. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime("2010-08-31 08:00:00");
    gdt.addYearsUTC(1);
    gs.info(gdt.getDate());

    Ausgabe:

    2011-08-31

    Bereichsbezogener GlideDateTime – After(GlideDateTime gdt)

    Bestimmt, ob Datum und Uhrzeit des GlideDateTime-Objekts nach Datum und Uhrzeit des angegebenen Objekts liegen.

    Tabelle : 26. Parameter
    Name Typ Beschreibung
    gdt GlideDateTime Datum und Uhrzeit für die Überprüfung.
    Tabelle : 27. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob Datum und Uhrzeit des GlideDateTime-Objekts nach dem vom Parameter angegebenen Datum und der vom Parameter angegebenen Uhrzeit liegen.
    Mögliche Werte:
    • Wahr: Datum und Uhrzeit des GlideDateTime-Objekts liegen nach Datum und Uhrzeit des angegebenen Objekts.
    • Falsch: Datum und Uhrzeit des GlideDateTime-Objekts liegen vor oder entsprechen 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.after(gdt2)); 

    Ausgabe:

    False

    Bereichsbezogener GlideDateTime – vor(GlideDateTime gdt)

    Bestimmt, ob Datum und Uhrzeit des GlideDateTime-Objekts vor Datum und Uhrzeit des angegebenen GlideDateTime-Objekts liegen.

    Tabelle : 28. Parameter
    Name Typ Beschreibung
    gdt GlideDateTime Datum und Uhrzeit für die Überprüfung.
    Tabelle : 29. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob Datum und Uhrzeit des GlideDateTime-Objekts vor dem vom Parameter angegebenen Datum und der vom Parameter angegebenen Uhrzeit liegen.
    Mögliche Werte:
    • Wahr: Datum und Uhrzeit des GlideDateTime-Objekts liegen vor dem angegebenen Datum und der angegebenen Uhrzeit.
    • Falsch: Datum und Uhrzeit des GlideDateTime-Objekts liegen nach oder gleich dem angegebenen Datum und der angegebenen Uhrzeit.
    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

    Bereichsbezogene GlideDateTime – compareTo(Object o)

    Vergleicht zwei Datums- und Uhrzeitobjekte, um zu bestimmen, ob sie gleichwertig sind oder eines vor oder nach dem anderen liegt.

    Tabelle : 30. Parameter
    Name Typ Beschreibung
    o Objekt Datums- und Uhrzeitobjekt im GlideDateTime-Format
    Tabelle : 31. Rückgaben
    Typ Beschreibung
    Nummer
    • 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

    Bereichsbezogene GlideDateTime – gleich(Objekt dateTime)

    Vergleicht ein Datum/Uhrzeit mit einem vorhandenen Wert für die Gleichheit.

    Tabelle : 32. Parameter
    Name Typ Beschreibung
    Datum/Uhrzeit GlideDateTime-Objekt oder -Zeichenfolge Das Datum/die Uhrzeit, die verglichen werden soll.
    Tabelle : 33. Rückgaben
    Typ Beschreibung
    Boolean Gibt „wahr“ zurück, wenn sie gleich sind; andernfalls „falsch“.
    var gdt = new GlideDateTime("2011-08-31 00:00:00");
    gs.info(gdt.equals("2011-09-30 00:12:01"));

    Ausgabe:

    false

    Bereichsbezogener 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. Rückgaben
    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

    Bereichsbezogene GlideDateTime – getDayOfMonthLocalTime()

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

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

    Ausgabe:

    2

    Bereichsbezogener 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. Rückgaben
    Typ Beschreibung
    Nummer 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

    Bereichsbezogener GlideDateTime – getDayOfWeekLocalTime()

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

    Tabelle : 40. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 41. Rückgaben
    Typ Beschreibung
    Nummer Der Wochentagwert in der Zeitzone des Anwenders von 1 bis 7. Montag ist gleich 1, Sonntag gleich 7.
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//Thursday
    gs.info(gdt.getDayOfWeekLocalTime());

    Ausgabe:

    4

    Bereichsbezogener GlideDateTime – getDayOfWeekUTC()

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

    Tabelle : 42. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 43. Rückgaben
    Typ Beschreibung
    Nummer Wochentagwert von 1 bis 7. Montag ist gleich 1, Sonntag gleich 7.
    var gdt = new GlideDateTime("2011-12-01 12:00:00"); //Thursday
    gs.info(gdt.getDayOfWeekUTC());

    Ausgabe:

    4

    Bereichsbezogene GlideDateTime – getDaysInMonthLocalTime()

    Ruft die Anzahl der Tage im Monat ab, die vom GlideDateTime-Objekt gespeichert sind, ausgedrückt in der Zeitzone des aktuellen Anwenders.

    Tabelle : 44. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 45. Rückgaben
    Typ Beschreibung
    Nummer Die Anzahl der Tage im aktuellen Monat in der Zeitzone des Anwenders.
    var gdt = new GlideDateTime("2011-12-02 12:00:00"); //December
    gs.info(gdt.getDaysInMonthLocalTime());

    Ausgabe:

    30

    Bereichsbezogener GlideDateTime – getDaysInMonthUTC()

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

    Tabelle : 46. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 47. Rückgaben
    Typ Beschreibung
    Nummer 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

    Bereichsbezogener GlideDateTime – getDisplayValue()

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

    Tabelle : 48. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 49. Rückgaben
    Typ Beschreibung
    Zeichenfolge Datum und Uhrzeit im Format und der Zeitzone des Anwenders. Beachten Sie beim Entwerfen von Business-Regeln oder Skripteinbindungen, dass diese Methode Werte in verschiedenen Formaten für verschiedene Anwender 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

    Bereichsbezogener GlideDateTime – getDisplayValueInternal()

    Ruft den Anzeigewert im internen Format ab (jjjj-MM-tt HH:mm:ss).

    Tabelle : 50. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 51. Rückgaben
    Typ Beschreibung
    Zeichenfolge Die Datums- und Uhrzeitwerte für das GlideDateTime-Objekt in der Zeitzone des aktuellen Anwenders und das interne Datums- und Uhrzeitformat von 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

    Bereichsbezogener 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 Datums- und Uhrzeitformat an.
    Gültige Werte:
    • Voll : Gibt das Datum im Format <weekday, month, day and year> gemäß dem Gebietsschema des Anwenders zurück (z. B. Montag, 24. Oktober 2022).
    • Lang : Gibt das Datum im Format <Monat, Tag und Jahr> gemäß dem Gebietsschema des Anwenders zurück (z. B. 24. Oktober 2022).
    • Mittel : Ähnlich Lang Gibt jedoch das Datum mit einem abgekürzten Monat zurück (z. B. 24. Oktober 2022).
    • Kurz : Gibt das Datum im Format MM/TT/JJ oder TT/MM/JJ gemäß dem Gebietsschema des Anwenders zurück (z. B. 10/24/2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, wird die API standardmäßig verwendet Mittel . Bei akzeptierten Werten wird die Groß-/Kleinschreibung nicht beachtet.

    language Zeichenfolge Gibt das Datum gemäß einem angegebenen Sprachwert zurück. Akzeptiert Sprach-Tags, die dem BCP-47-Standard entsprechen. Beispiel: fr Für Französisch oder en-Vereinigtes Königreich 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.

    Das folgende Beispiel gibt Datum und Uhrzeit des Gebietsschemas des Anwenders in allen Sprachen 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

    Bereichsbezogener GlideDateTime – getDSTOffset()

    Ruft die Zeit ab, für die die Sommerzeit verschoben ist.

    Tabelle : 54. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 55. Rückgaben
    Typ Beschreibung
    Nummer Zeit in Millisekunden, für die die Sommerzeit versetzt ist. Gibt 0 zurück, wenn kein Offset vorhanden ist oder die Zeit nicht in der Sommerzeit liegt.
    var gdt = new GlideDateTime("2014-08-31 08:00:00"); 
    gs.info(gdt.getDSTOffset()); //uses current user session time zone (US/Pacific)

    Ausgabe:

    3600000

    Bereichsbezogener GlideDateTime – getErrorMsg()

    Ruft die aktuelle Fehlermeldung ab.

    Tabelle : 56. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 57. Rückgaben
    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

    Bereichsbezogener 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. Rückgaben
    Typ Beschreibung
    Zeichenfolge Die Zeit des Objekts in der lokalen Zeitzone und im internen Format.

    Dieses Beispiel zeigt die Zeit im Systemzeitformat der Zeitzone des Anwenders an.

    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

    Bereichsbezogener GlideDateTime – getLocalDate()

    Ruft das vom GlideDateTime-Objekt gespeicherte Datum ab, ausgedrückt im Standardformat JJJ-MM-TT und in der Zeitzone des aktuellen Anwenders.

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

    Ausgabe:

    2011-08-31

    Bereichsbezogene GlideDateTime – getLocalTime()

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

    Tabelle : 62. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 63. Rückgaben
    Typ Beschreibung
    GlideTime Die Zeit in der Zeitzone des Anwenders.
    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

    Bereichsbezogene GlideDateTime – getMonthLocalTime()

    Ruft den vom GlideDateTime-Objekt gespeicherten Monat ab, ausgedrückt in der Zeitzone des aktuellen Anwenders.

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

    Ausgabe:

    11

    Bereichsbezogener GlideDateTime – getMonthUTC()

    Ruft den vom GlideDateTime-Objekt gespeicherten Monat ab, ausgedrückt in der UTC-Zeitzone.

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

    Ausgabe:

    11

    Bereichsbezogener GlideDateTime – getNumericValue()

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

    Tabelle : 68. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 69. Rückgaben
    Typ Beschreibung
    Nummer 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

    Bereichsbezogene GlideDateTime – getTime()

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

    Tabelle : 70. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 71. Rückgaben
    Typ Beschreibung
    GlideTime Der Unix-Dauerstempel 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

    Bereichsbezogener GlideDateTime – getTZOffset()

    Ruft den Zeitzonen-Offset in Millisekunden ab.

    Tabelle : 72. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 73. Rückgaben
    Typ Beschreibung
    Nummer Die Anzahl der Millisekunden des Zeitzonen-Offsets.
    var gdt = new GlideDateTime();
    gdt.getLocalTime(); // PST local time
    gs.info(gdt.getTZOffset());

    Ausgabe:

    -25200000

    Bereichsbezogener GlideDateTime – getUserFormattedLocalTime()

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

    Tabelle : 74. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 75. Rückgaben
    Typ Beschreibung
    Zeichenfolge Die Zeit des Objekts in der lokalen Zeitzone und im Format des Anwenders.

    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

    Bereichsbezogener GlideDateTime – getValue()

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

    Tabelle : 76. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 77. Rückgaben
    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

    Bereichsbezogene GlideDateTime – getWeekOfYearLocalTime()

    Ruft die Anzahl der vom GlideDateTime-Objekt gespeicherten Woche ab, ausgedrückt in der Zeitzone des aktuellen Anwenders.

    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 Sonntag den 27. Dezember 2015 beginnt, wird als erste Woche des 2016 betrachtet, da diese Woche den 1. Und 2. Januar enthält.

    Tabelle : 78. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 79. Rückgaben
    Typ Beschreibung
    Nummer Die Nummer der aktuellen Woche. Die höchste Wochennummer in einem Jahr ist 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

    Bereichsbezogener GlideDateTime – getWeekOfYearUTC()

    Ruft die Anzahl der vom GlideDateTime-Objekt gespeicherten Woche ab, 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 Sonntag den 27. Dezember 2015 beginnt, wird als erste Woche des 2016 betrachtet, da diese Woche den 1. Und 2. Januar enthält.

    Tabelle : 80. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 81. Rückgaben
    Typ Beschreibung
    Nummer Die Nummer der aktuellen Woche in UTC-Zeit. Die höchste Wochennummer in einem Jahr ist 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

    Bereichsbezogene GlideDateTime – getYearLocalTime()

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

    Tabelle : 82. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 83. Rückgaben
    Typ Beschreibung
    Nummer Vierstelliger Jahreswert in der Zeitzone des Anwenders.
    var gdt = new GlideDateTime("2011-11-02 12:00:00");
    gs.info(gdt.getYearLocalTime());

    Ausgabe:

    2011

    Bereichsbezogener GlideDateTime – getYearUTC()

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

    Tabelle : 84. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 85. Rückgaben
    Typ Beschreibung
    Nummer 4-stelliger Jahreswert in der UTC-Zeitzone.
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); 
    gs.info(gdt.getYearUTC());

    Ausgabe:

    2011

    Bereichsbezogene GlideDateTime – hasDate()

    Bestimmt, ob das Datum eines Objekts festgelegt ist.

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

    Ausgabe:

    true

    Bereichsbezogene GlideDateTime – isDST()

    Bestimmt, ob die Zeit eines Objekts einen Sommerzeit-Offset verwendet.

    Tabelle : 88. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 89. Rückgaben
    Typ Beschreibung
    Boolean „Wahr“, wenn die Zeit Sommerzeit ist; andernfalls wird „falsch“ 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

    Bereichsbezogener 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. Rückgaben
    Typ Beschreibung
    Boolean „Wahr“, wenn der Wert gültig ist. Andernfalls wird „falsch“ 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

    Bereichsbezogener GlideDateTime – onOrAfter(GlideDateTime gdt)

    Bestimmt, ob die Daten 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. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob Datum und Uhrzeit des GlideDateTime-Objekts am oder nach dem vom Parameter angegebenen Datum und der angegebenen 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

    Bereichsbezogener GlideDateTime – onOrBefore(GlideDateTime gdt)

    Bestimmt, ob die Daten 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. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob Datum und Uhrzeit des GlideDateTime-Objekts am oder vor dem vom Parameter angegebenen Datum und der angegebenen 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 Datum und 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

    Bereichsbezogener GlideDateTime – setDay OfMonthLocalTime(Anzahl Tag)

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

    Tabelle : 96. Parameter
    Name Typ Beschreibung
    Tag Nummer Der Tag des Monats, in den geändert werden soll, von 1 bis 31. Wenn dieser Wert größer als die maximale Anzahl von Tagen im Monat ist, wird der Wert auf den letzten Tag des Monats festgelegt.
    Tabelle : 97. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setDayOfMonthLocalTime(9);
    gs.info(gdt.getDayOfMonthLocalTime());

    Ausgabe:

    9

    Bereichsbezogener GlideDateTime – setDayOfMonthUTC(Zahlentag)

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

    Tabelle : 98. Parameter
    Name Typ Beschreibung
    Tag Nummer Der Tag des Monats, in den geändert werden soll, von 1 bis 31. Wenn dieser Wert größer als die maximale Anzahl von Tagen im Monat ist, wird der Wert auf den letzten Tag des Monats festgelegt.
    Tabelle : 99. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setDayOfMonthUTC(9);
    gs.info(gdt.getDayOfMonthUTC());

    Ausgabe:

    9

    Bereichsbezogener GlideDateTime – setDisplayValue(Zeichenfolge asDisplayed)

    Legt einen Datums- und Uhrzeitwert mithilfe des Anzeigeformats und der Zeitzone des aktuellen Anwenders fest.

    Tabelle : 100. Parameter
    Name Typ Beschreibung
    AsDisplays Zeichenfolge Das Datum und die Uhrzeit im Anzeigeformat und in der Zeitzone des aktuellen Anwenders. Der Parameter muss mit dem bevorzugten Anzeigeformat des aktuellen Anwenders formatiert werden, z. B. MM-tt-jjj HH:mm:ss. Verwenden Sie, um einer Variable in einem Workflow-Skript das aktuelle Datum und die aktuelle Uhrzeit zuzuweisen 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

    Bereichsbezogene GlideDateTime – setDisplayValue(Zeichenfolgenwert, Zeichenfolgenformat)

    Legt einen Datums- und Uhrzeitwert anhand der Zeitzone des aktuellen Anwenders und des angegebenen Datums- und Uhrzeitformats fest.

    Diese Methode löst eine Laufzeitausnahme aus, wenn das Datums- und Uhrzeitformat in verwendet wird valueParameter stimmt nicht mit überein formatParameter. Sie können die Fehlermeldung abrufen, indem Sie aufrufen GetErrorMsg() Im GlideDateTime-Objekt, nachdem die Ausnahme erfasst 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 von verwendet werden soll valueParameter.
    Verwenden Sie die folgenden Werte, um zu beschreiben valueParameter:
    • 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-jjj 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"

    Bereichsbezogener GlideDateTime – setDisplayValueInternal(Zeichenfolgenwert)

    Legt einen Datums- und Uhrzeitwert mithilfe des internen Formats (jjjj-MM-tt HH:mm:ss) und der Zeitzone des aktuellen Anwenders fest.

    Tabelle : 104. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge Datum und Uhrzeit im internen Format.
    Tabelle : 105. Rückgaben
    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

    Bereichsbezogener GlideDateTime – setDisplayValueLang(Zeichenfolge dateTime, Zeichenfolgenstil)

    Legt Datum und Uhrzeit mit einem angegebenen Stil und Format gemäß dem Gebietsschema des aktuellen Anwenders fest.

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

    Beispiel: Mithilfe der Ausgabe von GetDisplayValueLang (Zeichenfolgenstil, Zeichenfolgensprache) Beispiel zuvor in diesem Thema, 28. November 2022 07:03:41 Oder 28.11.2022 07:03:41 Sind akzeptierte Werte.

    Stil Zeichenfolge Gibt das Datumsformat an.
    Gültige Werte:
    • Voll : Gibt das Datum im Format <weekday, month, day and year> gemäß dem Gebietsschema des Anwenders zurück (z. B. Montag, 24. Oktober 2022).
    • Lang : Gibt das Datum im Format <Monat, Tag und Jahr> gemäß dem Gebietsschema des Anwenders zurück (z. B. 24. Oktober 2022).
    • Mittel : Ähnlich Lang Gibt jedoch das Datum mit einem abgekürzten Monat zurück (z. B. 24. Oktober 2022).
    • Kurz : Gibt das Datum im Format MM/TT/JJ oder TT/MM/JJ gemäß dem Gebietsschema des Anwenders zurück (z. B. 10/24/2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, wird die API standardmäßig verwendet Mittel . Bei akzeptierten Werten wird die Groß-/Kleinschreibung nicht beachtet.

    Tabelle : 107. Rückgaben
    Typ Beschreibung
    void

    Das folgende Beispiel gibt Datum und Uhrzeit in kurzen und vollständigen Stilen zurück.

    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

    Bereichsbezogener GlideDateTime – setDisplayValueLang(ZeichenfolgendateTime, Zeichenfolgenstil, Zeichenfolgensprache)

    Legt Datum und Uhrzeit mit einem angegebenen Stil, einer bestimmten Sprache und einem angegebenen Format gemäß dem Gebietsschema des aktuellen Anwenders fest.

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

    Beispiel: Mithilfe der Ausgabe von GetDisplayValueLang (Zeichenfolgenstil, Zeichenfolgensprache) Beispiel zuvor in diesem Thema, 28. November 2022 07:03:41 Oder 28.11.2022 07:03:41 Sind akzeptierte Werte.

    Stil Zeichenfolge Gibt das Datumsformat an.
    Gültige Werte:
    • Voll : Gibt das Datum im Format <weekday, month, day and year> gemäß dem Gebietsschema des Anwenders zurück (z. B. Montag, 24. Oktober 2022).
    • Lang : Gibt das Datum im Format <Monat, Tag und Jahr> gemäß dem Gebietsschema des Anwenders zurück (z. B. 24. Oktober 2022).
    • Mittel : Ähnlich Lang Gibt jedoch das Datum mit einem abgekürzten Monat zurück (z. B. 24. Oktober 2022).
    • Kurz : Gibt das Datum im Format MM/TT/JJ oder TT/MM/JJ gemäß dem Gebietsschema des Anwenders zurück (z. B. 10/24/2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, wird die API standardmäßig verwendet Mittel . Bei akzeptierten Werten wird die Groß-/Kleinschreibung nicht beachtet.

    language Zeichenfolge Legt die Sprache mithilfe eines Sprach-Tags fest, das dem BCP-47-Standard entspricht. Beispiel: fr Für Französisch oder en-Vereinigtes Königreich Für britisches Englisch. Eine vollständige Liste der akzeptierten Werte finden Sie unter BCP 47-Sprachcodeliste .
    Tabelle : 109. Rückgaben
    Typ Beschreibung
    void

    Das folgende Beispiel gibt Datum und Uhrzeit in kurzen und vollständigen Stilen für Englisch und Französisch zurück.

    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

    Bereichsbezogener GlideDateTime – setGlideDateTime(GlideDateTime g)

    Legt Datum und Uhrzeit des aktuellen Objekts mithilfe eines vorhandenen GlideDateTime-Objekts fest. Diese Methode entspricht der Instanziierung eines neuen Objekts mit einem GlideDateTime-Parameter.

    Tabelle : 110. Parameter
    Name Typ Beschreibung
    g GlideDateTime Das Objekt, das zum Festlegen des datetime-Werts verwendet werden soll.
    Tabelle : 111. Rückgaben
    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

    Bereichsbezogene GlideDateTime – setMonthLocalTime(Anzahl Monat)

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

    Tabelle : 112. Parameter
    Name Typ Beschreibung
    Monat Nummer Der Monat, in den geändert werden soll.
    Tabelle : 113. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setMonthLocalTime(1);
    gs.info(gdt.getMonthLocalTime());

    Ausgabe:

    1

    Bereichsbezogener GlideDateTime – setMonthUTC(Anzahl Monat)

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

    Tabelle : 114. Parameter
    Name Typ Beschreibung
    Monat Nummer Der Monat, in den geändert werden soll.
    Tabelle : 115. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setMonthUTC(1);
    gs.info(gdt.getMonthUTC());

    Ausgabe:

    1

    Bereichsbezogener GlideDateTime – setValue(Zeichenfolge 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 das interne Format JJJJ-MM-tt HH:mm:ss. Legt den Wert des Objekts auf das angegebene Datum und die angegebene Uhrzeit fest. Die Verwendung der Methode auf diese Weise entspricht der Instanziierung eines neuen GlideDateTime-Objekts mit GlideDateTime (Zeichenfolgenwert) Konstruktor. Wenn das verwendete Datums- und Uhrzeitformat nicht mit dem internen Format übereinstimmt, versucht die Methode, das Datum und die Uhrzeit mit anderen verfügbaren Formaten festzulegen. Die Lösung von Datum und Uhrzeit auf diese Weise kann aufgrund von Mehrdeutigkeiten in den Tag- und Monatswerten zu ungenauen Daten führen. Verwenden Sie bei Verwendung eines nicht standardmäßigen Datums- und Uhrzeitformats SetValueUTC(Zeichenfolge dt, Zeichenfolgenformat) Stattdessen.
    • Ein GlideDateTime-Objekt. Legt den Wert des Objekts auf das Datum und die Uhrzeit fest, die vom im Parameter übergebenen GlideDateTime gespeichert werden. Die Verwendung der Methode auf diese Weise entspricht der Instanziierung eines neuen GlideDateTime-Objekts mit GlideDateTime (GlideDateTime g) Konstruktor.
    • Eine JavaScript-Nummer. Legt den Wert des Objekts mithilfe des Zahlenwerts 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

    Bereichsbezogener GlideDateTime – setValueUTC(Zeichenfolge dt, Zeichenfolgenformat)

    Legt einen Datums- und Uhrzeitwert mithilfe der UTC-Zeitzone und des angegebenen Datums- und Uhrzeitformats fest. Diese Methode löst eine Laufzeitausnahme aus, wenn das Datums- und Uhrzeitformat in verwendet wird dtParameter stimmt nicht mit überein formatParameter. Sie können die Fehlermeldung abrufen, indem Sie aufrufen GetErrorMsg() Im GlideDateTime-Objekt, nachdem die Ausnahme erfasst wurde.

    Tabelle : 118. Parameter
    Name Typ Beschreibung
    DT Zeichenfolge Das Datum und die Uhrzeit, die verwendet werden sollen.
    format Zeichenfolge Das zu verwendende Datums- und Uhrzeitformat.
    Tabelle : 119. Rückgaben
    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

    Bereichsbezogener GlideDateTime – setYearLocalTime(Zahlenjahr)

    Legt das vom GlideDateTime-Objekt gespeicherte Jahr anhand der Zeitzone des aktuellen Anwenders auf den angegebenen Wert fest.

    Tabelle : 120. Parameter
    Name Typ Beschreibung
    Jahr Nummer Das Jahr, in das geändert werden soll.
    Tabelle : 121. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setYearLocalTime(2013);
    gs.info(gdt.getYearLocalTime());

    Ausgabe:

    2013

    Bereichsbezogener GlideDateTime – setYearUTC(Nummernjahr)

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

    Tabelle : 122. Parameter
    Name Typ Beschreibung
    Jahr Nummer Das Jahr, in das geändert werden soll.
    Tabelle : 123. Rückgaben
    Typ Beschreibung
    Keine
    var gdt = new GlideDateTime();
    gdt.setYearUTC(2013);
    gs.info(gdt.getYearUTC());

    Ausgabe:

    2013

    Bereichsbezogene GlideDateTime – subtrahieren(GlideTime-Zeit)

    Subtrahiert eine angegebene Zeit vom aktuellen GlideDateTime-Objekt.

    Tabelle : 124. Parameter
    Name Typ Beschreibung
    Zeitreihendiagramm GlideTime Der abzuziehende Zeitwert.
    Tabelle : 125. 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.subtract(gtime1);
    var gtime2 = gdt.getTime();
    gs.info(gtime2.getByFormat('hh:mm:ss'));

    Ausgabe:

    07:59:40

    Bereichsbezogene GlideDateTime – abziehen (Anzahl Millisekunden)

    Subtrahiert die angegebene Anzahl von Millisekunden vom GlideDateTime-Objekt.

    Tabelle : 126. Parameter
    Name Typ Beschreibung
    Millisekunden Nummer Anzahl der abzuziehenden 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

    Bereichsbezogener GlideDateTime – subtrahieren(GlideDateTime Start, GlideDateTime End)

    Gibt die Differenz der Dauer zwischen zwei angegebenen GlideDateTime-Objekten zurück.

    Tabelle : 128. Parameter
    Name Typ Beschreibung
    Starten GlideDateTime Startdatum-Objekt.
    Ende GlideDateTime Enddatum-Objekt.
    Tabelle : 129. Rückgaben
    Typ Beschreibung
    GlideDuration Differenz 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

    Bereichsbezogener GlideDateTime – toString()

    Ruft den Datums- und Uhrzeitwert ab, der vom GlideDateTime-Objekt gespeichert wird, im internen Format jjjj-MM-tt HH:mm:ss und in der Systemzeitzone UTC standardmäßig. Diese Methode entspricht GetValue() .

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

    Ausgabe:

    2011-08-31 08:00:00