GlideDate – Global

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 8 Minuten Lesedauer

    • Die GlideDate -Klasse stellt Methoden zum Ausführen von Vorgängen an GlideDate-Objekten bereit, z. B. Instanziieren von GlideDate-Objekten oder Arbeiten mit GlideDate-Feldern.

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

    GlideDate – getByFormat(String format)

    Ruft das Datum im angegebenen Datumsformat ab.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    format Zeichenfolge Gewünschtes Datumsformat mit Java SimpleDateFormat. Beispiel: „TT-MM-JJJJ“, um Tag, Monat und Jahr abzurufen, oder „EEEE“, um den Wochentag abzurufen.
    Tabelle : 2. Ergebnisse
    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: Scoped GlideDate – getByFormat(String format).

    GlideDate – getDayOfMonthNoTZ()

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

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. 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: Scoped GlideDate – getMonthNoTZ().

    GlideDate – getDisplayValue()

    Ruft das Datum im Anzeigeformat und in der Zeitzone des aktuellen Benutzers ab.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Datumswert für das GlideDate-Objekt im Anzeigeformat und in der Zeitzone des aktuellen Benutzers. 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 gd = new GlideDate(); 
gd.setValue('2021-04-21');
gs.info(gd.getDisplayValue());
    Ausgabe: 
    2021-04-21

    Bereichsbezogenes Äquivalent

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

    GlideDate – getDisplayValueInternal()

    Ruft das Datum im internen Format (JJJJ-MM-TT) und die Zeitzone des aktuellen Benutzers ab.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Datumswert für das GlideDate-Objekt in der Zeitzone des aktuellen Benutzers.

    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: Scoped GlideDate – getDisplayValueInternal().

    GlideDate – getDisplayValueLang(String Style)

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

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    -Stil Zeichenfolge Datumsformat.
    Gültige Werte:
    • full: Gibt das Datum im Format zurück<weekday, month, day, and year> entsprechend dem Gebietsschema des Benutzers (z. B. Montag, 24. Oktober 2022).
    • long: gibt das Datum im Format zurück<month, day, and year> entsprechend dem Gebietsschema des Benutzers (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 Benutzers zurück (z. B. 24.10.2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, wird die API standardmäßig auf mittelgesetzt. Bei akzeptierten Werten wird nicht zwischen Groß- und Kleinschreibung unterschieden.
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Eine Zeichenfolgendarstellung des Datums im angegebenen Stil und im entsprechenden Format für das Gebietsschema des aktuellen Benutzers.

    Das folgende Beispiel gibt das Datum des Gebietsschemas des Benutzers 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(String stil, String language)

    Gibt den Datumswert im Gebietsschema und in der Sprache des Benutzers gemäß einem angegebenen Datumsstil zurück.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    -Stil Zeichenfolge Datumsformat.
    Gültige Werte:
    • full: Gibt das Datum im Format zurück<weekday, month, day, and year> entsprechend dem Gebietsschema des Benutzers (z. B. Montag, 24. Oktober 2022).
    • long: gibt das Datum im Format zurück<month, day, and year> entsprechend dem Gebietsschema des Benutzers (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 Benutzers zurück (z. B. 24.10.2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, wird die API standardmäßig auf mittelgesetzt. Bei akzeptierten Werten wird nicht 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 englisches Englisch. Eine vollständige Liste der akzeptierten Werte finden Sie unter BCP 47-Sprachcodeliste.
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Datum im Stil und in der Sprache, die gemäß dem Gebietsschema des aktuellen Benutzers angegeben sind.

    Das folgende Beispiel gibt das Datum des Gebietsschemas des Benutzers 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 : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. 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: Scoped GlideDate – getMonthNoTZ().

    GlideDate – getYearNoTZ()

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

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. 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: Scoped GlideDate – getYearNoTZ().

    GlideDate – GlideDate()

    Erzeugt ein GlideDate-Objekt mit aktuellem Datum und Uhrzeit.

    Tabelle : 17. 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 – setDisplayValue(String asDisplayed)

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

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    asDisplayed Zeichenfolge Datum im Anzeigeformat und in der Zeitzone des aktuellen Benutzers.

    Format: Muss mit dem bevorzugten Anzeigeformat des aktuellen Benutzers formatiert werden, z. B. jjjj-MM-tt.
    Tabelle : 19. Ergebnisse
    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: Scoped GlideDate – setDisplayValue(String asDisplayed).

    GlideDate – setDisplayValueLang(String date, String Style)

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

    Tabelle : 20. Parameter
    Name Typ Beschreibung
    date Zeichenfolge Datumswert für das GlideDate-Objekt in der Zeitzone des aktuellen Benutzers. Gültige Werte sind alle Datums- und Uhrzeitausgaben der Funktion getDisplayValueLang().

    Wenn Sie beispielsweise die Ausgabe aus dem Beispiel getDisplayValueLang(String Style, String Language) weiter oben in diesem Thema verwenden, sind 25. Oktober 2022 oder 25.10.2022 akzeptierte Werte.
    -Stil Zeichenfolge Datumsformat.
    Gültige Werte:
    • full: Gibt das Datum im Format zurück<weekday, month, day, and year> entsprechend dem Gebietsschema des Benutzers (z. B. Montag, 24. Oktober 2022).
    • long: gibt das Datum im Format zurück<month, day, and year> entsprechend dem Gebietsschema des Benutzers (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 Benutzers zurück (z. B. 24.10.2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, wird die API standardmäßig auf mittelgesetzt. Bei akzeptierten Werten wird nicht zwischen Groß- und Kleinschreibung unterschieden.
    Tabelle : 21. Ergebnisse
    Typ Beschreibung
    void

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

    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(String date, String stil, String language)

    Legt ein Datum mit einem angegebenen Stil, einer Sprache und einem Format entsprechend dem Gebietsschema des aktuellen Benutzers fest.

    Tabelle : 22. Parameter
    Name Typ Beschreibung
    date Zeichenfolge Datumswert für das GlideDate-Objekt in der Zeitzone des aktuellen Benutzers. Gültige Werte sind alle Datums- und Uhrzeitausgaben der Funktion getDisplayValueLang().

    Wenn Sie beispielsweise die Ausgabe aus dem Beispiel getDisplayValueLang(String Style, String Language) weiter oben in diesem Thema verwenden, sind 25. Oktober 2022 oder 25.10.2022 akzeptierte Werte.
    -Stil Zeichenfolge Datumsformat.
    Gültige Werte:
    • full: Gibt das Datum im Format zurück<weekday, month, day, and year> entsprechend dem Gebietsschema des Benutzers (z. B. Montag, 24. Oktober 2022).
    • long: gibt das Datum im Format zurück<month, day, and year> entsprechend dem Gebietsschema des Benutzers (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 Benutzers zurück (z. B. 24.10.2022 oder 24/10/2022).

    Wenn ein anderer Wert übergeben wird, wird die API standardmäßig auf mittelgesetzt. Bei akzeptierten Werten wird nicht zwischen Groß- und Kleinschreibung unterschieden.
    language Zeichenfolge Legt die Sprache mithilfe eines Sprach-Tags fest, das dem BCP-47-Standard entspricht. Zum Beispiel „fr“ für Französisch oder „en-UK“ für englisches Englisch. Eine vollständige Liste der akzeptierten Werte finden Sie unter BCP 47-Sprachcodeliste.
    Tabelle : 23. Ergebnisse
    Typ Beschreibung
    void

    Im folgenden Beispiel werden Datum und Uhrzeit in Kurz- und Vollformat für Englisch und Französisch zurückgegeben.

    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(String o)

    Legt das Datum des aktuellen GlideDate-Objekts im internen Format (JJJJ-MM-TT) und die Systemzeitzone (standardmäßig UTC) fest.

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

    Format: jjjj-MM-tt
    Tabelle : 25. Ergebnisse
    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: Scoped GlideDate – setValue(String o).