# quartername Skript- und Diagrammfunktion

Diese Funktion liefert den Zeitstempel der ersten Millisekunde des ersten Tags des Quartals. Das Ergebnis wird als Kombination von Monaten (entsprechend der Skriptvariablen MonthNames) und Jahr formatiert.

Syntax:

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

Rückgabe Datentyp: dual

Diagramm der Funktion `quartername()`

Diagramm der Funktion `quartername()`

Diagramm der Funktion `quartername()`quartername() ![Das Beispieldiagramm zeigt, wie die Funktion „quartername“ ein Eingabedatum in einen Bereich von Monaten konvertiert, die in dem Quartal liegen, in das das Datum fällt.](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-general.png)

Die Funktion `quartername()` bestimmt, in welches Quartal das Datum fällt. Dann gibt sie einen Wert zurück, der die Start- und Endmonate dieses Quartals sowie das Jahr zeigt. Der zugrunde liegende numerische Wert dieses Ergebnisses ist die erste Millisekunde des Quartals.

Argumente

| Argument | Beschreibung |
| --- | --- |
| date | Datum oder Zeitstempel für die Evaluierung. |
| period\_no | period\_no ist eine ganze Zahl, wobei 0 für das Quartal steht, das date enthält. Negative Werte von period\_no stehen für vorangehende, positive Werte für nachfolgende Quartale. |
| 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. |

## Verwendung von quartername

Die Funktion `quartername()` ist nützlich, wenn Sie Aggregierungen nach Quartal vergleichen möchten. Das ist beispielsweise der Fall, wenn Sie den Gesamtumsatz von Produkten nach Quartal anzeigen möchten.

Diese Funktion kann im Ladeskript verwendet werden, um ein Feld in einer Master-Kalender-Tabelle zu erstellen. Alternativ kann sie direkt als berechnete Dimension in einem Diagramm verwendet werden.

In diesen Beispielen wird das Datumsformat MM/TT/JJJJ verwendet. Das Datumsformat wird im Befehl `SET DateFormat` oben in Ihrem Datenladeskript angegeben. Ändern Sie das Format in den Beispielen nach Bedarf.

Funktionsbeispiele

| Beispiel | Ergebnis |
| --- | --- |
| `quartername('10/29/2013')` | Liefert Oct-Dec 2013. |
| `quartername('10/29/2013', -1)` | Liefert Jul-Sep 2013. |
| `quartername('10/29/2013', 0, 3)` | Liefert Sep-Nov 2013. |

## 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. Weitere Informationen finden Sie unter [Ändern von regionalen Einstellungen für Anwendungen und Skripte](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/regional-settings-in-apps.htm).

Regionale Standardeinstellungen in Anwendungen basieren auf dem Benutzerprofil. Diese Einstellungen im regionalen Format hängen nicht mit der Sprache zusammen, die in der Benutzeroberfläche von Qlik Cloud angezeigt wird. Qlik Cloud wird in der gleichen Sprache wie der von Ihnen verwendete Browser angezeigt.

