---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideDate: Bereichsbezogen

# GlideDate: Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 Minuten Lesedauer

Die bereichsbezogene GlideDate -Klasse bietet Methoden zum Durchführen von Vorgängen mit GlideDate-Objekten, z. B. das Instanziieren von GlideDate-Objekten oder das Arbeiten mit GlideDate-Feldern.

Anleitungen zu Datums-/Uhrzeiteingabezeichenfolgen mit einer Liste häufiger Formatkonflikte finden Sie unter [Richtlinien für das Datums- und Uhrzeitformat](https://www.servicenow.com/docs/PdiBb4QmDbBOYIv~yCOyZw#date-and-time-format-guidelines "Sie können ein Datumsformat mit einer Sequenz bestimmter Datums- und Uhrzeitmusterzeichenfolgen angeben. Eine Musterzeichenfolge besteht aus einem oder mehreren Groß- und Kleinbuchstaben von A bis Z. Text in Anführungszeichen wird ignoriert und stattdessen in die Datumsausgabe kopiert.").

## Scoped GlideDate -- GlideDate() {#ariaid-title2}

Erzeugt ein GlideDate-Objekt mit aktuellem Datum und Uhrzeit.
{#r_ScopedGlideDateGlideDate__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#r_ScopedGlideDateGlideDate__table_vy2_525_jq}  

    //Today's date is April 21, 2021
    var gd = new GlideDate();
    gs.info(gd.getValue());

Ausgabe:

    2021-04-21

## Scoped GlideDate -- getByFormat(String format) {#ariaid-title3}

Ruft das Datum im angegebenen Datumsformat ab.
{#r_ScopedGlideDateGetByFormat_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| format | Zeichenfolge | Gewünschtes Datumsformat mit Java [SimpleDateFormat](https://docs.oracle.com/javase/10/docs/api/java/text/SimpleDateFormat.html) Beispiel: `„TT-MM-JJJJ"`, um Tag, Monat und Jahr abzurufen, oder `„EEEE"`, um den Wochentag abzurufen. |
[Tabelle : 2. Parameter]

{#r_ScopedGlideDateGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideDateGetByFormat_String__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Datumswert für das GlideDate-Objekt im angegebenen Format. |
[Tabelle : 3. Ergebnisse]

{#r_ScopedGlideDateGetByFormat_String__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gd.setValue('2021-04-21');
    gs.info(gd.getByFormat("dd-MM-yyyy"));

Ausgabe:

    21-04-2021

## Scoped GlideDate -- getDayOfMonthNoTZ() {#ariaid-title4}

Ruft den Tag des Monats ab, der vom GlideDate-Objekt gespeichert wird, ausgegeben in der UTC-Zeitzone.
{#r_SGD-getDayOfMonthNoTZ__table_gdd_z5q_yv__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 4. Parameter]

{#r_SGD-getDayOfMonthNoTZ__table_gdd_z5q_yv} {#r_SGD-getDayOfMonthNoTZ__table_hdd_z5q_yv__entry__2}

| Typ | Beschreibung |
|-|-|
| Zahl | Der Tag des Monats in der UTC-Zeitzone, von 1 bis 31. |
[Tabelle : 5. Ergebnisse]

{#r_SGD-getDayOfMonthNoTZ__table_hdd_z5q_yv}  

    //Today's date is 2016-05-13 
    var gd =new GlideDate();
    gs.info(gd.getDayOfMonthNoTZ());

Ausgabe:

    13

## Scoped GlideDate -- getDisplayValue() {#ariaid-title5}

Ruft das Datum im Anzeigeformat und in der Zeitzone des aktuellen Benutzers ab.
{#r_ScopedGlideDateGetDisplayValue__table_vy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 6. Parameter]

{#r_ScopedGlideDateGetDisplayValue__table_vy2_535_jq} {#r_ScopedGlideDateGetDisplayValue__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Datumswert für das GlideDate-Objekt im Anzeigeformat und in der Zeitzone des aktuellen 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. |
[Tabelle : 7. Ergebnisse]

{#r_ScopedGlideDateGetDisplayValue__table_qpt_3f5_jq}  

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

Ausgabe:

    2021-04-21

## Scoped GlideDate -- getDisplayValueInternal() {#ariaid-title6}

Ruft das Datum im internen Format (JJJJ-MM-TT) und die Zeitzone des aktuellen Anwenders ab.
{#r_ScopedGlideDateGetDisplayValueInternal__table_vy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 8. Parameter]

{#r_ScopedGlideDateGetDisplayValueInternal__table_vy2_535_jq} {#r_ScopedGlideDateGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Datumswert für das GlideDate-Objekt in der Zeitzone des aktuellen Anwenders. Format: JJJJ-MM-TT |
[Tabelle : 9. Ergebnisse]

{#r_ScopedGlideDateGetDisplayValueInternal__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gs.info(gd.getDisplayValueInternal());

Ausgabe:

    2021-04-21

## Bereichsbezogenes GlideDate -- getDisplayValueLang(Zeichenfolgenstil, Zeichenfolgensprache) {#ariaid-title7}

Gibt den Datumswert im Gebietsschema des Anwenders gemäß einer angegebenen Sprache und einem angegebenen Datumsstil zurück.
{#r_SGD-getDisplayValueLang_S_S__id_a2q_p5w_dwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Stil | Zeichenfolge | Datumsformat. 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](https://appmakers.dev/bcp-47-language-codes-list/). |
[Tabelle : 10. Parameter]

{#r_SGD-getDisplayValueLang_S_S__id_a2q_p5w_dwb} {#r_SGD-getDisplayValueLang_S_S__id_wwn_q5w_dwb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Datum in Stil und Sprache, die gemäß dem Gebietsschema des aktuellen Anwenders angegeben sind. |
[Tabelle : 11. Ergebnisse]

{#r_SGD-getDisplayValueLang_S_S__id_wwn_q5w_dwb}  
Im folgenden Beispiel wird das Datum des Gebietsschemas des Anwenders in verschiedenen Sprachen und Stilen zurückgegeben.

    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

## Scoped GlideDate -- getMonthNoTZ() {#ariaid-title8}

Ruft den vom GlideDate-Objekt gespeicherten Monat ab, der in der UTC-Zeitzone angegeben ist.
{#r_SGD-getMonthNoTZ__table_az1_3wq_yv__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 12. Parameter]

{#r_SGD-getMonthNoTZ__table_az1_3wq_yv} {#r_SGD-getMonthNoTZ__table_bz1_3wq_yv__entry__2}

| Typ | Beschreibung |
|-|-|
| Zahl | Der Zahlenwert des Monats von 1 bis 12. |
[Tabelle : 13. Ergebnisse]

{#r_SGD-getMonthNoTZ__table_bz1_3wq_yv}  

    //Today's date is 2016-05-13
    var gd =new GlideDate();
    gs.info(gd.getMonthNoTZ());

Ausgabe:

    5

## Scoped GlideDate -- getValue() {#ariaid-title9}

Ruft das Datum im internen Format (JJJJ-MM-TT) und die Systemzeitzone (UTC, Standard) ab.
{#r_ScopedGlideDateGetValue__table_vy2_535_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 14. Parameter]

{#r_ScopedGlideDateGetValue__table_vy2_535_jq} {#r_ScopedGlideDateGetValue__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Datumswert für das GlideDate-Objekt in der Systemzeitzone. Format: JJJJ-MM-TT |
[Tabelle : 15. Ergebnisse]

{#r_ScopedGlideDateGetValue__table_qpt_3f5_jq}  

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

Ausgabe:

    2021-04-21

## Scoped GlideDate -- getYearNoTZ() {#ariaid-title10}

Ruft das Jahr ab, das vom GlideDate-Objekt gespeichert wird, ausgegeben in der UTC-Zeitzone.
{#r_SGD-getYearNoTZ__table_pnp_hxq_yv__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 16. Parameter]

{#r_SGD-getYearNoTZ__table_pnp_hxq_yv} {#r_SGD-getYearNoTZ__table_qnp_hxq_yv__entry__2}

| Typ | Beschreibung |
|-|-|
| Zahl | Der Zahlenwert des Jahres. |
[Tabelle : 17. Ergebnisse]

{#r_SGD-getYearNoTZ__table_qnp_hxq_yv}  

    //Today's date is 2016-05-13
    var gd =new GlideDate();
    gs.info(gd.getYearNoTZ());

Ausgabe:

    2016

## Scoped GlideDate -- setDisplayValue(String asDisplayed) {#ariaid-title11}

Legt einen Datumswert unter Verwendung des Anzeigeformats und der Zeitzone des aktuellen Benutzers fest.
{#r_ScopedGlideDateSetDisplayValue_String__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| asDisplayed | Zeichenfolge | Datum in Anzeigeformat und Zeitzone des aktuellen Anwenders. Format: Muss mit dem bevorzugten Anzeigeformat des aktuellen Anwenders formatiert werden, z. B. jjjj-MM-tt. |
[Tabelle : 18. Parameter]

{#r_ScopedGlideDateSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideDateSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 19. Ergebnisse]

{#r_ScopedGlideDateSetDisplayValue_String__table_qpt_3f5_jq1}  

    var gd = new GlideDate();
    gd.setDisplayValue("2011-01-01");
    gs.info(gd.getValue());

Ausgabe:

    2011-01-01

## Bereichsbezogenes GlideDate -- setDisplayValueLang(Zeichenfolgedatum, Zeichenfolgenstil) {#ariaid-title12}

Legt ein Datum mit einem angegebenen Stil und Format entsprechend dem Gebietsschema des aktuellen Anwenders fest.
{#r_SGD-setDisplayValueLang_S_S__id_m14_55w_dwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| date | Zeichenfolge | Datumswert 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(Zeichenfolgestil, Zeichenfolgensprache) 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\> 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 : 20. Parameter]

{#r_SGD-setDisplayValueLang_S_S__id_m14_55w_dwb} {#r_SGD-setDisplayValueLang_S_S__id_xh1_v5w_dwb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 21. Ergebnisse]

{#r_SGD-setDisplayValueLang_S_S__id_xh1_v5w_dwb}  
Das folgende Beispiel zeigt, wie Sie das aktuelle Datum des Gebietsschemas des Anwenders 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

## Bereichsbezogenes GlideDate - setDisplayValueLang(Zeichenfolgendatum, Zeichenfolgenstil, Zeichenfolgensprache) {#ariaid-title13}

Legt ein Datum mit einem bestimmten Stil, einer bestimmten Sprache und einem bestimmten Format entsprechend dem Gebietsschema des aktuellen Anwenders fest.
{#r_SGD-setDisplayValueLang_S_S_S__id_kns_w5w_dwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| date | Zeichenfolge | Datumswert 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(Zeichenfolgestil, Zeichenfolgensprache) 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\> 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](https://appmakers.dev/bcp-47-language-codes-list/). |
[Tabelle : 22. Parameter]

{#r_SGD-setDisplayValueLang_S_S_S__id_kns_w5w_dwb} {#r_SGD-setDisplayValueLang_S_S_S__id_j5m_x5w_dwb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 23. Ergebnisse]

{#r_SGD-setDisplayValueLang_S_S_S__id_j5m_x5w_dwb}  
Im folgenden Beispiel werden Datum und Uhrzeit in kurzen und vollständigen Stilen 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

## Scoped GlideDate -- setValue(String o) {#ariaid-title14}

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

| Name | Typ | Beschreibung |
|-|-|-|
| o | Zeichenfolge | Datum und Uhrzeit, die im aktuellen GlideDate-Objekt festgelegt werden sollen. Format: JJJJ-MM-TT |
[Tabelle : 24. Parameter]

{#r_ScopedGlideDateSetValue_String__table_vy2_525_jq} {#r_ScopedGlideDateSetValue_String__table_qpt_3f5_jq1__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 25. Ergebnisse]

{#r_ScopedGlideDateSetValue_String__table_qpt_3f5_jq1}  

    var gd = new GlideDate(); 
    gd.setValue('2015-01-01');
    gs.info(gd.getValue());

Ausgabe:

    2015-01-01

## Scoped GlideDate -- subtract(GlideDate start, GlideDate end) {#ariaid-title15}

Ruft die Laufzeitdifferenz zwischen zwei GlideDate-Werten ab.
{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_vy2_525_jq__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| start | GlideDate | Der Startwert. |
| end | GlideDate | Der Endwert. |
[Tabelle : 26. Parameter]

{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_vy2_525_jq} {#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_qpt_3f5_jq__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideDuration | Die Dauer zwischen den beiden Werten. |
[Tabelle : 27. Ergebnisse]

{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_qpt_3f5_jq}  

    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