GlideDateTime : Bereichsbezogen
Die bereichsbezogene GlideDateTime- Klasse bietet Methoden zum Ausführen von Vorgängen für GlideDateTime-Objekte.
Verwenden Sie die GlideDateTime -Methoden für Datum/Uhrzeit-Vorgänge, z. B. das Instanziieren eines GlideDateTime-Objekts, Datum/Uhrzeit-Berechnungen, Formatieren von Datum/Uhrzeit oder Konvertieren zwischen Datum/Uhrzeit-Formaten.
Anleitungen zu Datums-/Uhrzeiteingabezeichenfolgen mit einer Liste häufiger Formatkonflikte finden Sie unter Richtlinien für das Datums- und Uhrzeitformat.
Scoped GlideDateTime – GlideDateTime()
Instanziiert ein neues GlideDateTime -Objekt mit dem aktuellen Datum und der aktuellen Uhrzeit.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
In diesem Beispiel wird ein GlideDateTime- Objekt instanziiert.
var gdt = new GlideDateTime();
gs.info(gdt);
Ausgabe:
2022-08-08 16:51:44
Scoped GlideDateTime – GlideDateTime(String value)
Instanziiert ein neues GlideDateTime- Objekt anhand des übergebenen Datums- und Uhrzeitwerts.
- 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
- jjjj-MM-tt'T'HH:mm:ss.SSANZ
| Name | Typ | Beschreibung |
|---|---|---|
| Wert | Zeichenfolge | UTC-Datum und -Uhrzeit, die im GlideDateTime- Objekt festgelegt werden sollen. |
In diesem Beispiel wird gezeigt, wie ein GlideDateTime- Objekt mithilfe einer Zeichenfolge instanziiert wird.
var gdt = new GlideDateTime("2023-01-01 12:00:00");
gs.info(gdt);
Ausgabe:
2023-01-01 12:00:00
Scoped GlideDateTime – GlideDateTime(GlideDateTime g)
Instanziiert ein neues GlideDateTime- Objekt, das auf die Zeit eines angegebenen GlideDateTime- Objekts festgelegt ist.
| Name | Typ | Beschreibung |
|---|---|---|
| g | GlideDateTime | Objekt, das zum Einstellen der Uhrzeit des neuen Objekts verwendet wird. |
Dieses Beispiel zeigt, wie ein GlideDateTime- Objekt (gdt1) mit einer Zeichenfolge im Format jjjj-MM-tt HH:mm:ssund ein zweites GlideDateTime- Objekt (gdt2) mit gdt1 instanziiert werden.
var gdt1 = new GlideDateTime("2025-01-28 12:00:00"); // GlideDateTime(String g)
var gdt2 = new GlideDateTime(gdt1); // GlideDateTime(GlideDateTime g)
gs.info(gdt1);
gs.info(gdt2);
Ausgabe:
2025-01-28 12:00:00
2025-01-28 12:00:00
Scoped GlideDateTime – add(GlideTime gd)
Fügt dem aktuellen GlideDateTime-Objekt ein GlideTime-Objekt hinzu.
| Name | Typ | Beschreibung |
|---|---|---|
| gd | GlideTime | GlideTime-Objekt, dessen Zeitwert zum angegebenen GlideDateTime-Objekt addiert werden soll. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.add(gtime1);
var gtime2 = gdt.getTime();
gs.info(gtime2.getByFormat('hh:mm:ss'));
Ausgabe:
08:00:20
Scoped GlideDateTime – add(Number milliseconds)
Fügt dem aktuellen GlideDateTime-Objekt die angegebene Anzahl von Millisekunden hinzu.
| Name | Typ | Beschreibung |
|---|---|---|
| milliseconds | Zahl | Die Anzahl der Millisekunden, die hinzugefügt werden sollen. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getNumericValue());
gdt.add(10);
gs.info(gdt.getNumericValue());
1314777600000 1314777600010Scoped 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.
| Name | Typ | Beschreibung |
|---|---|---|
| days | Zahl | Die Anzahl der Tage, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysLocalTime(-1);
gs.info(gdt.getLocalDate());
Ausgabe:
2011-08-30
Scoped GlideDateTime – addDaysUTC(Number days)
Fügt eine angegebene Anzahl an Tagen zum aktuellen GlideDateTime-Objekt hinzu. Ein negativer Parameter zieht Tage ab. Die Methode ermittelt das UTC-Datum und die UTC-Zeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Tage unter Verwendung der UTC-Datums- und Uhrzeitwerte.
| Name | Typ | Beschreibung |
|---|---|---|
| days | Zahl | Die Anzahl der Tage, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren eine negative Zahl. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysUTC(-1);
gs.info(gdt.getDate());
Ausgabe:
2011-08-30
Scoped GlideDateTime – addMonthsLocalTime(Number months)
Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Monaten hinzu. Ein negativer Parameter zieht Monate ab. Die Methode ermittelt das lokale Datum und die lokale Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Monate mit den lokalen Datums- und Uhrzeitwerten.
| Name | Typ | Beschreibung |
|---|---|---|
| months | Zahl | Die Anzahl der Monate, die hinzugefügt werden sollen. Verwenden Sie zum Abzug einen negativen Wert. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsLocalTime(2);
gs.info(gdt.getDate());
Ausgabe:
2011-10-31
Scoped GlideDateTime – addMonthsUTC(Number months)
Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Monaten hinzu. Ein negativer Parameter zieht Monate ab. Die Methode ermittelt das UTC-Datum und die UTC-Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann die Monate mit den UTC-Datums- und -Uhrzeitwerten.
| Name | Typ | Beschreibung |
|---|---|---|
| months | Zahl | Die Anzahl der Monate, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsUTC(2);
gs.info(gdt.getDate());
Ausgabe:
2011-10-31
Scoped GlideDateTime – addSeconds(Number seconds)
Fügt dem aktuellen GlideDateTime-Objekt die angegebene Anzahl von Sekunden hinzu.
| Name | Typ | Beschreibung |
|---|---|---|
| seconds | Zahl | Die Anzahl der Sekunden, die hinzugefügt werden sollen. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.addSeconds(1000);
gs.info(gdt.getValue());
Ausgabe:
2011-12-07 08:16:40
Scoped GlideDateTime – addWeeksLocalTime (Number weeks)
Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Wochen hinzu. Ein negativer Parameter zieht Wochen ab. Die Methode ermittelt das lokale Datum und die lokale Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann die Wochen mit den lokalen Datums- und Uhrzeitwerten.
| Name | Typ | Beschreibung |
|---|---|---|
| weeks | Zahl | Die Anzahl der Wochen, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksLocalTime(-1);
gs.info(gdt.getDate());
Ausgabe:
2011-08-24
Scoped GlideDateTime – addWeeksUTC(Number weeks)
Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Wochen hinzu. Ein negativer Parameter zieht Wochen ab. Die Methode ermittelt das UTC-Datum und die UTC-Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann Wochen mit den UTC-Datums- und Uhrzeitwerten.
| Name | Typ | Beschreibung |
|---|---|---|
| weeks | Zahl | Die Anzahl der Wochen, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksUTC(-1);
gs.info(gdt.getDate());
Ausgabe:
2011-08-24
Scoped GlideDateTime – addYearsLocalTime(Number years)
Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Jahren hinzu. Ein negativer Parameter zieht Jahre ab. Die Methode ermittelt das lokale Datum und die lokale Uhrzeit, die dem vom GlideDateTime-Objekt gespeicherten Wert entsprechen, und addiert oder subtrahiert dann die Jahre mit den lokalen Datums- und Uhrzeitwerten.
| Name | Typ | Beschreibung |
|---|---|---|
| years | Zahl | Die Anzahl der Jahre, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsLocalTime(1);
gs.info(gdt.getDate());
Ausgabe:
2011-08-31
Scoped GlideDateTime – addYearsUTC(Number years)
Fügt dem aktuellen GlideDateTime-Objekt eine angegebene Anzahl von Jahren hinzu. Ein negativer Parameter zieht Jahre ab. Der Datums- und Uhrzeitwert, der vom GlideDateTime-Objekt gespeichert wird, wird als in der UTC-Zeitzone interpretiert.
| Name | Typ | Beschreibung |
|---|---|---|
| years | Zahl | Die Anzahl der Jahre, die hinzugefügt werden sollen. Verwenden Sie zum Subtrahieren einen negativen Wert. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsUTC(1);
gs.info(gdt.getDate());
Ausgabe:
2011-08-31
Scoped GlideDateTime – after(GlideDateTime gdt)
Bestimmt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts nach dem Datum und der Uhrzeit des angegebenen Objekts liegen.
| Name | Typ | Beschreibung |
|---|---|---|
| gDT | GlideDateTime | Datum und Uhrzeit für den Abgleich. |
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts nach dem vom Parameter angegebenen Datum und der angegebenen Uhrzeit liegen. Mögliche Werte:
|
var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.after(gdt2));
Ausgabe:
False
Scoped GlideDateTime – before(GlideDateTime gdt)
Bestimmt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts vor dem Datum und der Uhrzeit des angegebenen GlideDateTime-Objekts liegen.
| Name | Typ | Beschreibung |
|---|---|---|
| gDT | GlideDateTime | Datum und Uhrzeit für den Abgleich. |
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts vor dem vom Parameter angegebenen Datum und Uhrzeit liegen. Mögliche Werte:
|
var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.before(gdt2));
Ausgabe
true
Scoped GlideDateTime – compareTo(Object o)
Vergleicht zwei Datums- und Uhrzeitobjekte, um festzustellen, ob sie gleichwertig sind oder vor- oder nacheinander auftreten.
| Name | Typ | Beschreibung |
|---|---|---|
| o | Objekt | Datums- und Uhrzeitobjekt im GlideDateTime-Format |
| Typ | Beschreibung |
|---|---|
| Zahl |
|
var initDate = new GlideDateTime("2011-08-01 12:00:00");
var compDate1 = new GlideDateTime("2011-08-01 12:00:00");
var compDate2 = new GlideDateTime("2011-07-31 12:00:00");
var compDate3 = new GlideDateTime("2011-08-04 16:00:00");
gs.info(initDate.compareTo(compDate1)); // Equals (0)
gs.info(initDate.compareTo(compDate2)); // initDate is after compDate2 (1)
gs.info(initDate.compareTo(compDate3)); // initDate is before compDate3 (-1)
Ausgabe:
0
1
-1
Scoped GlideDateTime – equals(Object dateTime)
Vergleicht eine Datumszeit mit einem vorhandenen Wert auf Gleichheit.
| Name | Typ | Beschreibung |
|---|---|---|
| dateTime | GlideDateTime-Objekt oder Zeichenfolge | Die Datumszeit, die verglichen werden soll. |
| Typ | Beschreibung |
|---|---|
| Boolean | Gibt „true“ zurück, wenn sie gleich sind, ansonsten „false“. |
var gdt = new GlideDateTime("2011-08-31 00:00:00");
gs.info(gdt.equals("2011-09-30 00:12:01"));
Ausgabe:
false
Scoped GlideDateTime – getDate()
Gibt das vom GlideDateTime-Objekt gespeicherte Datum zurück. Ausgedrückt im Standardformat jjjj-MM-tt und in der Zeitzone des Systems (standardmäßig GMT).
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Objekt | Datum in der Systemzeitzone. |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDate());
Ausgabe:
2011-08-31
Scoped GlideDateTime – getDayOfMonthLocalTime()
Ruft den Tag des Monats ab, der vom GlideDateTime-Objekt gespeichert wird, ausgedrückt in der Zeitzone des aktuellen Benutzers.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Der Tag des Monats in der Zeitzone des Benutzers, von 1 bis 31. |
var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthLocalTime());
Ausgabe:
2
Scoped GlideDateTime – getDayOfMonthUTC()
Ruft den Tag des Monats ab, der vom GlideDateTime-Objekt gespeichert wird, ausgedrückt in der UTC-Zeitzone.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Der Tag des Monats in der UTC-Zeitzone, von 1 bis 31. |
var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthUTC());
Ausgabe:
02
Scoped GlideDateTime – getDayOfWeekLocalTime()
Ruft den Wochentag ab, der vom GlideDateTime-Objekt gespeichert wird, ausgedrückt in der Zeitzone des Benutzers.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Der Wochentagswert in der Zeitzone des Benutzers von 1 bis 7. Montag entspricht 1, Sonntag entspricht 7. |
var gdt = new GlideDateTime("2011-12-01 12:00:00");//Thursday
gs.info(gdt.getDayOfWeekLocalTime());
Ausgabe:
4
Scoped GlideDateTime – getDayOfWeekUTC()
Gibt den vom GlideDateTime-Objekt gespeicherten Wochentag zurück, ausgedrückt in der UTC-Zeitzone.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Nummer | Wochentagswert von 1 bis 7. Montag entspricht 1, Sonntag entspricht 7. |
var gdt = new GlideDateTime("2011-12-01 12:00:00"); //Thursday
gs.info(gdt.getDayOfWeekUTC());
Ausgabe:
4
Scoped GlideDateTime – getDaysInMonthLocalTime()
Ruft die vom GlideDateTime-Objekt gespeicherte Anzahl von Tagen im Monat ab, die in der Zeitzone des aktuellen Benutzers angegeben ist.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Die Anzahl der Tage des aktuellen Monats in der Zeitzone des Benutzers. |
var gdt = new GlideDateTime("2011-12-02 12:00:00"); //December
gs.info(gdt.getDaysInMonthLocalTime());
Ausgabe:
30
Scoped GlideDateTime – getDaysInMonthUTC()
Ruft die Anzahl der Tage des Monats ab, die vom GlideDateTime-Objekt gespeichert werden, ausgedrückt in der UTC-Zeitzone.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Die Anzahl der Tage im Monat, die vom GlideDateTime-Objekt gespeichert werden, ausgedrückt in der UTC-Zeitzone. |
var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getDaysInMonthUTC());
Ausgabe:
30
Scoped GlideDateTime – getDisplayValue()
Ruft den Datums- und Uhrzeitwert im Anzeigeformat und in der Zeitzone des aktuellen Benutzers ab.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Datum und Uhrzeit im Format und in der Zeitzone des Anwenders. Denken Sie beim Entwerfen von Business Rules oder Skripteinbindungen daran, dass diese Methode Werte in verschiedenen Formaten für verschiedene Benutzer zurückgeben kann. |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDisplayValue()); //uses current user session time zone (US/Pacific)
Ausgabe:
2011-08-31 01:00:00
Scoped GlideDateTime – getDisplayValueInternal()
Ruft den Anzeigewert im internen Format ab (JJJJ-MM-TT hh:mm:ss).
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Die Datums- und Uhrzeitwerte für das GlideDateTime-Objekt in der Zeitzone des aktuellen Benutzers und im internen Datums- und Uhrzeitformat JJJJ-MM-TT hh:mm:ss. |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDisplayValueInternal()); //uses current user session time zone (US/Pacific)
Ausgabe:
2011-08-31 01:00:00
Bereichsbezogene GlideDateTime - getDisplayValueLang(Zeichenfolgenstil, Zeichenfolgensprache)
Gibt einen Datums- und Uhrzeitwert im Gebietsschema des aktuellen Anwenders gemäß einer angegebenen Sprache und einem angegebenen Datumsstil zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Stil | Zeichenfolge | Gibt das Format für Datum und Uhrzeit an. Gültige Werte:
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. |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Eine Zeichenfolgendarstellung des Datums im angegebenen Stil und im entsprechenden Format für das Gebietsschema des aktuellen Anwenders. |
Im folgenden Beispiel werden Datum und Uhrzeit des Gebietsschemas des Anwenders in allen Sprach- und Datumsstilen zurückgegeben.
var gdt = new GlideDateTime(); // This will fetch the current date
gs.info('date: ' + gdt.getDisplayValue());
gs.info('date: ' + gdt.getDisplayValueLang("full", "fr"));
gs.info('date: ' + gdt.getDisplayValueLang("long", "en-GB"));
gs.info('date: ' + gdt.getDisplayValueLang("medium", "de"));
gs.info('date: ' + gdt.getDisplayValueLang("short", "es-MX"));```
Ausgabe:
date: 2023-01-18 06:49:02
mercredi 18 janvier 2023 06:49:02
18 January 2023 06:49:02
18.01.2023 06:49:02
18/01/23 06:49:02
Scoped GlideDateTime – getDSTOffset()
Ruft die Zeit ab, um die die Sommerzeit verschoben ist.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Zeit in Millisekunden, um die die Sommerzeit verschoben ist. Gibt 0 zurück, wenn die Zeit nicht verschoben ist oder wenn es sich nicht um Sommerzeit handelt. |
var gdt = new GlideDateTime("2014-08-31 08:00:00");
gs.info(gdt.getDSTOffset()); //uses current user session time zone (US/Pacific)
Ausgabe:
3600000
Scoped GlideDateTime – getErrorMsg()
Ruft die aktuelle Fehlermeldung ab.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Objekt | Die Fehlermeldung. |
var gdt = new GlideDateTime();
gdt.setDisplayValue("2011-aa-01 00:00:00");
gs.info(gdt.getErrorMsg());
Ausgabe:
Could not parse DateTime: 2011-aa-01 00:00:00
Scoped GlideDateTime – getInternalFormattedLocalTime()
Gibt die Zeit des Objekts in der lokalen Zeitzone und im internen Format zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Die Uhrzeit des Objekts in der lokalen Zeitzone und dem internen Format. |
In diesem Beispiel wird die Uhrzeit im Systemzeitformat der Zeitzone des Anwenders angezeigt.
var gdt = new GlideDateTime('2022-10-08 01:00:00');
gs.info(gdt.getDisplayValue());
gs.info(gdt.getInternalFormattedLocalTime());
Ausgabe
2022-10-07 06:00:00 PM
18:00:00
Scoped GlideDateTime – getLocalDate()
Ruft das vom GlideDateTime-Objekt gespeicherte Datum ab, das im Standardformat (JJJJ-MM-TT) und in der Zeitzone des aktuellen Benutzers angegeben ist.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | |
|---|---|
| GlideDate | Das Datum in der Zeitzone des Benutzers. |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getLocalDate());
Ausgabe:
2011-08-31
Scope GlideDateTime – getLocalTime()
Gibt ein GlideTime-Objekt zurück, das den Zeitabschnitt des GlideDateTime-Objekts in der Zeitzone des Benutzers darstellt.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| GlideTime | Die Zeit in der Zeitzone des Benutzers. |
var gdt = new GlideDateTime("2014-08-31 08:00:00");
gt = gdt.getLocalTime();
gs.info("local time is " + gt.getByFormat('hh:mm:ss'));
Ausgabe:
local time is 01:00:00
Scoped GlideDateTime – getMonthLocalTime()
Ruft den vom GlideDateTime-Objekt gespeicherten Monat ab, der in der Zeitzone des aktuellen Benutzers angegeben ist.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Der numerische Wert des Monats. |
var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthLocalTime());
Ausgabe:
11
Scoped GlideDateTime – getMonthUTC()
Ruft den vom GlideDateTime-Objekt gespeicherten Monat ab, der in der UTC-Zeitzone angegeben ist.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Der numerische Wert des Monats. |
var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthUTC());
Ausgabe:
11
Scoped GlideDateTime – getNumericValue()
Ruft die Anzahl der Millisekunden seit dem 1. Januar 1970 um 00:00:00 GMT ab.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Die Anzahl der Millisekunden seit dem 1. Januar 1970, 00:00:00 GMT. |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getNumericValue());
Ausgabe:
1314777600000
Scoped GlideDateTime – getTime()
Gibt ein GlideTime-Objekt zurück, das den Zeitabschnitt des GlideDateTime-Objekts darstellt.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| GlideTime | Der Unix-Zeitstempel im Systemformat basierend auf der GMT-Zeit. |
var gdt = new GlideDateTime("2014-08-31 08:00:00");
gt = gdt.getTime();
gs.info(gt.getByFormat('hh:mm:ss'));
Ausgabe:
08:00:00
Scoped GlideDateTime – getTZOffset()
Ruft die Zeitzonenverschiebung in Millisekunden ab.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Die Anzahl der Millisekunden der Zeitzonenverschiebung. |
var gdt = new GlideDateTime();
gdt.getLocalTime(); // PST local time
gs.info(gdt.getTZOffset());
Ausgabe:
-25200000
Scoped GlideDateTime – getUserFormattedLocalTime()
Gibt die Zeit des Objekts in der lokalen Zeitzone und im Format des Benutzers zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Die Uhrzeit des Objekts in der lokalen Zeitzone und im Format des Benutzers. |
Dieses Beispiel zeigt die Uhrzeit des Objekts in der lokalen Zeitzone.
var gdt = new GlideDateTime('2022-10-08 01:00:00');
gs.info(gdt.getDisplayValue());
gs.info(gdt.getUserFormattedLocalTime());
Ausgabe:
2022-10-07 06:00:00 PM
06:00:00 PM
Scoped GlideDateTime – getValue()
Gibt den vom GlideDateTime-Objekt gespeicherten Datums- und Uhrzeitwert im internen Format jjjj-MM-tt HH:mm:ss in der UTC-Zeitzone zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Datum und Uhrzeit im internen Format und in der Systemzeitzone. Format: jjjj-MM-tt HH:mm:ss in der UTC-Zeitzone. |
var gdt = new GlideDateTime("2014-08-31 08:00:00");
gs.info(gdt.getValue());
Ausgabe:
2014-08-31 08:00:00
Scoped GlideDateTime – getWeekOfYearLocalTime()
Ruft die im GlideDateTime-Objekt gespeicherte Nummer der Woche ab, die in der Zeitzone des aktuellen Benutzers angegeben ist.
Alle Wochen beginnen am Sonntag. Die erste Woche des Jahres ist die Woche, die mindestens einen Tag des neuen Jahres enthält. Die Woche, die am Sonntag 2015-12-27 beginnt, gilt als erste Woche des Jahres 2016, da diese Woche den 1. und 2. Januar enthält.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Die Nummer der aktuellen Woche. Die höchste Wochennummer pro Jahr beträgt entweder 52 oder 53. |
var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in december
gs.info(gdt.getWeekOfYearLocalTime());
Ausgabe:
49
Scoped GlideDateTime – getWeekOfYearUTC()
Ruft die Zahl der Woche ab, die vom GlideDateTime-Objekt gespeichert wird, ausgedrückt in der UTC-Zeitzone.
Alle Wochen beginnen am Sonntag. Die erste Woche des Jahres ist die Woche, die mindestens einen Tag des neuen Jahres enthält. Die Woche, die am Sonntag 2015-12-27 beginnt, gilt als erste Woche des Jahres 2016, da diese Woche den 1. und 2. Januar enthält.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Die Nummer der aktuellen Woche in UTC-Zeit. Die höchste Wochennummer pro Jahr beträgt entweder 52 oder 53. |
var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in December
gs.info(gdt.getWeekOfYearUTC());
Ausgabe:
49
Scoped GlideDateTime – getYearLocalTime()
Ruft das vom GlideDateTime-Objekt gespeicherte Jahr ab, ausgedrückt in der Zeitzone des aktuellen Benutzers.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Vierstellige Jahreszahl in der Zeitzone des Benutzers. |
var gdt = new GlideDateTime("2011-11-02 12:00:00");
gs.info(gdt.getYearLocalTime());
Ausgabe:
2011
Scoped GlideDateTime – getYearUTC()
Ruft das vom GlideDateTime-Objekt gespeicherte Jahr ab, das in der UTC-Zeitzone angegeben wird.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zahl | Vierstelliger Jahreswert in der UTC-Zeitzone. |
var gdt = new GlideDateTime("2011-11-02 12:00:00");
gs.info(gdt.getYearUTC());
Ausgabe:
2011
Scoped GlideDateTime – hasDate()
Bestimmt, ob das Datum eines Objekts festgelegt ist.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn das Objektdatum eingestellt ist. Andernfalls wird „false“ zurückgegeben. |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.hasDate());
Ausgabe:
true
Scoped GlideDateTime – isDST()
Bestimmt, ob die Zeit eines Objekts eine Sommerzeitverschiebung verwendet.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn die Zeit Sommerzeit ist. Andernfalls wird „false“ zurückgegeben. |
var gdt = new GlideDateTime("2014-08-31 00:00:00");
gs.info(gdt.isDST()); //true
Ausgabe:
var gdt = new GlideDateTime("2014-08-31 00:00:00");
gs.info(gdt.isDST()); //true
Scoped GlideDateTime – isValid()
Bestimmt, ob ein Wert ein gültiges Datum und eine gültige Uhrzeit ist.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn Wert gültig ist, andernfalls wird „false“ zurückgegeben. |
var gdt = new GlideDateTime("2011-aa-31 aa:00:00");
gs.info(gdt.isValid()); //true
gs.info(gdt.getErrorMsg()); //reason
Ausgabe:
false
Invalid date time: '2011-aa-31 aa:00:00', ignored
Scoped GlideDateTime – onOrAfter(GlideDateTime gdt)
Bestimmt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts am oder nach dem Datum und der Uhrzeit des angegebenen GlideDateTime-Objekts liegen.
| Name | Typ | Beschreibung |
|---|---|---|
| gDT | GlideDateTime | Datum und Uhrzeit für den Abgleich. |
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts am oder nach dem im Parameter angegebenen Datum und Uhrzeit liegen. Mögliche Werte:
|
var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.onOrAfter(gdt2));
Ausgabe
false
Scoped GlideDateTime – onOrBefore(GlideDateTime gdt)
Bestimmt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts am oder vor dem Datum und der Uhrzeit des angegebenen GlideDateTime-Objekts liegen.
| Name | Typ | Beschreibung |
|---|---|---|
| gDT | GlideDateTime | Datum und Uhrzeit für den Abgleich. |
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob das Datum und die Uhrzeit des GlideDateTime-Objekts am oder vor dem vom Parameter angegebenen Datum und Uhrzeit liegen. Mögliche Werte:
|
var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.onOrBefore(gdt2));
Ausgabe
true
Scoped GlideDateTime – setDayOfMonthLocalTime(Number day)
Legt den Tag des Monats auf einen angegebenen Wert in der Zeitzone des aktuellen Benutzers fest.
| 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. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime();
gdt.setDayOfMonthLocalTime(9);
gs.info(gdt.getDayOfMonthLocalTime());
Ausgabe:
9
Scoped GlideDateTime – setDayOfMonthUTC(Number day)
Legt den Tag des Monats auf einen angegebenen Wert in der UTC-Zeitzone fest.
| 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. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime();
gdt.setDayOfMonthUTC(9);
gs.info(gdt.getDayOfMonthUTC());
Ausgabe:
9
Scoped GlideDateTime – setDisplayValue(String asDisplayed)
Legt einen Datums- und Uhrzeitwert unter Verwendung des Anzeigeformats und der Zeitzone des aktuellen Benutzers fest.
| Name | Typ | Beschreibung |
|---|---|---|
| asDisplayed | Zeichenfolge | Datum und Uhrzeit im Anzeigeformat und in der Zeitzone des aktuellen Benutzers. Der Parameter muss mit dem bevorzugten Anzeigeformat des aktuellen Benutzers formatiert werden, z. B. MM-TT-JJJJ hh:mm:ss. Um einer Variablen in einem Workflow-Skript das aktuelle Datum und die aktuelle Uhrzeit zuzuweisen, verwenden Sie die Variable .setDisplayValue(gs.nowDateTime);. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2014-02-02 12:00:00");
gdt.setDisplayValue("2014-01-01 12:00:00");//uses current user session time zone (US/Pacific)
gs.info(gdt.getValue());
Ausgabe:
2014-01-01 20:00:00
Scoped GlideDateTime – setDisplayValue(String value, String format)
Legt einen Datums- und Uhrzeitwert unter Verwendung der Zeitzone des aktuellen Benutzers und des angegebenen Datums- und Uhrzeitformats fest.
Diese Methode löst eine Laufzeitausnahme aus, wenn das im Parameter value verwendete Datums- und Uhrzeitformat nicht mit dem Parameter format übereinstimmt. Sie können die Fehlermeldung durch Aufrufen von getErrorMsg() für das GlideDateTime-Objekt abrufen, nachdem die Ausnahme abgefangen wurde.
| Name | Typ | Beschreibung |
|---|---|---|
| Wert | Zeichenfolge | Datum und Uhrzeit in der Zeitzone des aktuellen Anwenders. |
| format | Zeichenfolge | Datums- und Uhrzeitformat, das zum Analysieren des Parameters value verwendet wird. Verwenden Sie die folgenden Werte, um den Parameter value zu beschreiben:
Beispiel: „TT-MM-JJJJ HH:mm:ss“ oder „MM-TT-JJJJ HH:mm“. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss"); //uses current user session time zone
gs.info(gdt.getValue());
Ausgabe
"20-05-2011 12:00:00"
Scoped GlideDateTime – setDisplayValueInternal(String value)
Legt einen Datums- und Zeitwert mit dem internen Format (JJJJ-MM-TT hh:mm:ss) und der Zeitzone des aktuellen Benutzers fest.
| Name | Typ | Beschreibung |
|---|---|---|
| Wert | Zeichenfolge | Datum und Uhrzeit im internen Format. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2014-02-02 12:00:00");
gdt.setDisplayValueInternal("2014-01-01 12:00:00"); //uses current user session time zone (US/Pacific)
gs.info(gdt.getValue());
Ausgabe:
2014-01-01 20:00:00
Bereichsbezogene GlideDateTime - setDisplayValueLang(Zeichenfolge dateTime, Zeichenfolgenstil)
Legt ein Datum und eine Uhrzeit mit einem angegebenen Stil und Format entsprechend dem Gebietsschema des aktuellen Anwenders fest.
| 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:
Wenn ein anderer Wert übergeben wird, verwendet die API standardmäßig mittel. Bei akzeptierten Werten wird zwischen Groß- und Kleinschreibung unterschieden. |
| Typ | Beschreibung |
|---|---|
| void |
Im folgenden Beispiel werden das Datum und die Uhrzeit im kurzen und vollständigen Stil zurückgegeben.
var glideDateFR = new GlideDateTime();
glideDateFR.setDisplayValueLang("2/3/2023 17:27:56", "short");
gs.info('date: ' + glideDateFR.getDisplayValue());
gs.info('date: ' + glideDateFR.getDisplayValueLang("full"));
Ausgabe:
date: 2023-02-03 17:27:56
date: Friday, February 3, 2023 17:27:56
Bereichsbezogene GlideDateTime - setDisplayValueLang(String dateTime, Zeichenfolgenstil, Zeichenfolgensprache)
Legt ein Datum und eine Uhrzeit unter Verwendung eines bestimmten Stils, einer bestimmten Sprache und eines bestimmten Formats entsprechend dem Gebietsschema des aktuellen Anwenders fest.
| 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:
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. |
| Typ | Beschreibung |
|---|---|
| void |
Im folgenden Beispiel werden Datum und Uhrzeit in kurzen und vollständigen Stilen für Englisch und Französisch zurückgegeben.
var glideDateFR = new GlideDateTime();
glideDateUS.setDisplayValueLang("2/3/2023 18:00:00", "short", "en-US" );
glideDateFR.setDisplayValueLang("2/3/2023 18:00:00", "short", "fr-FR" );
gs.info('en-US date: ' + glideDateUS.getDisplayValue());
gs.info('en-US date: ' + glideDateUS.getDisplayValueLang("full"));
gs.info('fr-FR date: ' + glideDateFR.getDisplayValue());
gs.info('fr-FR date: ' + glideDateFR.getDisplayValueLang("full"));
Ausgabe:
en-US date: 2023-02-03 18:00:00
en-US date: Friday, February 3, 2023 18:00:00
fr-FR date: 2023-03-02 18:00:00
fr-FR date: Thursday, March 2, 2023 18:00:00
Scoped GlideDateTime – setGlideDateTime(GlideDateTime g)
Legt das Datum und die Uhrzeit des aktuellen Objekts mit einem vorhandenen GlideDateTime-Objekt fest. Diese Methode entspricht der Instantiierung eines neuen Objekts mit einem GlideDateTime-Parameter.
| Name | Typ | Beschreibung |
|---|---|---|
| g | GlideDateTime | Das Objekt, das zum Festlegen des datetime-Werts verwendet wird. |
| Typ | Beschreibung |
|---|---|
| Keine |
var dt1 = new GlideDateTime("2011-01-01 12:00:00");
var dt2 = new GlideDateTime("2011-02-02 08:00:00");
dt1.setGlideDateTime(dt2);
gs.info(dt1.getValue());
Ausgabe:
2011-02-02 08:00:00
Scoped GlideDateTime – setMonthLocalTime(Number month)
Legt den vom GlideDateTime-Objekt gespeicherten Monat mit der Zeitzone des aktuellen Benutzers auf den angegebenen Wert fest.
| Name | Typ | Beschreibung |
|---|---|---|
| month | Zahl | Der Monat, zu dem Sie wechseln möchten |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime();
gdt.setMonthLocalTime(1);
gs.info(gdt.getMonthLocalTime());
Ausgabe:
1
Scoped GlideDateTime – setMonthUTC(Number month)
Legt den vom GlideDateTime-Objekt gespeicherten Monat unter Verwendung der UTC-Zeitzone auf den angegebenen Wert fest.
| Name | Typ | Beschreibung |
|---|---|---|
| month | Zahl | Der Monat, zu dem Sie wechseln möchten |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime();
gdt.setMonthUTC(1);
gs.info(gdt.getMonthUTC());
Ausgabe:
1
Scoped GlideDateTime – setValue(String o)
Legt das Datum und die Uhrzeit des GlideDateTime-Objekts fest.
| Name | Typ | Beschreibung |
|---|---|---|
| o | Zeichenfolge | Das Datum und die Uhrzeit, die verwendet werden sollen. Dieser Parameter kann einer von mehreren Typen sein:
|
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValue("2011-02-02 08:00:00"); // value set = 2011-02-02 08:00:00
gs.info(gdt.getValue());
Ausgabe:
2011-02-02 08:00:00
Scoped GlideDateTime – setValueUTC(String dt, String format)
Legt einen Datums- und Uhrzeitwert unter Verwendung der UTC-Zeitzone und des angegebenen Datums- und Uhrzeitformats fest. Diese Methode löst eine Laufzeitausnahme aus, wenn das im Parameter dt verwendete Datums- und Uhrzeitformat nicht mit dem Parameter format übereinstimmt. Sie können die Fehlermeldung durch Aufrufen von getErrorMsg() für das GlideDateTime-Objekt abrufen, nachdem die Ausnahme abgefangen wurde.
| Name | Typ | Beschreibung |
|---|---|---|
| dt | Zeichenfolge | Das Datum und die Uhrzeit, die verwendet werden sollen. |
| format | Zeichenfolge | Das Datums- und Uhrzeitformat, das verwendet werden soll. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValueUTC("15-02-2011 08:00:00", "dd-MM-yyyy HH:mm:ss");
gs.info(gdt.getValue());
Ausgabe:
2011-02-15 08:00:00
Scoped GlideDateTime – setYearLocalTime(Number year)
Legt das vom GlideDateTime-Objekt gespeicherte Jahr unter Verwendung der Zeitzone des aktuellen Benutzers auf den angegebenen Wert fest.
| Name | Typ | Beschreibung |
|---|---|---|
| year | Zahl | Das Jahr, zu dem Sie wechseln möchten. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime();
gdt.setYearLocalTime(2013);
gs.info(gdt.getYearLocalTime());
Ausgabe:
2013
Scoped GlideDateTime – setYearUTC(Number year)
Legt das vom GlideDateTime-Objekt gespeicherte Jahr unter Verwendung der UTC-Zeitzone auf den angegebenen Wert fest.
| Name | Typ | Beschreibung |
|---|---|---|
| year | Zahl | Das Jahr, zu dem Sie wechseln möchten. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime();
gdt.setYearUTC(2013);
gs.info(gdt.getYearUTC());
Ausgabe:
2013
Scoped GlideDateTime – subtract(GlideTime time)
Subtrahiert eine bestimmte Zeit vom aktuellen GlideDateTime-Objekt.
| Name | Typ | Beschreibung |
|---|---|---|
| time | GlideTime | Der Zeitwert, der abgezogen werden soll. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.subtract(gtime1);
var gtime2 = gdt.getTime();
gs.info(gtime2.getByFormat('hh:mm:ss'));
Ausgabe:
07:59:40
Bereichsbezogene GlideDateTime – subtrahieren (Anzahl Millisekunden)
Subtrahiert die angegebene Anzahl von Millisekunden vom GlideDateTime-Objekt.
| Name | Typ | Beschreibung |
|---|---|---|
| milliseconds | Nummer | Anzahl der zu subtrahierenden Millisekunden. |
| Typ | Beschreibung |
|---|---|
| Keine |
var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.subtract(1000);
gs.info(gdt.getValue());
Ausgabe:
2011-12-07 07:59:59
Scoped GlideDateTime – subtract(GlideDateTime start, GlideDateTime end)
Gibt die Differenz bei der Dauer zwischen zwei angegebenen GlideDateTime-Objekten zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Start | GlideDateTime | Startdatumsobjekt. |
| Ende | GlideDateTime | Enddatumsobjekt. |
| Typ | Beschreibung |
|---|---|
| GlideDuration | Differenz bei der Dauer zwischen den beiden angegebenen Daten. |
var gdt1 = new GlideDateTime("2011-08-28 09:00:00");
var gdt2 = new GlideDateTime("2011-08-31 08:00:00");
var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2
gs.info(dur.getDisplayValue());
Ausgabe:
2 Days 23 Hours
Scoped GlideDateTime – toString()
Ruft den Datums- und Uhrzeitwert ab, der vom GlideDateTime-Objekt im internen Format (JJJJJ-MM-TT hh:mm:ss) und der Systemzeitzone UTC (standardmäßig) gespeichert wird. Diese Methode entspricht getValue().
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | |
|---|---|
| Zeichenfolge | Das Datum und die Uhrzeit, die vom GlideDateTime-Objekt in der Systemzeitzone und im Systemformat gespeichert werden. |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.toString());
Ausgabe:
2011-08-31 08:00:00