GlideDate – Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 9 Minuten Lesedauer

    • Die 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 – Global.

    GlideDate: GlideDate()

    Erzeugt ein GlideDate-Objekt mit aktuellem Datum und 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

    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 Äquivalent

    Um diese Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: Bereichsbezogenes GlideDate – getByFormat (Zeichenfolgenformat) .

    GlideDate – getDayOfMonthNoTZ()

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

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 5. Ergebnisse
    Typ Beschreibung
    Zahl 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

    Bereichsbezogenes Äquivalent

    Um diese Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: Bereichsbezogenes GlideDate – getMonthNoTZ() .

    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. Ergebnisse
    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 Äquivalent

    Um diese Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: Bereichsbezogenes GlideDate – getDisplayValue() .

    GlideDate – getDisplayValueInternal()

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

    Siehe auch GetDisplayValue()

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 9. Ergebnisse
    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 Äquivalent

    Um diese Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: Bereichsbezogenes GlideDate – getDisplayValueInternal() .

    GlideDate – getDisplayValueLang(Zeichenfolgenstil)

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

    Tabelle : 10. 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. Monday, 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 : 11. Rückgaben
    Typ Beschreibung
    Zeichenfolge Eine Zeichenfolgendarstellung des Datums im angegebenen Stil und im entsprechenden Format für das Gebietsschema des aktuellen Anwenders.

    Das folgende Beispiel gibt das Datum des Gebietsschemas des Anwenders in allen Stilen zurück.

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


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

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

    Ausgabe:

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

    GlideDate – getDisplayValueLang(Zeichenfolgenstil, Zeichenfolgensprache)

    Gibt den Datumswert im Gebietsschema und in der Sprache des Anwenders gemäß 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. Monday, 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-UK 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

    GlideDate – getMonthNoTZ()

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

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

    Ausgabe:

    5

    Bereichsbezogenes Äquivalent

    Um diese Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: Bereichsbezogenes GlideDate – getMonthNoTZ() .

    GlideDate – getYearNoTZ()

    Ruft das Jahr ab, das vom GlideDate-Objekt gespeichert wird, ausgegeben in der UTC-Zeitzone.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 17. Ergebnisse
    Typ Beschreibung
    Zahl Der Zahlenwert des Jahres. 
    //Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getYearNoTZ());

    Ausgabe:

    2016

    Bereichsbezogenes Äquivalent

    Um diese Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: Bereichsbezogenes GlideDate – getYearNoTZ() .

    GlideDate: ParseDate(Zeichenfolgendatum, Zeichenfolgensprache, Zeichenfolgenland)

    Analysiert ein Datum in das Gebietsschema, das den übergebenen Sprach- und Ländercodes zugeordnet ist.

    Hinweis:
    Diese Methode schlägt fehl und löst eine Ausnahme aus, wenn das regionale Datumsformat nicht eingehalten wird.
    Tabelle : 18. Parameter
    Name Typ Beschreibung
    date Zeichenfolge Datum in regionaler Syntax formatiert.

    Formate:

    • Alphanumerische Daten: Sie können Monate entweder als drei Zeichen angeben, z. B. Jan, Feb oder Mar, oder den Namen des Monats vollständig buchstabieren. Jahre müssen vierstellig und Tage zweistellig sein. Beispiel: „31. Januar 2020“ Oder „31. Januar 2020“
    • Numerische Daten: Tage und Monate müssen zweistellig sein. Vier Ziffern werden seit Jahren sehr bevorzugt, obwohl die Methode ein zweistelliges Jahr mit weniger Genauigkeit und einer höheren Wahrscheinlichkeit eines Analysefehlers unterstützt. Sie müssen auch das regionale Datumstrennzeichen verwenden. Diese Trennzeichen wirken sich auf die Analyse basierend auf der übergebenen aus languageUnd countryWerte. Beispiel: „12/31/2020“ für Gebietsschema „USA“ und „31.12.20“ für Gebietsschema „Estland“.
    language Zeichenfolge ISO-639 – zweistelliger Sprachcode.
    country Zeichenfolge ISO-3166 – zweistelliger Ländercode.
    Tabelle : 19. Rückgaben
    Typ Beschreibung
    Objekt Analysiertes GlideDate-Objekt, das Sie in Berechnungen verwenden oder in einen Datensatz einfügen können.

    Diese Methode löst eine Ausnahme aus, wenn das Datum nicht analysiert werden konnte. Eine Ausnahme tritt auf, wenn das Datumsformat nicht mit dem angegebenen Gebietsschemaformat übereinstimmt (übergeben) languageUnd countryParameter).

    Das folgende Codebeispiel analysiert ein Datum und fügt diesem Datum vier Wochen hinzu.

    var date = GlideDate.parseDate("31 Dec 2020", "en", "GB");
date.addWeeksLocalTime(4);
gs.info("Project is due 4 weeks after start date, on " + date.getDisplayValue());

    Ausgabe:

    Project is due 4 weeks after start date, on 2021-01-28

    GlideDate – setDisplayValue(Zeichenfolge asDisplays)

    Legt einen Datumswert unter Verwendung des Anzeigeformats und der Zeitzone des aktuellen Benutzers fest.

    Tabelle : 20. Parameter
    Name Typ Beschreibung
    asDisplayed Zeichenfolge Datum im Anzeigeformat und der 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 Äquivalent

    Um diese Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: Bereichsbezogenes GlideDate – setDisplayValue(Zeichenfolge asDisplayed) .

    GlideDate – setDisplayValueLang(Zeichenfolgendatum, Zeichenfolgenstil)

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

    Tabelle : 22. Parameter
    Name Typ Beschreibung
    date 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. Monday, 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 : 23. Rückgaben
    Typ Beschreibung
    void

    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

    GlideDate – setDisplayValueLang(Zeichenfolgendatum, Zeichenfolgenstil, Zeichenfolgensprache)

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

    Tabelle : 24. Parameter
    Name Typ Beschreibung
    date 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. Monday, 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-UK Für britisches Englisch. Eine vollständige Liste der akzeptierten Werte finden Sie unter BCP 47-Sprachcodeliste .
    Tabelle : 25. Rückgaben
    Typ Beschreibung
    void

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

    var glideDateFR = new 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

    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 : 26. Parameter
    Name Typ Beschreibung
    o Zeichenfolge Datum und Uhrzeit, die im aktuellen GlideDate-Objekt festgelegt werden sollen.

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

    Ausgabe:

    2015-01-01

    Bereichsbezogenes Äquivalent

    Um diese Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: Bereichsbezogenes GlideDate – setValue(Zeichenfolge o) .