Wenn Sie Anwendungsersteller sind, können Sie die Standardregion für die von Ihnen erstellten Anwendungen festlegen. Weitere Informationen finden Sie unter [Festlegen der bevorzugten regionalen Einstellungen für die App-und Skripterstellung in Qlik Cloud Analytics](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/UserInterface/Languages.htm#Setting).

## Beispiel 1 – Datum ohne zusätzliche Argumente

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.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 enthält eine Reihe von Transaktionen für 2022 und wird in eine Tabelle namens `Transactions` geladen.

* Das Datumsfeld wird im Format der Systemvariablen `DateFormat` (MM/TT/JJJJ) bereitgestellt.

* Es wird ein Feld `transaction_quarter` erstellt, das das Quartal zurückgibt, in dem die Transaktionen stattfanden.

Fügen Sie bei Bedarf hier weiteren Text mit Listen usw. hinzu.

Ladeskript

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date) as transaction_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/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`

* `transaction_quarter`

Ergebnistabelle

| Datum | transaction\_quarter |
| --- | --- |
| 1/7/2022 | Jan–Mär 2022 |
| 1/19/2022 | Jan–Mär 2022 |
| 2/5/2022 | Jan–Mär 2022 |
| 2/28/2022 | Jan–Mär 2022 |
| 3/16/2022 | Jan–Mär 2022 |
| 4/1/2022 | Apr–Jun 2022 |
| 5/7/2022 | Apr–Jun 2022 |
| 5/16/2022 | Apr–Jun 2022 |
| 6/15/2022 | Apr–Jun 2022 |
| 6/26/2022 | Apr–Jun 2022 |
| 7/9/2022 | Jul–Sep 2022 |
| 7/22/2022 | Jul–Sep 2022 |
| 7/23/2022 | Jul–Sep 2022 |
| 7/27/2022 | Jul–Sep 2022 |
| 8/2/2022 | Jul–Sep 2022 |
| 8/8/2022 | Jul–Sep 2022 |
| 8/19/2022 | Jul–Sep 2022 |
| 9/26/2022 | Jul–Sep 2022 |
| 10/14/2022 | Okt–Dez 2022 |
| 10/29/2022 | Okt–Dez 2022 |

Das Feld `transaction_quarter` wird im vorangehenden load-Befehl erstellt, indem die Funktion `quartername()` verwendet und das Datumsfeld als Argument der Funktion übergeben wird.

Die Funktion `quartername()` identifiziert zunächst das Quartal, in das der Datumswert fällt. Dann gibt sie einen Wert zurück, der die Start- und Endmonate dieses Quartals sowie das Jahr zeigt.

Diagramm der Funktion `quartername()`, Beispiel ohne zusätzliche Argumente

Diagramm der Funktion `quartername()`, Beispiel ohne zusätzliche Argumente

Diagramm der Funktion `quartername()`quartername(), Beispiel ohne zusätzliche Argumente ![Das Diagramm zeigt, wie die Funktion „quartername“ den Bereich der Monate des Quartals bestimmt, in dem eine Transaktion stattfindet.](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-no-add-arg.png)

Transaktion 8203 fand am 8. August 2022 statt. Die Funktion `quartername()` identifiziert, dass die Transaktion im dritten Quartal stattfand, und gibt daher Jul-Sep 2022 zurück. Die Monate werden im Format der Systemvariablen `MonthNames` angezeigt.

## Beispiel 2 – Datum mit Argument „period\_no“

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

#### Ladeskript und Ergebnisse

Übersicht

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

Das Ladeskript umfasst:

* Derselbe Datensatz und dasselbe Szenario wie im ersten Beispiel.

* Es wird ein Feld `previous_quarter` erstellt, das das Quartal vor dem Quartal zurückgibt, in dem die Transaktionen stattfanden.

Ladeskript

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date,-1) as previous_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/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`

* `previous_quarter`

Ergebnistabelle

| Datum | previous\_quarter |
| --- | --- |
| 1/7/2022 | Okt–Dez 2021 |
| 1/19/2022 | Okt–Dez 2021 |
| 2/5/2022 | Okt–Dez 2021 |
| 2/28/2022 | Okt–Dez 2021 |
| 3/16/2022 | Okt–Dez 2021 |
| 4/1/2022 | Jan–Mär 2022 |
| 5/7/2022 | Jan–Mär 2022 |
| 5/16/2022 | Jan–Mär 2022 |
| 6/15/2022 | Jan–Mär 2022 |
| 6/26/2022 | Jan–Mär 2022 |
| 7/9/2022 | Apr–Jun 2022 |
| 7/22/2022 | Apr–Jun 2022 |
| 7/23/2022 | Apr–Jun 2022 |
| 7/27/2022 | Apr–Jun 2022 |
| 8/2/2022 | Apr–Jun 2022 |
| 8/8/2022 | Apr–Jun 2022 |
| 8/19/2022 | Apr–Jun 2022 |
| 9/26/2022 | Apr–Jun 2022 |
| 10/14/2022 | Jul–Sep 2022 |
| 10/29/2022 | Jul–Sep 2022 |

