GlideDateTime : Global

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

GlideDateTime – GlideDateTime(String dateTime)

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

GlideDateTime – GlideDateTime(GlideDateTime gdt)

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

Tabelle : 3. Parameter
Name	Typ	Beschreibung
gDT	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

GlideDateTime – add (Number milliseconds)

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

Tabelle : 4. Parameter
Name	Typ	Beschreibung
milliseconds	Zahl	Die Anzahl der Millisekunden, die hinzugefügt werden sollen

Tabelle : 5. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getNumericValue());
gdt.add(10);
gs.print(gdt.getNumericValue());

Ausgabe:

1314777600000
1314777600010

Bereichsbezogenes Äquivalent

Um die add()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: add().

GlideDateTime – add(GlideTime time)

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

Tabelle : 6. Parameter
Name	Typ	Beschreibung
time	GlideTime	GlideTime-Objekt, dessen Zeitwert zum angegebenen GlideDateTime-Objekt addiert werden soll.

Tabelle : 7. Rückgaben
Typ	Beschreibung
void

In diesem Beispiel wird gezeigt, wie der im gdt-GlideDateTime-Objekt festgelegten Zeit 20 Sekunden hinzugefügt werden.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.add(gtime1);
gs.print(gdt.toString());

Ausgabe:

2011-08-31 08:00:20

Bereichsbezogenes Äquivalent

Um die add()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: add().

GlideDateTime – addDays(Number days)

Fügt eine angegebene Anzahl an Tagen zum aktuellen GlideDateTime-Objekt hinzu. Ein negativer Parameter zieht Tage ab.

Benutzen Sie addDaysLocalTime() und addDaysUTC() anstelle dieser Methode.

Tabelle : 8. Parameter
Name	Typ	Beschreibung
days	Zahl	Die Anzahl der Tage, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren eine negative Zahl.

Tabelle : 9. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDays(-1);
gs.print(gdt.getDate());

Ausgabe:

2011-08-30

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 : 10. Parameter
Name	Typ	Beschreibung
days	Zahl	Die Anzahl der Tage, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert.

Tabelle : 11. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysLocalTime(-1);
gs.print(gdt.getLocalDate());

Ausgabe:

2011-08-30

Bereichsbezogenes Äquivalent

Um die addDaysLocalTime()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addDaysLocalTime().

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 : 12. Parameter
Name	Typ	Beschreibung
days	Zahl	Die Anzahl der Tage, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert.

Tabelle : 13. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysUTC(-1);
gs.print(gdt.getDate());

Ausgabe:

2011-08-30

Bereichsbezogenes Äquivalent

Um die addDaysUTC()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die die entsprechende bereichsbezogene Methode: addDaysUTC().

GlideDateTime – addSeconds (Number seconds)

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

Tabelle : 14. Parameter
Name	Typ	Beschreibung
seconds	Zahl	Die Anzahl der Sekunden, die hinzugefügt werden sollen

Tabelle : 15. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.addSeconds(1000);
gs.print(gdt.getValue());

Ausgabe:

2011-12-07 08:16:40

Bereichsbezogenes Äquivalent

Um die addSeconds()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addSeconds().

GlideDateTime – addWeeks(Number weeks)

Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Wochen hinzu. Ein negativer Parameter zieht Wochen ab.

Verwenden Sie addWeeksLocalTime() und addWeeksUTC() anstelle dieser Methode.

Tabelle : 16. Parameter
Name	Typ	Beschreibung
weeks	Zahl	Die Anzahl der Wochen, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren eine negative Zahl.

Tabelle : 17. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeks(-1);
gs.print(gdt.getDate());

Ausgabe:

2011-08-24

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 eine negative Zahl.

Tabelle : 19. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksLocalTime(-1);
gs.print(gdt.getDate());

Ausgabe:

2011-08-24

Bereichsbezogenes Äquivalent

Um die addWeeksLocalTime()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addWeeksLocalTime().

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 eine negative Zahl.

Tabelle : 21. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksUTC(-1);
gs.print(gdt.getDate());

Ausgabe:

2011-08-24

Bereichsbezogenes Äquivalent

Um die addWeeksUTC()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addWeeksUTC().

GlideDateTime – addMonths(Number months)

Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Monaten hinzu. Ein negativer Parameter zieht Monate ab.

Verwenden Sie addMonthsLocalTime() oder addMonthsUTC() anstelle dieser Methode.

Tabelle : 22. Parameter
Name	Typ	Beschreibung
months	Zahl	Die Anzahl der Monate, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren eine negative Zahl.

Tabelle : 23. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonths(2);
gs.print(gdt.getDate());

Ausgabe:

2011-10-31

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 : 24. Parameter
Name	Typ	Beschreibung
months	Zahl	Die Anzahl der Monate, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert.

Tabelle : 25. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsLocalTime(2);
gs.print(gdt.getDate());

