GlideDate – Umfang

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 8 Minuten Lesedauer

    • Der Umfang ist festgelegt GlideDate Die Klasse bietet Methoden zum Ausführen von Vorgängen für GlideDate-Objekte, z. B. Instanziierung von GlideDate-Objekten oder Arbeiten mit GlideDate-Feldern.

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

    Siehe auch GlideDateTime – Umfang.

    Bereichsbezogenes GlideDate – GlideDate()

    Erstellt ein GlideDate-Objekt mit dem aktuellen Datum/der aktuellen Uhrzeit.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine 
    //Today's date is April 21, 2021
var gd = new GlideDate();
gs.info(gd.getValue());
    Ausgabe: 
    2021-04-21

    Bereichsbezogenes GlideDate – getByFormat (Zeichenfolgenformat)

    Ruft das Datum im angegebenen Datumsformat ab.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    format Zeichenfolge Gewünschtes Datumsformat mit Java SimpleDateFormat . Beispiel: „tt-MM-JJJJ“ Um den Tag, den Monat und das Jahr oder abzurufen „EEEE“ Um den Wochentag abzurufen.
    Tabelle : 3. Rückgaben
    Typ Beschreibung
    Zeichenfolge Datumswert für das GlideDate-Objekt im angegebenen Format. 
    var gd = new GlideDate(); 
gd.setValue('2021-04-21');
gs.info(gd.getByFormat("dd-MM-yyyy"));
    Ausgabe: 
    21-04-2021

    Bereichsbezogenes GlideDate – getDayofMonthNoTZ()

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

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    Nummer Der Tag des Monats in der UTC-Zeitzone, von 1 bis 31. 
    //Today's date is 2016-05-13 
var gd =new GlideDate();
gs.info(gd.getDayOfMonthNoTZ());

    Ausgabe:

    13

    Scoped GlideDate – getDisplayValue()

    Ruft den Wert des Datums- und Uhrzeitfelds in der UTC-Zeitzone ab.

    Siehe auch: GetDisplayValueInternal()

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    keine
    Tabelle : 7. Rückgaben
    Typ Beschreibung
    Zeichenfolge Datumswert für das GlideDate-Objekt in der UTC-Zeitzone. 
    var gd = new GlideDate(); 
gd.setValue('2025-04-21');
gs.info(gd.getDisplayValue());
    Ausgabe: 
    2025-04-21

    Bereichsbezogenes GlideDate – getDisplayValueEx (Zeichenfolgenstil)

    Gibt das Datum unter Verwendung der Zeitzone des aktuellen Anwenders und eines angegebenen Formats zurück.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Stil Zeichenfolge Format, das für das Datum verwendet werden soll.
    Gültige Werte (Groß-/Kleinschreibung wird nicht beachtet):
    • Kurz : M/T/JJ oder D/M/JJ, je nach Sprache des aktuellen Anwenders. Beispiel: 1/27/26 oder 27/1/26.
    • Mittel : Enthält abgekürzten Monat, Tag und Jahr. Beispiel: 27. Januar 2026.
    • Lang : Enthält Monat, Tag und Jahr. Beispiel: 27. Januar 2026.
    • Voll : Enthält Wochentag, Monat, Tag und Jahr. Beispiel: Dienstag, 27. Januar 2026.

    Das Datum wird in der Sprache des aktuellen Anwenders zurückgegeben. Die Sprache bestimmt die Reihenfolge von Monat und Tag im Datum.
    Tabelle : 9. Rückgaben
    Typ Beschreibung
    Zeichenfolge Das Datum im angegebenen Format.

    Dieses Beispiel gibt das Datum anhand der Zeitzone des aktuellen Anwenders und jeder Formatierungsoption zurück.

    var gd = new GlideDate();
gs.info(gd.getDisplayValueEx("short"));
gs.info(gd.getDisplayValueEx("medium"));
gs.info(gd.getDisplayValueEx("long"));
gs.info(gd.getDisplayValueEx("full"));

    Ausgabe:

    1/27/26  //short