Da in diesem Fall eine `period_no` von -1 als Versatzargument in der Funktion `quartername()` verwendet wurde, identifiziert die Funktion zuerst, dass die Transaktionen im dritten Quartal stattfanden. Dann geht sie ein Quartal zurück und gibt einen Wert zurück, der die Start- und Endmonate dieses Quartals sowie das Jahr zeigt.

Diagramm der Funktion `quartername()`, Beispiel „period\_no“

Diagramm der Funktion `quartername()`, Beispiel „period\_no“

Diagramm der Funktion `quartername()`quartername(), Beispiel „period\_no“ ![Das Diagramm zeigt, wie die Funktion „quartername“ den Bereich der Monate des Quartals bestimmt, in dem eine Transaktion stattfindet.](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-period-no.png)

Transaktion 8203 fand am 8. August statt. Die Funktion `quartername()` identifiziert, dass das Quartal vor dem Quartal, in dem die Transaktion stattfand, zwischen dem 1. April und 30. Juni lag. Somit wird Apr-Jun 2022 zurückgegeben.

## Beispiel 3 – Datum mit dem Argument „first\_week\_day“

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

#### Ladeskript und Ergebnisse

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.

Das Ladeskript verwendet den gleichen Datensatz und das gleiche Szenario wie das erste Beispiel. In diesem Beispiel müssen wir aber den 1. März als Beginn des Geschäftsjahres festlegen.

Ladeskript

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date,0,3) as transaction_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/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`

* `transaction_quarter`

Ergebnistabelle

| Datum | transaction\_quarter |
| --- | --- |
| 1/7/2022 | Dez–Feb 2021 |
| 1/19/2022 | Dez–Feb 2021 |
| 2/5/2022 | Dez–Feb 2021 |
| 2/28/2022 | Dez–Feb 2021 |
| 3/16/2022 | Mär–Mai 2022 |
| 4/1/2022 | Mär–Mai 2022 |
| 5/7/2022 | Mär–Mai 2022 |
| 5/16/2022 | Mär–Mai 2022 |
| 6/15/2022 | Jun–Aug 2022 |
| 6/26/2022 | Jun–Aug 2022 |
| 7/9/2022 | Jun–Aug 2022 |
| 7/22/2022 | Jun–Aug 2022 |
| 7/23/2022 | Jun–Aug 2022 |
| 7/27/2022 | Jun–Aug 2022 |
| 8/2/2022 | Jun–Aug 2022 |
| 8/8/2022 | Jun–Aug 2022 |
| 8/19/2022 | Jun–Aug 2022 |
| 9/26/2022 | Sep–Nov 2022 |
| 10/14/2022 | Sep–Nov 2022 |
| 10/29/2022 | Sep–Nov 2022 |

Da in diesem Fall das Argument `first_month_of_year` von 3 in der Funktion `quartername()` verwendet wird, wird der Start des Jahres vom 1. Januar zum 1. März verschoben. Somit werden die Quartale des Jahres in März-Mai, Juni-August, September-November und Dezember-Februar unterteilt.

Diagramm der Funktion `quartername()`, Beispiel „first\_week\_day“

Diagramm der Funktion `quartername()`, Beispiel „first\_week\_day“

Diagramm der Funktion `quartername()`quartername(), Beispiel „first\_week\_day“ ![Das Diagramm zeigt, wie die Funktion „quartername“ den Bereich der Monate des Quartals bestimmt, in dem eine Transaktion stattfindet.](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-first-week-day.png)

Transaktion 8203 fand am 8. August statt. Die Funktion `quartername()` identifiziert, dass die Transaktion im zweiten Quartal stattfand, zwischen Anfang Juni und Ende August. Somit wird Jun-Aug 2022 zurückgegeben.

## Beispiel 4 – Diagrammobjektbeispiel

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

#### Ladeskript und Diagrammformel

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein.

Das Ladeskript verwendet den gleichen Datensatz und das gleiche Szenario wie das erste Beispiel.

In diesem Beispiel wird jedoch der unveränderte Datensatz in die Anwendung geladen. Die Berechnung, die einen Zeitstempel für das Ende des Quartals zurückgibt, in dem die Transaktionen stattfanden, wird als Kennzahl in einem Diagrammobjekt der Anwendung erstellt.

Ladeskript

```
Transactions:
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/022,84.21
8206,10/14/2022,96.24
8207,10/29/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.