Ausgabe:

2011-10-31

Bereichsbezogenes Äquivalent

Um die addMonthsLocalTime()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addMonthsLocalTime().

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 : 26. Parameter
Name	Typ	Beschreibung
months	Zahl	Die Anzahl der Monate, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren eine negative Zahl.

Tabelle : 27. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsUTC(2);
gs.print(gdt.getDate());

Ausgabe:

2011-10-31

Bereichsbezogenes Äquivalent

Um die addMonthsUTC()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addMonthsUTC().

GlideDateTime – addYears (Number years)

Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Jahren hinzu. Ein negativer Parameter zieht Jahre ab.

Verwenden Sie addYearsLocalTime() oder addYearsUTC() anstelle dieser Methode.

Tabelle : 28. Parameter
Name	Typ	Beschreibung
years	Zahl	Die Anzahl der Jahre, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert.

Tabelle : 29. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYears(1);
gs.print(gdt.getDate());

Ausgabe:

2011-08-31

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 : 30. Parameter
Name	Typ	Beschreibung
years	Zahl	Die Anzahl der Jahre, die hinzugefügt werden sollen. Zum Subtrahieren verwenden Sie einen negativen Wert.

Tabelle : 31. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsLocalTime(1);
gs.print(gdt.getDate());

Ausgabe:

2011-08-31

Bereichsbezogenes Äquivalent

Um die AddYearsLocalTime()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: AddYearsLocalTime().

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 : 32. Parameter
Name	Typ	Beschreibung
years	Zahl	Die Anzahl der Jahre, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert.

Tabelle : 33. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsUTC(1);
gs.print(gdt.getDate());

Ausgabe:

2011-08-31

Bereichsbezogenes Äquivalent

Um die addYearsUTC()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addYearsUTC().

GlideDateTime – compareTo(Object dateTime)

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

Tabelle : 34. Parameter
Name	Typ	Beschreibung
dateTime	Objekt	Datum/Uhrzeit in einem GlideDateTime-Objekt

Tabelle : 35. 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

Bereichsbezogenes Äquivalent

Um die compareTo()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: compareTo().

GlideDateTime – equals(Object GDT)

Vergleicht ein Objekt mit einem vorhandenen Wert auf Gleichheit.

Tabelle : 36. Parameter
Name	Typ	Beschreibung
GDT	Objekt	Das Objekt, das verglichen werden soll. Kann ein GlideDateTIme-Objekt oder eine gültige Datums-/Zeitzeichenfolge sein.

Tabelle : 37. Ergebnisse
Typ	Beschreibung
Boolean	„True“, wenn sie gleich sind, ansonsten „false“.

var gdt = new GlideDateTime("2011-08-31 00:00:00");
gs.print(gdt.equals("2011-09-30 00:12:01"));

Ausgabe:

 false

Bereichsbezogenes Äquivalent

Um die equals()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: equals().

GlideDateTime – getDate()

Gibt das vom GlideDateTime-Objekt gespeicherte Datum zurück. Ausgedrückt im Format jjjj-MM-tt und in der Systemzeitzone, standardmäßig UTC.

Tabelle : 38. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 39. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Datum in der Systemzeitzone. Format: jjjj-MM-tt; in der Systemzeitzone standardmäßig UTC.

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

Ausgabe:

2011-08-31

Bereichsbezogenes Äquivalent

Um die Methode getDate() in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende Methode getDate().

GlideDateTime – getDayOfMonth()

Ruft den aktuellen Tag des Monats in der UTC-Zeitzone ab.

Veraltet. Verwenden Sie getDayOfMonthLocalTime() und getDayOfMonthUTC() anstelle dieser Methode.

Tabelle : 40. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 41. 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.print(gdt.getDayOfMonth());

Ausgabe:

GlideDateTime – getDayOfMonthLocalTime()

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

Tabelle : 42. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 43. 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.print(gdt.getDayOfMonthLocalTime());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getDayOfMonthLocalTime() in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getDayOfMonthLocalTime().

GlideDateTime – getDayOfMonthUTC()

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

Tabelle : 44. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 45. 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.print(gdt.getDayOfMonthUTC());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getDayOfMonthUTC() in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getDayOfMonthLocalTime().

GlideDateTime – getDayOfWeek ()

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

Verwenden Sie getDayOfWeekLocalTime() und getDayOfWeekUTC() anstelle dieser Methode.

Tabelle : 46. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 47. Ergebnisse
Typ	Beschreibung
Zahl	Der Wochentagswert – Montag = 1, ... Sonntag = 7.

var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getDayOfWeek());

Ausgabe:

GlideDateTime – getDayOfWeekLocalTime()

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

Tabelle : 48. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 49. Ergebnisse
Typ	Beschreibung
Zahl	Der Wochentagswert – Montag = 1, ... Sonntag = 7