Jan 27, 2026  //medium
January 27, 2026  //long
Tuesday, January 27, 2026  //full

    Bereichsbezogenes GlideDate – getDisplayValueInternal()

    Ruft das Datum im internen Format (jjjj-MM-tt) und die Zeitzone des aktuellen Anwenders ab.

    Siehe auch Bereichsbezogenes GlideDate – getDisplayValueInternal()

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    keine
    Tabelle : 11. Rückgaben
    Typ Beschreibung
    Zeichenfolge Datumswert für das GlideDate-Objekt in der Zeitzone des aktuellen Anwenders.

    Format: jjjj-MM-tt

    		 
    var gd = new GlideDate(); 
gs.info(gd.getDisplayValueInternal());
    Ausgabe: 
    2021-04-21

    Bereichsbezogenes GlideDate – getDisplayValueLang(Zeichenfolgenstil, Zeichenfolgensprache)

    Gibt den Datumswert im Gebietsschema des Anwenders gemäß einer angegebenen Sprache und einem angegebenen Datumsstil zurück.

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

    Wenn ein anderer Wert übergeben wird, ist die API standardmäßig auf festgelegt Mittel . Bei akzeptierten Werten wird die Groß-/Kleinschreibung nicht beachtet.
    language Zeichenfolge Gibt das Datum gemäß einem angegebenen Sprachwert zurück. Akzeptiert Sprach-Tags, die dem BCP-47-Standard entsprechen. Beispiel: fr Für Französisch oder en-Vereinigtes Königreich Für britisches Englisch. Eine vollständige Liste der akzeptierten Werte finden Sie unter BCP 47-Sprachcodeliste .
    Tabelle : 13. Rückgaben
    Typ Beschreibung
    Zeichenfolge Datum im Stil und in der Sprache, die gemäß dem Gebietsschema des aktuellen Anwenders angegeben sind.

    Das folgende Beispiel gibt das Datum des Gebietsschemas des Anwenders in verschiedenen Sprachen und Stilen zurück.

    var gd = new GlideDate(); // This will fetch the current date


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

gs.info('date: ' + gd.getDisplayValueLang("full", "fr"));
gs.info('date: ' + gd.getDisplayValueLang("long", "en-GB"));
gs.info('date: ' + gd.getDisplayValueLang("medium", "de"));
gs.info('date: ' + gd.getDisplayValueLang("short", "es-MX"));

    Ausgabe:

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

    Bereichsbezogenes GlideDate – getMonthNoTZ()

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

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 15. Rückgaben
    Typ Beschreibung
    Nummer Der numerische Wert des Monats von 1 bis 12. 
    //Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getMonthNoTZ());

    Ausgabe:

    5

    Bereichsbezogenes GlideDate – getValue()

    Ruft das Datum im internen Format (jjjj-MM-tt) und die Systemzeitzone (standardmäßig UTC) ab.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    keine
    Tabelle : 17. Rückgaben
    Typ Beschreibung
    Zeichenfolge Der Datumswert für das GlideDate-Objekt in der Systemzeitzone.

    Format: jjjj-MM-tt

    		 
    var gd = new GlideDate();
gd.setValue('2021-04-21');
gs.info(gd.getValue());
    Ausgabe: 
    2021-04-21

    Bereichsbezogenes GlideDate – getYearNoTZ()

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

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 19. Rückgaben
    Typ Beschreibung
    Nummer Der numerische Wert des Jahres. 
    //Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getYearNoTZ());

    Ausgabe:

    2016

    Bereichsbezogenes GlideDate – setDisplayValue(Zeichenfolge asDisplayed)

    Legt einen Datumswert mithilfe des Anzeigeformats und der Zeitzone des aktuellen Anwenders fest.

    Tabelle : 20. Parameter
    Name Typ Beschreibung
    AsDisplays Zeichenfolge Datum im Anzeigeformat und Zeitzone des aktuellen Anwenders.

    Format: Muss mit dem bevorzugten Anzeigeformat des aktuellen Anwenders formatiert werden, z. B. jjjj-MM-tt.
    Tabelle : 21. Rückgaben
    Typ Beschreibung
    Keine 
    var gd = new GlideDate();
