---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideDate -- Umfang

# GlideDate -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 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](https://servicenow-prod.fluidtopics.net/oQfsITLmYDkL95UEc1aX9g#date-and-time-format-guidelines "Sie können ein Datumsformat mit einer Sequenz bestimmter Datums- und Zeitmusterzeichenfolgen angeben. Eine Musterzeichenfolge besteht aus einem oder mehreren Groß- und Kleinbuchstaben von A bis Z. Jeder Text in Anführungszeichen wird ignoriert und stattdessen in die Datumsausgabe kopiert.").

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

Erstellt ein GlideDate-Objekt mit dem aktuellen Datum/der aktuellen 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

## Bereichsbezogenes GlideDate -- getByFormat (Zeichenfolgenformat) {#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 den Tag, den Monat und das Jahr oder abzurufen `„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. Rückgaben]

{#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

## Bereichsbezogenes GlideDate -- getDayofMonthNoTZ() {#ariaid-title4}

Ruft den Tag des Monats ab, der vom GlideDate-Objekt gespeichert wird, ausgedrückt 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 |
|-|-|
| Nummer | Der Tag des Monats in der UTC-Zeitzone, von 1 bis 31. |
[Tabelle : 5. Rückgaben]

{#r_SGD-getDayOfMonthNoTZ__table_hdd_z5q_yv}  

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

Ausgabe:

    13

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

Ruft das Datum im Anzeigeformat und in der Zeitzone des aktuellen Anwenders 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 der Zeitzone des aktuellen Anwenders. Beachten Sie beim Entwerfen von Business-Regeln oder Skripteinbindungen, dass diese Methode Werte in verschiedenen Formaten für verschiedene Anwender zurückgeben kann. |
[Tabelle : 7. Rückgaben]

{#r_ScopedGlideDateGetDisplayValue__table_qpt_3f5_jq}  

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

Ausgabe:

    2021-04-21

## Bereichsbezogenes 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. Rückgaben]

{#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: * 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](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 im Stil und in der Sprache, die gemäß dem Gebietsschema des aktuellen Anwenders angegeben sind. |
[Tabelle : 11. Rückgaben]

{#r_SGD-getDisplayValueLang_S_S__id_wwn_q5w_dwb}  
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() {#ariaid-title8}

Ruft den vom GlideDate-Objekt gespeicherten Monat ab, ausgedrückt in der UTC-Zeitzone.
{#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 |
|-|-|
| Nummer | Der numerische Wert des Monats von 1 bis 12. |
[Tabelle : 13. Rückgaben]

{#r_SGD-getMonthNoTZ__table_bz1_3wq_yv}  

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

Ausgabe:

    5

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

Ruft das Datum im internen Format (jjjj-MM-tt) und die Systemzeitzone (standardmäßig UTC) 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. Rückgaben]

{#r_ScopedGlideDateGetValue__table_qpt_3f5_jq}  

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

Ausgabe:

    2021-04-21

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

Ruft das vom GlideDate-Objekt gespeicherte Jahr ab, ausgedrückt 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 |
|-|-|
| Nummer | Der numerische Wert des Jahres. |
[Tabelle : 17. Rückgaben]

{#r_SGD-getYearNoTZ__table_qnp_hxq_yv}  

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

Ausgabe:

    2016

## Bereichsbezogenes GlideDate -- setDisplayValue(Zeichenfolge asDisplayed) {#ariaid-title11}

Legt einen Datumswert mithilfe des Anzeigeformats und der Zeitzone des aktuellen Anwenders fest.
{#r_ScopedGlideDateSetDisplayValue_String__table_vy2_525_jq__entry__3}

| 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 : 18. Parameter]

{#r_ScopedGlideDateSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideDateSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 19. Rückgaben]

{#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(Zeichenfolgendatum, Zeichenfolgenstil) {#ariaid-title12}

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

| 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 : 20. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 21. Rückgaben]

{#r_SGD-setDisplayValueLang_S_S__id_xh1_v5w_dwb}  
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) {#ariaid-title13}

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

| 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](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. Rückgaben]

{#r_SGD-setDisplayValueLang_S_S_S__id_j5m_x5w_dwb}  
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) {#ariaid-title14}

Legt das Datum des aktuellen GlideDate-Objekts im internen Format (jjjj-MM-tt) und in der 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. Rückgaben]

{#r_ScopedGlideDateSetValue_String__table_qpt_3f5_jq1}  

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

Ausgabe:

    2015-01-01

## Bereichsbezogenes GlideDate -- abziehen(GlideDate-Start, GlideDate-Ende) {#ariaid-title15}

Ruft die Differenz der Dauer 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. Rückgaben]

{#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