var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getDayOfWeekLocalTime());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getDayOfWeekLocalTime()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getDayOfWeekLocalTime().

GlideDateTime – getDayOfWeekUTC()

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

Tabelle : 50. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 51. Ergebnisse
Typ	Beschreibung
Zahl	Der Wochentagswert – Montag = 1, ... Sonntag = 7

var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getDayOfWeekUTC());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getDayOfWeekUTC()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getDayOfWeekUTC().

GlideDateTime – getDaysInMonth()

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

Verwenden Sie getDaysInMonthLocalTime() und getDaysInMonthUTC() anstelle dieser Methode.

Tabelle : 52. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 53. Ergebnisse
Typ	Beschreibung
Zahl	Die Anzahl der Tage des aktuellen Monats in der Zeitzone der Java Virtual Machine.

var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonth());

Ausgabe:

GlideDateTime – getDaysInMonthLocalTime()

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

Tabelle : 54. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 55. Ergebnisse
Typ	Beschreibung
Zahl	Die Anzahl der Tage des aktuellen Monats in der Zeitzone des Benutzers.

var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonthLocalTime());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getDaysInMonthLocalTime()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getDaysInMonthLocalTime().

GlideDateTime – getDaysInMonthUTC()

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

Tabelle : 56. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 57. 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(); //December
gs.print(gdt.getDaysInMonthUTC());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getDaysInMonthUTC()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getDaysInMonthUTC().

GlideDateTime – getDisplayValue()

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

Hinweis:

Bei Bezug auf das GlideDateTime-Objekt werden Datum und Uhrzeit in der GMT-Zeitzone direkt zurückgegeben.

Tabelle : 58. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 59. Ergebnisse
Typ	Beschreibung
Objekt	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());

Ausgabe:

2011-08-31 01:00:00

Bereichsbezogenes Äquivalent

Um die getDisplayValue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getDisplayValue().

GlideDateTime – getDisplayValueInternal()

Gibt den Anzeigewert im internen Format jjjj-MM-tt HH:mm:ss zurück. Diese Methode ist nützlich für Datums-/Zeitfelder, nicht jedoch für Datumsfelder.

Tabelle : 60. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 61. Ergebnisse
Typ	Beschreibung
Objekt	Die Datums- und Uhrzeitwerte für das GlideDateTime-Objekt. Format: jjjj-MM-tt HH:mm:ss in der Zeitzone des Anrufers.

// The passed in date and time is converted to the caller's time zone.
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDisplayValueInternal());

Ausgabe:

2011-08-31 01:00:00

Bereichsbezogenes Äquivalent

Um die getDisplayValueInternal()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getDisplayValueInternal().

GlideDateTime - getDisplayValueLang(Zeichenfolgestil)

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

Tabelle : 62. 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.

Tabelle : 63. 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 Datumsstilen zurückgegeben.

var gdt = new GlideDateTime(); // This will fetch the current date


gs.info('date: ' + gdt.getDisplayValue());

gs.info('date: ' + gdt.getDisplayValueLang("full"));
gs.info('date: ' + gdt.getDisplayValueLang("long"));
gs.info('date: ' + gdt.getDisplayValueLang("medium"));
gs.info('date: ' + gdt.getDisplayValueLang("short"));

Ausgabe:

date: 2023-01-18 06:49:02
date: Wednesday, January 18, 2023 06:49:02
date: January 18, 2023 06:49:02
date: Jan 18, 2023 06:49:02
date: 1/18/23 06:49:02

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 : 64. 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 : 65. 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

GlideDateTime – getDSTOffset()

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

Tabelle : 66. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 67. 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("2011-08-31 08:00:00");
gs.print(gdt.getDSTOffset());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getDSTOffset()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getDSTOffset().

GlideDateTime – getErrorMsg()

Ruft die aktuelle Fehlermeldung ab.

Tabelle : 68. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 69. Ergebnisse
Typ	Beschreibung
Objekt	Die Fehlermeldung

var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); //bad
gs.print(gdt.isValid()); //false
gs.print(gdt.getErrorMsg()); //reason

Ausgabe:

false
Could not parse DateTime: 2011-aa-31 aa:00:00

Bereichsbezogenes Äquivalent

Um die getErrorMsg()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getErrorMsg().

GlideDateTime – getInternalFormattedLocalTime()

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

Tabelle : 70. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 71. Ergebnisse
Typ	Beschreibung
Objekt	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

Bereichsbezogenes Äquivalent

Um die getInternalFormattedLocalTime()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getInternalFormattedLocalTime().

GlideDateTime – getInternalMidnight(Number dayOfTheWeek)

Gibt ein Datums- und Uhrzeitobjekt zurück, das in UTC auf Mitternacht eines angegebenen Tages festgelegt wurde.