gd.setDisplayValue("2011-01-01");
gs.info(gd.getValue());

    Ausgabe:

    2011-01-01

    Bereichsbezogenes GlideDate – setDisplayValueEx(Zeichenfolgendatum, Zeichenfolgenstil)

    Legt das Datum in einem angegebenen Format fest.

    Tabelle : 22. Parameter
    Name Typ Beschreibung
    Datum Zeichenfolge Wert, der für das Datum festgelegt werden soll.
    Die GetDisplayValueEx() Methode gibt Daten in einem gültigen Format zurück, oder Daten können wie unten gezeigt formatiert werden.
    • M/T/JJ oder D/M/JJ, je nach Sprache des aktuellen Anwenders. Beispiel: 1/27/26 oder 27/1/26.
    • Abgekürzt Monat, Tag und Jahr. Beispiel: 27. Januar 2026.
    • Monat, Tag und Jahr. Beispiel: 27. Januar 2026.
    • Wochentag, Monat, Tag und Jahr. Beispiel: Dienstag, 27. Januar 2026.
    Die Sprache des aktuellen Anwenders bestimmt die akzeptierte Reihenfolge von Monat und Tag im Datum. Beispiel: Wenn die Sprache des aktuellen Anwenders Englisch ist 3/21/26 Und 21. März 2026 Sind gültige Werte während 21/3/26 Und 21. März 2026 Sind nicht.
    Stil Zeichenfolge Format, das für das Datum verwendet werden soll.

    Sie müssen dasselbe Format wie angegeben verwenden dateWert.

    Gültige Werte (Groß-/Kleinschreibung wird nicht beachtet):
    • Kurz : M/T/JJ oder D/M/JJ, je nach Sprache des aktuellen Anwenders. Beispiel: 1/27/26 oder 27/1/26.
    • Mittel : Abgekürzt Monat, Tag und Jahr. Beispiel: 27. Januar 2026.
    • Lang : Monat, Tag und Jahr. Beispiel: 27. Januar 2026.
    • Voll : Wochentag, Monat, Tag und Jahr. Beispiel: Dienstag, 27. Januar 2026.
    Tabelle : 23. Rückgaben
    Typ Beschreibung
    Keine

    In diesem Beispiel wird das Datum in einem angegebenen Format festgelegt.

    gd = new GlideDate();
