# yearname - Skript- und Diagrammfunktion

Diese Funktion liefert den Zeitstempel der ersten Millisekunde des ersten Tages des Jahres, in dem date liegt. Das Ergebnis wird als vierstellige Jahreszahl formatiert.

Diagramm des Zeitraums der Funktion `yearname()`.

Diagramm des Zeitraums der Funktion `yearname()`.

Diagramm des Zeitraums der Funktion `yearname()`yearname(). ![Diagramm, das den Zeitraum anzeigt, in dem die Funktion „yearname“ ein Ergebnis zurückgibt.](https://help.qlik.com/de-DE/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-diagram1.png)

Die Funktion `yearname()` unterscheidet sich von der Funktion `year()` dahingehend, dass sie einen Versatz des Datums ermöglicht, das ausgewertet werden soll. Außerdem kann der erste Monat des Jahres festgelegt werden.

Wenn der erste Monat des Jahres nicht Januar ist, gibt die Funktion die beiden vierstelligen Jahreszahlen über den Zwölfmonatszeitraum zurück, die das Datum enthalten. Wenn beispielsweise das Jahr im April beginnt und das ausgewertete Datum 06/30/2020 ist, wird als Ergebnis `2020-2021` zurückgegeben.

Diagramm der Funktion `yearname()` mit April als erstem Monat des Jahres.

Diagramm der Funktion `yearname()` mit April als erstem Monat des Jahres.

Diagramm der Funktion `yearname()`yearname() mit April als erstem Monat des Jahres. ![Diagramm, welches anzeigt, dass die Funktion „yearname“ Datumsangaben innerhalb eines Zwölfmonatszeitraums identifizieren kann und dass ihre Rückgabe davon abhängen kann, welcher Monat als erster Monat des Jahres festgelegt ist](https://help.qlik.com/de-DE/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-diagram2.png)

Syntax:

YearName(date[, period\_no[, first\_month\_of\_year]] )

Rückgabe Datentyp: dual

| Argument | Beschreibung |
| --- | --- |
| date | Datum oder Zeitstempel für die Evaluierung. |
| period\_no | period\_no ist eine ganze Zahl, wobei 0 für das Jahr steht, das date enthält. Negative Werte von period\_no stehen für vorangehende, positive Werte für nachfolgende Jahre. |
| first\_month\_of\_year | Wenn Sie mit abweichenden Geschäftsjahren arbeiten möchten, definieren Sie mit einer Zahl zwischen 2 und 12 für first\_month\_of\_year einen anderen Startmonat. In diesem Fall besteht das Ergebnis aus zwei Jahreszahlen. |

Sie können die folgenden Werte verwenden, um den ersten Monat des Jahres im Argument `first_month_of_year` festzulegen.

Werte für first\_month\_of\_year

| Monat | Wert |
| --- | --- |
| Februar | 2 |
| März | 3 |
| April | 4 |
| Mai | 5 |
| Juni | 6 |
| Juli | 7 |
| August | 8 |
| September | 9 |
| Oktober | 10 |
| November | 11 |
| Dezember | 12 |

Verwendung

Die Funktion `yearname()` eignet sich für den Vergleich von Aggregierungen nach Jahr. Das ist beispielsweise der Fall, wenn Sie den Gesamtumsatz von Produkten nach Jahr anzeigen möchten.

Diese Dimensionen können im Ladeskript erstellt werden, indem die Funktion verwendet wird, um ein Feld in einer Master-Kalender-Tabelle zu erstellen. Sie können auch als berechnete Dimensionen in einem Diagramm erstellt werden.

## Regionaleinstellungen

Sofern nicht anders angegeben, verwenden die Beispiele in diesem Thema das folgende Datumsformat: MM/TT/JJJJ. Das Datumsformat wird in der Anweisung `SET DateFormat` in Ihrem Datenladeskript angegeben. Das Standarddatumsformat in Ihrem System kann aufgrund Ihrer regionalen Einstellungen und anderer Faktoren abweichen. Sie können die Formate in den Beispielen unten Ihren Anforderungen entsprechend ändern. Sie können auch die Formate in Ihrem Ladeskript entsprechend den Beispielen ändern.

Die standardmäßigen regionalen Einstellungen in Apps basieren auf den regionalen Systemeinstellungen der Computer oder Server, auf denen Qlik Sense installiert ist. Wenn der Qlik Sense-Server, auf den Sie zugreifen, auf Schweden festgelegt ist, verwendet der Dateneditor die schwedischen regionalen Einstellungen für Datums-, Uhrzeit- und Währungsangaben. Diese Einstellungen im regionalen Format hängen nicht mit der Sprache zusammen, die in der Benutzeroberfläche von Qlik Sense angezeigt wird. Qlik Sense wird in der gleichen Sprache wie der von Ihnen verwendete Browser angezeigt.

Funktionsbeispiele

| Beispiel | Ergebnis |
| --- | --- |
| `yearname('10/19/2001')` | Gibt „2001“ zurück. |
| `yearname('10/19/2001',-1)` | Gibt „2000“ zurück. |
| `yearname('10/19/2001',0,4)` | Gibt „2001-2002“ zurück. |

Verwandte Themen

| Thema | Beschreibung |
| --- | --- |
| [year - Skript- und Diagrammfunktion](https://help.qlik.com/de-DE/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm) | Diese Funktion liefert das Jahr als ganze Zahl, wenn die Formel entsprechend der Standardzahleninterpretation als Datum interpretiert wird. |

## Beispiel 1 – keine zusätzlichen Argumente

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.htm)

#### Ladeskript und Ergebnisse

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in einen neuen Abschnitt ein.

Das Ladeskript umfasst:

* Ein Datensatz, der eine Reihe von Transaktionen zwischen 2020 und 2022 enthält, wird in eine Tabelle namens „`Transactions`“ geladen.

* Die Systemvariable `DateFormat`, die auf „`MM/DD/YYYY`“ festgelegt ist.

* Ein vorangehender load-Befehl, der die Funktion `yearname()` verwendet und als das Feld `year_name` festgelegt ist.

Ladeskript

```
SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
    Load 
      *, 
      yearname(date) as year_name 
      ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/2020',88.27 
8191,'04/16/2020',57.42 
8192,'05/21/2020',53.80 
8193,'08/14/2020',82.06 
8194,'10/07/2020',40.39 
8195,'12/05/2020',87.21 
8196,'01/22/2021',95.93 
8197,'02/03/2021',45.89 
8198,'03/17/2021',36.23 
8199,'04/23/2021',25.66 
8200,'05/04/2021',82.77 
8201,'06/30/2021',69.98 
8202,'07/26/2021',76.11 
8203,'12/27/2021',25.12 
8204,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67 
]; 
```

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:

* `date`
* `year_name`

Ergebnistabelle

| Datum | year\_name |
| --- | --- |
| 01/13/2020 | 2020 |
| 02/26/2020 | 2020 |
| 03/27/2020 | 2020 |
| 04/16/2020 | 2020 |
| 05/21/2020 | 2020 |
| 08/14/2020 | 2020 |
| 10/07/2020 | 2020 |
| 12/05/2020 | 2020 |
| 01/22/2021 | 2021 |
| 02/03/2021 | 2021 |
| 03/17/2021 | 2021 |
| 04/23/2021 | 2021 |
| 05/04/2021 | 2021 |
| 06/30/2021 | 2021 |
| 07/26/2021 | 2021 |
| 12/27/2021 | 2021 |
| 06/06/2022 | 2022 |
| 07/18/2022 | 2022 |
| 11/14/2022 | 2022 |
| 12/12/2022 | 2022 |

Das Feld „`year_name`“ wird in der vorangehenden load-Anweisung erstellt, indem die Funktion `yearname()` verwendet und das Datumsfeld als Argument der Funktion übergeben wird.

Die Funktion `yearname()` identifiziert, in welches Jahr der Datumswert fällt, und gibt dies als vierstelligen Jahreswert zurück.

Diagramm der Funktion `yearname()`, die 2021 als den Jahreswert anzeigt

Diagramm der Funktion `yearname()`, die 2021 als den Jahreswert anzeigt

Diagramm der Funktion `yearname()`yearname(), die 2021 als den Jahreswert anzeigt![Diagramm, das anzeigt, dass die Funktion „yearname()“ den Wert 2021 für das Datum 17. März 2021 zurückgibt](https://help.qlik.com/de-DE/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example1-diagram.png)

## Beispiel 2 – period\_no

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.htm)

#### Ladeskript und Ergebnisse

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in einen neuen Abschnitt ein.

Das Ladeskript umfasst:

* Ein Datensatz, der eine Reihe von Transaktionen zwischen 2020 und 2022 enthält, wird in eine Tabelle namens „Transactions“ geladen.

* Die Systemvariable „DateFormat“, die auf „`MM/DD/YYYY`“ festgelegt ist.

* Eine vorangehende load-Anweisung, die die Funktion `yearname()` verwendet und als das Feld `year_name` festgelegt ist.

Ladeskript

```
SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
      *, 
      yearname(date,-1) as prior_year_name 
      ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/2020',88.27 
8191,'04/16/2020',57.42 
8192,'05/21/2020',53.80 
8193,'08/14/2020',82.06 
8194,'10/07/2020',40.39 
8195,'12/05/2020',87.21 
8196,'01/22/2021',95.93 
8197,'02/03/2021',45.89 
8198,'03/17/2021',36.23 
8199,'04/23/2021',25.66 
8200,'05/04/2021',82.77 
8201,'06/30/2021',69.98 
8202,'07/26/2021',76.11 
8203,'12/27/2021',25.12 
8204,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67 
];  
```

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:

* `date`
* `prior_year_name`

Ergebnistabelle

| Datum | prior\_year\_name |
| --- | --- |
| 01/13/2020 | 2019 |
| 02/26/2020 | 2019 |
| 03/27/2020 | 2019 |
| 04/16/2020 | 2019 |
| 05/21/2020 | 2019 |
| 08/14/2020 | 2019 |
| 10/07/2020 | 2019 |
| 12/05/2020 | 2019 |
| 01/22/2021 | 2020 |
| 02/03/2021 | 2020 |
| 03/17/2021 | 2020 |
| 04/23/2021 | 2020 |
| 05/04/2021 | 2020 |
| 06/30/2021 | 2020 |
| 07/26/2021 | 2020 |
| 12/27/2021 | 2020 |
| 06/06/2022 | 2021 |
| 07/18/2022 | 2021 |
| 11/14/2022 | 2021 |
| 12/12/2022 | 2021 |

Da eine `period_no` von `-1` als Versatzargument in der Funktion `yearname()` verwendet wird, identifiziert die Funktion zuerst das Jahr, in dem die Transaktionen stattfinden. Die Funktion wechselt dann zum vorherigen Jahr und gibt dieses Jahr als Ergebnis zurück.

Diagramm der Funktion `yearname()`, bei der `period_no` als `-1` festgelegt ist

Diagramm der Funktion `yearname()`, bei der `period_no` als `-1` festgelegt ist

Diagramm der Funktion `yearname()`yearname(), bei der `period_no`period\_no als `-1`-1 festgelegt ist![Diagramm, das anzeigt, wie eine „period_no“ von minus eins die Zeiträume ändert, die von der Funktion „yearname()“ identifiziert werden](https://help.qlik.com/de-DE/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example2-diagram.png)

## Beispiel 3 – first\_month\_of\_year

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.htm)

#### Ladeskript und Ergebnisse

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in einen neuen Abschnitt ein.

Das Ladeskript umfasst:

* Den gleichen Datensatz wie im ersten Beispiel.

* Die Systemvariable `DateFormat`, die auf „`MM/DD/YYYY`“ festgelegt ist.

* Eine vorangehende load-Anweisung, die die Funktion `yearname()` verwendet und als das Feld `year_name` festgelegt ist.

Ladeskript

```
SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
      *, 
      yearname(date,0,4) as year_name 
      ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/2020',88.27 
8191,'04/16/2020',57.42 
8192,'05/21/2020',53.80 
8193,'08/14/2020',82.06 
8194,'10/07/2020',40.39 
8195,'12/05/2020',87.21 
8196,'01/22/2021',95.93 
8197,'02/03/2021',45.89 
8198,'03/17/2021',36.23 
8199,'04/23/2021',25.66 
8200,'05/04/2021',82.77 
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11 
8203,'12/27/2021',25.12 
8204,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67 
];
```

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:

* `id`
* `date`
* `year_name`

Ergebnistabelle

| Datum | year\_name |
| --- | --- |
| 01/13/2020 | 2019-2020 |
| 02/26/2020 | 2019-2020 |
| 03/27/2020 | 2019-2020 |
| 04/16/2020 | 2020-2021 |
| 05/21/2020 | 2020-2021 |
| 08/14/2020 | 2020-2021 |
| 10/07/2020 | 2020-2021 |
| 12/05/2020 | 2020-2021 |
| 01/22/2021 | 2020-2021 |
| 02/03/2021 | 2020-2021 |
| 03/17/2021 | 2020-2021 |
| 04/23/2021 | 2021-2022 |
| 05/04/2021 | 2021-2022 |
| 06/30/2021 | 2021-2022 |
| 07/26/2021 | 2021-2022 |
| 12/27/2021 | 2021-2022 |
| 06/06/2022 | 2022-2023 |
| 07/18/2022 | 2022-2023 |
| 11/14/2022 | 2022-2023 |
| 12/12/2022 | 2022-2023 |

Da das Argument `first_month_of_year` von `4` in der Funktion `yearname()` verwendet wird, verschiebt sich der Jahresbeginn vom 1. Januar zum 1. April. Daher liegt jeder Zwölfmonatszeitraum zwischen zwei Kalenderjahren, und die Funktion `yearname()` gibt zwei vierstellige Jahreszahlen für jedes ausgewertete Datum zurück.

Transaktion 8198 findet am 17. März 2021 statt. Die Funktion `yearname()` legt den Jahresbeginn auf den 1. April und das Jahresende auf den 30. März fest. Infolgedessen fand die Transaktion 8198 im Jahreszeitraum vom 1. April 2020 bis zum 30. März 2021 statt. Somit gibt die Funktion `yearname()` den Wert 2020-2021 zurück.

Diagramm der Funktion `yearname()` mit März als erstem Monat des Jahres

Diagramm der Funktion `yearname()` mit März als erstem Monat des Jahres

Diagramm der Funktion `yearname()`yearname() mit März als erstem Monat des Jahres![Diagramm mit dem Zeitraum, den die Funktion „yearname()“ identifiziert, wenn der erste Monat des Jahres als März festgelegt ist](https://help.qlik.com/de-DE/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example3-diagram.png)

## Beispiel 4 – Diagrammobjektbeispiel

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.htm)

#### Ladeskript und Diagrammformel

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in einen neuen Abschnitt ein.

Das Ladeskript umfasst:

* Den gleichen Datensatz wie im ersten Beispiel.

* Die Systemvariable `DateFormat`, die auf „`MM/DD/YYYY`“ festgelegt ist.

Das Feld, das das Jahr zurückgibt, in dem die Transaktion stattfand, wird jedoch als Kennzahl in einem Diagrammobjekt erstellt.

Ladeskript

```
SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/2020',88.27 
8191,'04/16/2020',57.42 
8192,'05/21/2020',53.80 
8193,'08/14/2020',82.06 
8194,'10/07/2020',40.39 
8195,'12/05/2020',87.21 
8196,'01/22/2021',95.93 
8197,'02/03/2021',45.89 
8198,'03/17/2021',36.23 
8199,'04/23/2021',25.66 
8200,'05/04/2021',82.77 
8201,'06/30/2021',69.98 
8202,'07/26/2021',76.11 
8203,'12/27/2021',25.12 
8204,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67 
];	
```

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie dieses Feld als Dimension hinzu:

`date`

Um das Feld „`year_name`“ zu berechnen, erstellen Sie die folgende Kennzahl:

`=yearname(date)`

Ergebnistabelle

| Datum | =yearname(date) |
| --- | --- |
| 01/13/2020 | 2020 |
| 02/26/2020 | 2020 |
| 03/27/2020 | 2020 |
| 04/16/2020 | 2020 |
| 05/21/2020 | 2020 |
| 08/14/2020 | 2020 |
| 10/07/2020 | 2020 |
| 12/05/2020 | 2020 |
| 01/22/2021 | 2021 |
| 02/03/2021 | 2021 |
| 03/17/2021 | 2021 |
| 04/23/2021 | 2021 |
| 05/04/2021 | 2021 |
| 06/30/2021 | 2021 |
| 07/26/2021 | 2021 |
| 12/27/2021 | 2021 |
| 06/06/2022 | 2022 |
| 07/18/2022 | 2022 |
| 11/14/2022 | 2022 |
| 12/12/2022 | 2022 |

Die Kennzahl „`year_name`“ wird im Diagrammobjekt erstellt, indem die Funktion `yearname()` verwendet und das Feld als Argument der Funktion übergeben wird.

Die Funktion `yearname()` identifiziert, in welches Jahr der Datumswert fällt, und gibt dies als vierstelligen Jahreswert zurück.

Diagramm der Funktion `yearname()` mit 2021 als Jahreswert

Diagramm der Funktion `yearname()` mit 2021 als Jahreswert

Diagramm der Funktion `yearname()`yearname() mit 2021 als Jahreswert![Diagramm der Funktion „yearname()“, die 2021 als den Jahreswert anzeigt](https://help.qlik.com/de-DE/sense/November2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example4-diagram.png)

## Beispiel 5 – Szenario

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.htm)

#### Ladeskript und Diagrammformel

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in einen neuen Abschnitt ein.

Das Ladeskript umfasst:

* Den gleichen Datensatz wie im ersten Beispiel.

* Die Systemvariable DateFormat, die auf „MM/DD/YYYY“ festgelegt ist.

Der Endbenutzer möchte ein Diagramm, das den Gesamtumsatz nach Quartal für die Transaktionen darstellt. Verwenden Sie die Funktion yearname() als berechnete Dimension, um dieses Diagramm zu erstellen, wenn die Dimension yearname() im Datenmodell nicht verfügbar ist.

Ladeskript

```
SET DateFormat='MM/DD/YYYY'; 

Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/2020',88.27 
8191,'04/16/2020',57.42 
8192,'05/21/2020',53.80 
8193,'08/14/2020',82.06 
8194,'10/07/2020',40.39 
8195,'12/05/2020',87.21 
8196,'01/22/2021',95.93 
8197,'02/03/2021',45.89 
8198,'03/17/2021',36.23 
8199,'04/23/2021',25.66 
8200,'05/04/2021',82.77 
8201,'06/30/2021',69.98 
8202,'07/26/2021',76.11 
8203,'12/27/2021',25.12 
8204,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67 
];
```

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle.

Erstellen Sie die folgende berechnete Dimension, um Aggregierungen nach Jahr zu vergleichen:

=yearname(date)

Erstellen Sie die folgende Kennzahl:

=sum(amount)

Legen Sie die Zahlenformatierung der Kennzahl auf Währung fest.

Ergebnistabelle

| yearname(date) | =sum(amount) |
| --- | --- |
| 2020 | $463.55 |
| 2021 | $457.69 |
| 2022 | $294.35 |