Erstellen Sie die folgende Kennzahl:

=quartername(date)

Ergebnistabelle

| Datum | =quartername(date) |
| --- | --- |
| 1/7/2022 | Jan–Mär 2022 |
| 1/19/2022 | Jan–Mär 2022 |
| 2/5/2022 | Jan–Mär 2022 |
| 2/28/2022 | Jan–Mär 2022 |
| 3/16/2022 | Jan–Mär 2022 |
| 4/1/2022 | Apr–Jun 2022 |
| 5/7/2022 | Apr–Jun 2022 |
| 5/16/2022 | Apr–Jun 2022 |
| 6/15/2022 | Apr–Jun 2022 |
| 6/26/2022 | Apr–Jun 2022 |
| 7/9/2022 | Jul–Sep 2022 |
| 7/22/2022 | Jul–Sep 2022 |
| 7/23/2022 | Jul–Sep 2022 |
| 7/27/2022 | Jul–Sep 2022 |
| 8/2/2022 | Jul–Sep 2022 |
| 8/8/2022 | Jul–Sep 2022 |
| 8/19/2022 | Jul–Sep 2022 |
| 9/26/2022 | Jul–Sep 2022 |
| 10/14/2022 | Okt–Dez 2022 |
| 10/29/2022 | Okt–Dez 2022 |

Die Kennzahl transaction\_quarter wird im Diagrammobjekt erstellt, indem die Funktion quartername() verwendet und das Feld date als Argument der Funktion übergeben wird.

Die Funktion quartername() identifiziert zunächst das Quartal, in das der Datumswert fällt. Dann gibt sie einen Wert zurück, der die Start- und Endmonate dieses Quartals sowie das Jahr zeigt.

Diagramm der Funktion quartername(), Diagrammobjektbeispiel

Diagramm der Funktion quartername(), Diagrammobjektbeispiel

Diagramm der Funktion quartername()quartername(), Diagrammobjektbeispiel ![Das Diagramm zeigt, wie die Funktion „quartername“ den Bereich der Monate des Quartals bestimmt, in dem eine Transaktion stattfindet.](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-chart-object.png)

Transaktion 8203 fand am 8. August 2022 statt. Die Funktion quartername() identifiziert, dass die Transaktion im dritten Quartal stattfand, und gibt daher Jul-Sep 2022 zurück. Die Monate werden im Format der Systemvariablen MonthNames angezeigt.

## Beispiel 5 – Szenario

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

#### Ladeskript und Diagrammformel

Ü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 für 2022 enthält und der in eine Tabelle namens Transactions geladen wird.

* Das Datumsfeld wurde im Format der Systemvariablen DateFormat (MM/TT/JJJJ) bereitgestellt.

Der Endbenutzer möchte ein Diagrammobjekt, das den Gesamtumsatz nach Quartal für die Transaktionen darstellt. Dies ist selbst dann möglich, wenn diese Dimension nicht im Datenmodell verfügbar ist. In diesem Fall wird die Funktion quartername() als berechnete Dimension im Diagramm verwendet.

Ladeskript

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

Transactions:
Load
*
Inline
[
id,date,amount
8188,'1/7/2022',17.17
8189,'1/19/2022',37.23
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
];
```

Ergebnisse

Gehen Sie folgendermaßen vor:

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

2. Erstellen Sie eine berechnete Dimension anhand der folgenden Formel:

   =quartername(date)

3. Berechnen Sie dann den Gesamtumsatz anhand der folgenden Aggregierungskennzahl:

   =sum(amount)

4. Legen Sie das Zahlenformat der Kennzahl auf Währung fest.

Ergebnistabelle

| =quartername(date) | =sum(amount) |
| --- | --- |
| Jul–Sep 2022 | $446.31 |
| Apr–Jun 2022 | $351.48 |
| Jan–Mär 2022 | $253.89 |
| Okt–Dez 2022 | $163.91 |