gd.setDisplayValueEx("Jan 28, 2026", "medium");
gs.info(gd.getDisplayValueEx("full"));

    Ausgabe:

    Wednesday, January 28, 2026

    Bereichsbezogenes GlideDate – setDisplayValueLang(Zeichenfolgendatum, Zeichenfolgenstil)

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

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

    Beispiel: Mithilfe der Ausgabe von GetDisplayValueLang (Zeichenfolgenstil, Zeichenfolgensprache) Beispiel zuvor in diesem Thema, 25. Oktober 2022 Oder 25.10.2022 Sind akzeptierte Werte.
    Stil Zeichenfolge Datumsformat.
    Gültige Werte:
    • Voll : Gibt das Datum im Format <weekday, month, day and year> gemäß dem Gebietsschema des Anwenders zurück (z. B. Montag, 24. Oktober 2022).
    • Lang : Gibt das Datum im Format <Monat, Tag und Jahr> gemäß dem Gebietsschema des Anwenders zurück (z. B. 24. Oktober 2022).
    • Mittel : Ähnlich Lang Gibt jedoch das Datum mit einem abgekürzten Monat zurück (z. B. 24. Oktober 2022).
    • Kurz : Gibt das Datum im Format MM/TT/JJ oder TT/MM/JJ gemäß dem Gebietsschema des Anwenders zurück (z. B. 10/24/2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, ist die API standardmäßig auf festgelegt Mittel . Bei akzeptierten Werten wird die Groß-/Kleinschreibung nicht beachtet.
    Tabelle : 25. Rückgaben
    Typ Beschreibung
    Ungültig

    Das folgende Beispiel zeigt, wie Sie das aktuelle Datum des Gebietsschemas des Anwenders mit auf den Stil „vollständig“ festlegen können SetDisplayValueLang() .

    glideDate.setDisplayValueLang("2/3/2023", "short");


gs.info('date: ' + glideDate.getDisplayValue());
gs.info('date: ' + glideDate.getDisplayValueLang("full"));

    Ausgabe:

    date: 2023-02-03
date: Friday, February 3, 2023

    Bereichsbezogenes GlideDate – setDisplayValueLang(Zeichenfolgendatum, Zeichenfolgenstil, Zeichenfolgensprache)

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

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

    Beispiel: Mithilfe der Ausgabe von GetDisplayValueLang (Zeichenfolgenstil, Zeichenfolgensprache) Beispiel zuvor in diesem Thema, 25. Oktober 2022 Oder 25.10.2022 Sind akzeptierte Werte.
    Stil Zeichenfolge Datumsformat.
    Gültige Werte:
    • Voll : Gibt das Datum im Format <weekday, month, day and year> gemäß dem Gebietsschema des Anwenders zurück (z. B. Montag, 24. Oktober 2022).
    • Lang : Gibt das Datum im Format <Monat, Tag und Jahr> gemäß dem Gebietsschema des Anwenders zurück (z. B. 24. Oktober 2022).
    • Mittel : Ähnlich Lang Gibt jedoch das Datum mit einem abgekürzten Monat zurück (z. B. 24. Oktober 2022).
    • Kurz : Gibt das Datum im Format MM/TT/JJ oder TT/MM/JJ gemäß dem Gebietsschema des Anwenders zurück (z. B. 10/24/2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, ist die API standardmäßig auf festgelegt Mittel . Bei akzeptierten Werten wird die Groß-/Kleinschreibung nicht beachtet.
    language Zeichenfolge Legt die Sprache mithilfe eines Sprach-Tags fest, das dem BCP-47-Standard entspricht. Beispiel: fr Für Französisch oder en-Vereinigtes Königreich Für britisches Englisch. Eine vollständige Liste der akzeptierten Werte finden Sie unter BCP 47-Sprachcodeliste .
    Tabelle : 27. Rückgaben
    Typ Beschreibung
    Ungültig

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

    var glideDateFR = new GlideDate(); 

glideDateUS.setDisplayValueLang("2/3/202", "short", "en-US" );
glideDateFR.setDisplayValueLang("2/3/2023", "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
en-US date: Friday, February 3, 2023
fr-FR date: 2023-03-02
fr-FR date: Thursday, March 2, 2023

    Bereichsbezogenes GlideDate – setValue(Zeichenfolge o)

    Legt das Datum des aktuellen GlideDate-Objekts im internen Format (jjjj-MM-tt) und in der Systemzeitzone (standardmäßig UTC) fest.

    Tabelle : 28. Parameter
    Name Typ Beschreibung
    o Zeichenfolge Datum und Uhrzeit, die im aktuellen GlideDate-Objekt festgelegt werden sollen.

    Format: jjjj-MM-tt
    Tabelle : 29. Rückgaben
    Typ Beschreibung
    Keine 
    var gd = new GlideDate(); 
gd.setValue('2015-01-01');
gs.info(gd.getValue());

    Ausgabe:

    2015-01-01

    Bereichsbezogenes GlideDate – abziehen(GlideDate-Start, GlideDate-Ende)

    Ruft die Differenz der Dauer zwischen zwei GlideDate-Werten ab.

    Tabelle : 30. Parameter
    Name Typ Beschreibung
    start GlideDate Der Startwert.
    end GlideDate Der Endwert.
    Tabelle : 31. Rückgaben
    Typ Beschreibung
    GlideDuration Die Dauer zwischen den beiden Werten. 
    var sgd1 = new GlideDate(); 
sgd1.setDisplayValue('2014-07-18'); 
var sgd2 = new GlideDate(); 
sgd2.setDisplayValue('2014-07-19'); 
 
var duration = GlideDate.subtract(sgd1, sgd2); 
gs.info(duration.getDisplayValue());
    Ausgabe: 
    1 Day