Tabelle : 72. Parameter
Name	Typ	Beschreibung
dayOfTheWeek	Zahl	Der Wochentag, für den das Datums-/Uhrzeitobjekt zurückgegeben werden soll.

Tabelle : 73. Ergebnisse
Typ	Beschreibung
GlideDateTime	Ein GlideDateTime-Objekt, das auf Mitternacht gesetzt ist.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getInternalMidnight(2));

Ausgabe:

2011-08-30 00:00:01

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 : 74. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 75. Ergebnisse
Typ	Beschreibung
GlideDate	Das Datum in der Zeitzone des Benutzers.

In diesem Beispiel wird die Uhrzeit im Zeitformat des Anwenders in der Zeitzone des Anwenders angezeigt.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getLocalDate());

Ausgabe:

2011-08-31

Bereichsbezogenes Äquivalent

Um die getLocalDate()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getLocalDate().

GlideDateTime – getLocalTime()

Ruft die Zeit in der Zeitzone des Benutzers ab.

Tabelle : 76. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 77. Ergebnisse
Typ	Beschreibung
GlideTime	Die Zeit in der Zeitzone des Benutzers.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getLocalTime());

Ausgabe:

1970-01-01 01:00:00

Bereichsbezogenes Äquivalent

Um die getLocalTime()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getLocalTime().

GlideDateTime – getMonth()

Ruft den Monat ab, der vom GlideDateTime-Objekt gespeichert wird, ausgedrückt in der Zeitzone der Java Virtual Machine.

Verwenden Sie getMonthLocalTime() und getMonthUTC() anstelle dieser Methode.

Tabelle : 78. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 79. Ergebnisse
Typ	Beschreibung
Zahl	Der Zahlenwert des Monats, Jan = 1, Dez = 12.

var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonth());

Ausgabe:

GlideDateTime – getMonthLocalTime()

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

Tabelle : 80. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 81. Ergebnisse
Typ	Beschreibung
Zahl	Der Zahlenwert des Monats, Jan = 1, Dez = 12.

var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonthLocalTime());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getMonthLocalTime()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getMonthLocalTime().

GlideDateTime – getMonthUTC()

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

Tabelle : 82. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 83. Ergebnisse
Typ	Beschreibung
Zahl	Der Zahlenwert des Monats, Jan = 1, Dez = 12.

var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonthUTC());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getMonthUTC()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getMonthUTC().

GlideDateTime – getNumericValue()

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

Tabelle : 84. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 85. 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.print(gdt.getNumericValue());

Ausgabe:

1314777600000

GlideDateTime – getSpanTime(Number dayOfWeek)

Ruft die seit Mitternacht eines angegebenen Tages bis zur aktuellen Uhrzeit abgelaufene Zeit ab.

Tabelle : 86. Parameter
Name	Typ	Beschreibung
dayOfWeek	Zahl	Wochentagswert von 1 bis 7. 1 = Montag, 7 = Sonntag.

Tabelle : 87. Ergebnisse
Typ	Beschreibung
GlideTime	Die seit Mitternacht des angegebenen Tages verstrichene Zeit. Um das Ergebnis auf benutzerfreundliche Weise anzuzeigen, setzen Sie den Wert auf GlideDuration.

var gdt = new GlideDateTime("2011-08-31 08:00:00"); //Wednesday
var dur = new GlideDuration();
 
var span = gdt.getSpanTime(1); //how much time since Monday 00:00:00
dur.setValue(span);
gs.print(dur.getDisplayValue());

Ausgabe:

2 Days 8 Hours

GlideDateTime – getTime()

Ruft den Unix-Zeitstempel ab.

Tabelle : 88. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 89. Ergebnisse
Typ	Beschreibung
GlideTime	Der Unix-Zeitstempel im Systemformat basierend auf der GMT-Zeit.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getTime());

Ausgabe:

1970-01-01 08:00:00

Bereichsbezogenes Äquivalent

Um die getTime()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getTime().

GlideDateTime – getTZOffset()

Ruft die Zeitzonenverschiebung in Millisekunden ab.

Tabelle : 90. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 91. Ergebnisse
Typ	Beschreibung
Zahl	Die Anzahl der Millisekunden der Zeitzonenverschiebung.

var gdt = new GlideDateTime();
gdt.getLocalTime(); // PST local time
gs.print(gdt.getTZOffset());

Ausgabe:

-28800000

Bereichsbezogenes Äquivalent

Um die getTZOffset()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getTZOffset().

GlideDateTime – getUserFormattedLocalTime()

Gibt die Zeit des Objekts in der lokalen Zeitzone im Benutzerformat zurück.

Tabelle : 92. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 93. Ergebnisse
Typ	Beschreibung
Objekt	Die Uhrzeit des Objekts in Ortszeit und im Format des Benutzers.

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

Bereichsbezogenes Äquivalent

Um die getUserFormattedLocalTime()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getUserFormattedLocalTime().

GlideDateTime – getUserTimeZone ()

Ruft die Zeitzone für die aktuelle Benutzersitzung ab.

Diese Methode entspricht gs.getSession().getTimeZone().

Tabelle : 94. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 95. Ergebnisse
Typ	Beschreibung
TimeZone	Zeitzonenobjekt für den aktuellen Benutzer.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getUserTimeZone());

Ausgabe:

sun.util.calendar.ZoneInfo[id="America/Los_Angeles",offset=-28800000,dstSavings=3600000,useDaylight=true,transitions=185,
lastRule=java.util.SimpleTimeZone[id=America/Los_Angeles,offset=-28800000,dstSavings=3600000,useDaylight=true,startYear=0,startMode=3,
startMonth=2,startDay=8,startDayOfWeek=1,startTime=7200000,startTimeMode=0,endMode=3,endMonth=10,endDay=1,endDayOfWeek=1,
endTime=7200000,endTimeMode=0]]

GlideDateTime – getUTCMidnight(Number dayOfTheWeek)

Ruft ein GlideDateTime-Objekt mit der auf Mitternacht eingestellten Zeit mit der UTC-Zeitzone ab.

Diese Methode legt das Datum des neuen GlideDateTime-Objekts als den angegebenen Wochentag innerhalb der Woche des ursprünglichen GlideDateTime-Objekts fest.

Tabelle : 96. Parameter
Name	Typ	Beschreibung
dayOfTheWeek	Zahl	Wochentag von 1 bis 7 Uhr. Montag = 1, Sonntag = 7. Geben Sie in diesem Parameter nicht 0 ein.

Tabelle : 97. Ergebnisse
Typ	Beschreibung
GlideDateTime	Ein neues GlideDateTime-Objekt, das auf Mitternacht gesetzt ist.

var gdt = new GlideDateTime("2011-08-31 08:00:00"); // Wednesday, 3rd day of the week.
gs.print(gdt.getUTCMidnight(5)); //Friday, 5th day of the week.

Ausgabe:

2011-09-02 00:00:00

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 : 98. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 99. 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("2011-08-31 08:00:00");
gs.info(gdt.getValue());

Ausgabe:

2011-08-31 08:00:00

Bereichsbezogenes Äquivalent

Um die getValue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getValue().

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 : 100. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 101. 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");
gs.print(gdt.getWeekOfYearUTC());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getWeekOfYearLocalTime()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getWeekOfYearLocalTime().

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 : 102. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 103. 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");
gs.print(gdt.getWeekOfYearUTC());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getWeekOfYearUTC()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getWeekOfYearUTC().

GlideDateTime – getYear()

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

Verwenden Sie getYearLocalTime() und getYearUTC() anstelle dieser Methode.

Tabelle : 104. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 105. Ergebnisse
Typ	Beschreibung
Zahl	Der vierstellige Jahreswert in der Zeitzone der Java Virtual Machine.

var gdt = new GlideDateTime(); //2011
gs.print(gdt.getYear());

Ausgabe:

GlideDateTime – getYearLocalTime()

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

Tabelle : 106. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 107. Ergebnisse
Typ	Beschreibung
Zahl	Der vierstellige Jahreswert in der Zeitzone des Benutzers.

var gdt = new GlideDateTime(); //2011
gs.print(gdt.getYearLocalTime());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getYearLocalTime()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getYearLocalTime().

GlideDateTime – getYearUTC()

Gibt das Jahr zurück, das im GlideDateTime-Objekt gespeichert wurde, ausgedrückt in der UTC-Zeitzone.

Tabelle : 108. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 109. Ergebnisse
Typ	Beschreibung
Nummer	Vierstelliger Jahreswert in der UTC-Zeitzone.

var gdt = new GlideDateTime(); //2011
gs.info(gdt.getYearUTC());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die getYearUTC()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getYearUTC().

GlideDateTime – hasDate()

Bestimmt, ob das Datum eines Objekts festgelegt ist.

Tabelle : 110. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 111. Ergebnisse
Typ	Beschreibung
Boolean	„True“, wenn das Datum des Objekts festgelegt ist, andernfalls „false“.

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.hasDate());

Ausgabe:

true

Bereichsbezogenes Äquivalent

Um die hasDate()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: hasDate().

GlideDateTime – isDST()

Bestimmt, ob die Zeit des Objekts eine Sommerzeitverschiebung verwendet

Tabelle : 112. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 113. Ergebnisse
Typ	Beschreibung
Boolean	„True“, wenn es sich um Sommerzeit handelt, andernfalls „false“.

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

Ausgabe:

true

Bereichsbezogenes Äquivalent

Um die isDST()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: isDST().

GlideDateTime – isValid()

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

Tabelle : 114. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 115. Ergebnisse
Typ	Beschreibung
Boolean	„True“, wenn Wert gültig ist, andernfalls „false“.

var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); 
gs.print(gdt.isValid()); //true
gs.print(gdt.getErrorMsg()); //reason

Ausgabe

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

Bereichsbezogenes Äquivalent

Um die isValid()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: isValid().

GlideDateTime – setDayOfMonth(Number day)

Legt den Tag des Monats auf einen angegebenen Wert fest.

Verwenden Sie setDayOfMonthLocalTime() und setDayOfMonthUTC() anstelle dieser Methode.

Tabelle : 116. Parameter
Name	Typ	Beschreibung
day	Zahl	Tag des Monats von 1 bis 31.

Tabelle : 117. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime();
gdt.setDayOfMonth(9);
gs.print(gdt.getDayOfMonth());

Ausgabe:

GlideDateTime – setDayOfMonthLocalTime(Number day)

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

Tabelle : 118. 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 : 119. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime();
gdt.setDayOfMonthLocalTime(9);
gs.print(gdt.getDayOfMonthLocalTime());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die setDayOfMonthLocalTime()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: setDayOfMonthLocalTime().

GlideDateTime – setDayOfMonthUTC(Number day)

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

Tabelle : 120. 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 : 121. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime();
gdt.setDayOfMonthUTC(9);
gs.print(gdt.getDayOfMonthUTC());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die setDayOfMonthUTC()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: setDayOfMonthUTC().

GlideDateTime – setDisplayValue(String asDisplayed)

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

Tabelle : 122. 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. Verwenden Sie `<Variable>.setDisplayValue(gs.nowDateTime);`, um das aktuelle Datum und die aktuelle Uhrzeit einer Variable in einem Workflow-Skript zuzuweisen.

Tabelle : 123. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValue("2011-01-01 12:00:00");
gs.print(gdt.getValue());

Ausgabe:

2011-01-01 20:00:00

Bereichsbezogenes Äquivalent

Um die setDisplayValue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setDisplayValue().

GlideDateTime – setDisplayValue(String dateTime, 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 dateTime-Parameter verwendete Datums- und Zeitformat nicht mit dem Formatparameter übereinstimmt. Sie können die Fehlermeldung durch Aufrufen von getErrorMsg() für das GlideDateTime-Objekt abrufen, nachdem die Ausnahme abgefangen wurde.

Tabelle : 124. Parameter
Name	Typ	Beschreibung
dateTime	Zeichenfolge	Datum und Uhrzeit in der Zeitzone des aktuellen Benutzers.
format	Zeichenfolge	Das Format, das zum Parsen des DateTime-Parameters verwendet wird.

Tabelle : 125. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss");
gs.print(gdt.getValue());

Ausgabe:

2011-05-20 19:00:00

Bereichsbezogenes Äquivalent

Um die setDisplayValue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setDisplayValue().

GlideDateTime – setDisplayValueInternal(String dateTime)

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

Tabelle : 126. Parameter
Name	Typ	Beschreibung
dateTime	Zeichenfolge	Datum und Uhrzeit im internen Format

Tabelle : 127. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValueInternal("2011-01-01 12:00:00");
gs.print(gdt.getValue());

Ausgabe:

2011-01-01 20:00:00

Bereichsbezogenes Äquivalent

Um die setDisplayValueInternal()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setDisplayValueInternal().

GlideDateTime – setDisplayValueInternalWithAlternates(String dateTime)

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

Diese Methode versucht, unvollständige Datums- und Uhrzeitwerte zu parsen.

Tabelle : 128. Parameter
Name	Typ	Beschreibung
dateTime	Zeichenfolge	Datum und Uhrzeit im internen Format.

Tabelle : 129. Ergebnisse
Typ	Beschreibung
void

GlideDateTime - setDisplayValueLang(String dateTime, Zeichenfolgenstil)

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

Tabelle : 130. 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 : 131. 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

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 : 132. 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 : 133. 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

GlideDateTime – setGlideDateTime(GlideDateTime gDT)

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 : 134. Parameter
Name	Typ	Beschreibung
gDT	GlideDateTime	Ein GlideDateTime-Objekt

Tabelle : 135. Ergebnisse
Typ	Beschreibung
void

var dt1 = new GlideDateTime("2011-01-01 12:00:00");
var dt2 = new GlideDateTime("2011-02-02 08:00:00");
dt1.setGlideDateTime(dt2);
gs.print(dt1.getValue());

Ausgabe:

2011-02-02 08:00:00

Bereichsbezogenes Äquivalent

Um die setGlideDateTime-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: setGlideDateTime.

GlideDateTime – setInitialValue(String dateTime)

Legt das Datum und die Uhrzeit fest.

Diese Methode entspricht setValue(Object).

Tabelle : 136. Parameter
Name	Typ	Beschreibung
dateTime	Zeichenfolge	Das Datum und die Uhrzeit, die verwendet werden sollen. Akzeptiert entweder eine Zeichenfolge in der GMT-Zeitzone im internen Format oder ein GlideDateTime-Objekt.

Tabelle : 137. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime();
gdt.setInitialValue("2011-01-01 12:00:00");
gs.print(gdt.getValue());

Ausgabe:

2011-01-01 12:00:00

GlideDateTime – setMonth(Number month)

Legt den vom GlideDateTime-Objekt gespeicherten Monat mit der Zeitzone der Java Virtual Machine auf einen angegebenen Wert fest.

Verwenden Sie setMonthLocalTime() und setMonthUTC() anstelle dieser Methode.

Tabelle : 138. Parameter
Name	Typ	Beschreibung
month	Zahl	Der Monat, zu dem Sie wechseln möchten

Tabelle : 139. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime();
gdt.setMonth(1);
gs.print(gdt.getMonth());

Ausgabe:

GlideDateTime – setMonthLocalTime(Number month)

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

Tabelle : 140. Parameter
Name	Typ	Beschreibung
month	Zahl	Der Monat, zu dem Sie wechseln möchten

Tabelle : 141. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime();
gdt.setMonthLocalTime(1);
gs.print(gdt.getMonthLocalTime());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die setMonthLocalTime()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setMonthLocalTime().

GlideDateTime – setMonthUTC (Number month)

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

Tabelle : 142. Parameter
Name	Typ	Beschreibung
month	Zahl	Der Monat, zu dem Sie wechseln möchten

Tabelle : 143. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime();
gdt.setMonthUTC(1);
gs.print(gdt.getMonthUTC());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die Methode setMonthUTC() in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setMonthUTC().

GlideDateTime – setNumericValue(Number milliseconds)

Legt Datum und Uhrzeit auf die Anzahl der Millisekunden seit dem 1. Januar 1970 um 00:00:00 GMT fest.

Tabelle : 144. Parameter
Name	Typ	Beschreibung
milliseconds	Zahl	Anzahl der Millisekunden

Tabelle : 145. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime();
gdt.setNumericValue(1314777600000);
gs.print(gdt.getValue());

Ausgabe:

2011-08-31 08:00:00

GlideDateTime – setTZ(TimeZone timeZone)

Legt die Zeitzone des GlideDateTime-Objekts als festgelegte Zeitzone fest.

Tabelle : 146. Parameter
Name	Typ	Beschreibung
timeZone	TimeZone	Ein Zeitzonenobjekt

Tabelle : 147. Ergebnisse
Typ	Beschreibung
void

var tz = gs.getSession().getTimeZone();
var gdt = new GlideDateTime(); 
gdt.setTZ(tz);

GlideDateTime – setValue(Object dateTime)

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

Diese Methode entspricht setInitialValue().

Tabelle : 148. Parameter
Name	Typ	Beschreibung
dateTime	Objekt	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 angegebene Uhrzeit fest. Die Verwendung dieser Methode entspricht der Instantiierung eines neuen GlideDateTime-Objekts mithilfe des GlideDateTime(value)-Konstruktors. 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(dateTime, format). Ein GlideDateTime-Objekt: Legt den Wert des Objekts auf Datum und Uhrzeit fest, die von der im Parameter übergebenen GlideDateTime gespeichert werden. Die Verwendung dieser Methode entspricht der Instantiierung eines neuen GlideDateTime-Objekts mithilfe des GlideDateTime(g)-Konstruktors. Ein Java Date-Objekt: Legt den Wert des Objekts anhand des vom Java Date-Objekt gespeicherten Werts fest. Die Verwendung der Methode auf diese Weise entspricht der Übergabe des vom Java Date-Objekt getTime() zurückgegebenen Werts an die GlideDateTime-Methode setNumericValue(). Diese Methode akzeptiert keine JavaScript-Date-Objekte. Eine JavaScript-Zahl: Legt den Wert des Objekts mit dem Zahlenwert als Millisekunden nach dem 1. Januar 1970 00:00:00 UTC fest. Die Verwendung der Methode auf diese Weise entspricht der Methode setNumericValue(milliseconds). Eine Java-Ganzzahl oder lang: Legt den Wert des Objekts mit dem Ganzzahl- oder Langwert als Millisekunden nach dem 1. Januar 1970 00:00:00 UTC fest. Die Verwendung der Methode auf diese Weise entspricht der Methode setNumericValue(milliseconds).

Tabelle : 149. Ergebnisse
Typ	Beschreibung
void

Legen Sie Datum und Uhrzeit mithilfe einer Zeichenfolge im Format jjjj-MM-tt HH:mm:ss fest.

var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValue("2011-02-02 08:00:00");
gs.print(gdt.getValue());

Ausgabe:

2011-02-02 08:00:00

Legen Sie Datum und Uhrzeit mithilfe eines vorhandenen GlideDateTime-Objekts fest.

var gdtSource = new GlideDateTime("2017-05-23 11:37:41");
var gdtDest = new GlideDateTime();
gdtDest.setValue(gdtSource);
gs.print(gdtDest.getValue());

Ausgabe:

2017-05-23 11:37:41

Legen Sie Datum und Uhrzeit mit einer Zahl fest, die Millisekunden nach dem 1. Januar 1970 um 00:00:00 UTC angibt.

var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValue(1617634522375);
gs.print(gdt.getValue());

Ausgabe:

2021-04-05 14:55:22

Bereichsbezogenes Äquivalent

Um die setValue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setValue().

GlideDateTime – setValueUTC(String dateTime, 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 dateTime-Parameter verwendete Datums- und Zeitformat nicht mit dem Formatparameter übereinstimmt. Sie können die Fehlermeldung durch Aufrufen von getErrorMsg() für das GlideDateTime-Objekt abrufen, nachdem die Ausnahme abgefangen wurde.

Tabelle : 150. Parameter
Name	Typ	Beschreibung
dateTime	Zeichenfolge	Das Datum und die Uhrzeit, die verwendet werden sollen.
format	Zeichenfolge	Das Format, das verwendet werden soll.

Tabelle : 151. Ergebnisse
Typ	Beschreibung
void

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.print(gdt.getValue());

Ausgabe:

2011-02-15 08:00:00

Bereichsbezogenes Äquivalent

Um die setValueUTC()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: setValueUTC().

GlideDateTime – setYear(Number year)

Legt das vom GlideDateTime-Objekt gespeicherte Jahr mit der Zeitzone der Java Virtual Machine auf einen angegebenen Wert fest.

Verwenden Sie setYearLocalTime() und setYearUTC() anstelle dieser Methode.

Tabelle : 152. Parameter
Name	Typ	Beschreibung
year	Zahl	Das Jahr, zu dem Sie wechseln möchten.

Tabelle : 153. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime();
gdt.setYear(2013);
gs.print(gdt.getYear());

Ausgabe:

GlideDateTime – setYearLocalTime(Number year)

Legt das vom GlideDateTime-Objekt gespeicherte Jahr auf einen angegebenen Wert in der Zeitzone des aktuellen Benutzers fest.

Tabelle : 154. Parameter
Name	Typ	Beschreibung
year	Zahl	Das Jahr, zu dem Sie wechseln möchten.

Tabelle : 155. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime();
gdt.setYearLocalTime(2013);
gs.print(gdt.getYearLocalTime());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die setYearLocalTime()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: setYearLocalTime().

GlideDateTime – setYearUTC(Number year)

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

Tabelle : 156. Parameter
Name	Typ	Beschreibung
year	Zahl	Das Jahr, zu dem Sie wechseln möchten.

Tabelle : 157. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime();
gdt.setYearUTC(2013);
gs.print(gdt.getYearUTC());

Ausgabe:

Bereichsbezogenes Äquivalent

Um die setYearUTC()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: setYearUTC().

GlideDateTime – subtract(GlideTime time)

Subtrahiert eine bestimmte Zeitdauer.

Tabelle : 158. Parameter
Name	Typ	Beschreibung
time	GlideTime	Die Zeit, die abgezogen werden soll

Tabelle : 159. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.subtract(gtime1);
gs.print(gdt.getTime());

Ausgabe:

1970-01-01 07:59:40

Bereichsbezogenes Äquivalent

Um die subtract()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: subtract().

GlideDateTime – subtract(Number milliseconds)

Subtrahiert eine angegebene Anzahl von Millisekunden vom GlideDateTime-Objekt.

Tabelle : 160. Parameter
Name	Typ	Beschreibung
milliseconds	Zahl	Die Anzahl der Millisekunden, die subtrahiert werden sollen.

Tabelle : 161. Ergebnisse
Typ	Beschreibung
void

var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.subtract(1000);
gs.print(gdt.getValue());

Ausgabe:

2011-12-07 07:59:59

Bereichsbezogenes Äquivalent

Um die subtract()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: subtract().

GlideDateTime – subtract(GlideDateTime start, GlideDateTime end)

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

Tabelle : 162. Parameter
Name	Typ	Beschreibung
start	GlideDateTime	Startdatumsobjekt.
end	GlideDateTime	Enddatumsobjekt.

Tabelle : 163. 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); // Difference between gdt1 and gdt2
gs.info(dur.getDisplayValue());

Ausgabe:

2 Days 23 Hours

Bereichsbezogenes Äquivalent

Um die subtract()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: subtract().

GlideDateTime – toString()

Gibt den Datums- und Uhrzeitwert zurück, 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 : 164. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 165. Ergebnisse
Typ	Beschreibung
Objekt	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.print(gdt.toString());

Ausgabe:

2011-08-31 08:00:00

Bereichsbezogenes Äquivalent

Um die toString()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: toString().