# Time Skript- und Diagrammfunktion

Time() formatiert eine Formel als Zeitwert und verwendet dafür, wenn kein Formatcode zur Verfügung steht, das vorgegebene Format aus den Systemvariablen des Datenladeskripts oder des Betriebssystems.

Syntax:

Time(number[, format])

Rückgabe Datentyp: dual

Argumente

| Argument | Beschreibung |
| --- | --- |
| number | Die zu formatierende Zahl. |
| format | String zur Formatierung des resultierenden Zeitstrings. Wenn nicht angegeben, werden das Uhrzeitformat und das Dezimaltrennzeichen wie im Betriebssystem festgelegt verwendet.<br><br>Die Funktion `Time` unterstützt viele Formatoptionen für verschiedene Uhrzeitstrukturen, zum Beispiel:<br><br>`hh:mm:ss`: Formatiert einen Uhrzeitwert in einem Standarduhrzeitformat und zeigt Stunden, Minuten und Sekunden mit vorangestellten Nullen an.<br><br>​`hh:mm TT`:​Verwendet ein 12-Stunden-Format mit dem Suffix AM/PM.<br><br>​`hh:mm`: Zeigt nur Stunden und Minuten an und lässt die Sekunden weg.<br><br>​`hh.mm.ss`:​Uhrzeitformat mit anderen Trennzeichen, z. B. einem Punkt (`.`) anstelle eines Doppelpunkts.<br><br>​`hh TT`​:Beinhaltet nur die Stunde und AM/PM.<br><br>​`hh "Hrs" mm "Mins"`:​Zeigt die Uhrzeit mit einem benutzerdefinierten Text an, z. B. Hrs.<br><br>[Beschreibungen für Zahlen- und Uhrzeitformate](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |

Beispiel: Diagrammformeln

| Beispiel | Ergebnis |
| --- | --- |
| `Time( 0.375 )` | Gibt `09:00:00` zurück, wenn die Einstellung `TimeFormat` `'hh:mm:ss'` ist. |
| `Time( 35648.375 )` | Gibt `09:00:00` zurück, wenn das angegebene `Timeformat` `'hh:mm:ss'` ist. |
| `Time( 0.99999, 'hh-mm' )` | Gibt `23-59` zurück, wobei die Einstellung `TimeFormat` ignoriert wird, da das Format in der Kennzahl bereitgestellt wird. |

## Beispiel – Grundlegendes zu „Time“

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

#### Diagrammformel

Übersicht

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

Das Ladeskript umfasst:

* Datensatz, der in eine Datentabelle namens `Example` geladen wird

* Die folgenden Felder in einer Datentabelle:

  * `TimeValue`

* Die Variable `TimeFormat`, die das Format `hh:mm:ss` verwendet.

Ladeskript

```
SET TimeFormat='hh:mm:ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```

Ergebnisse

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

* ` TimeValue
                                       `

Erstellen Sie die folgenden Kennzahlen:

* `=Time(TimeValue )`, um den Wert als Uhrzeit anzuzeigen, die entsprechend der Systemeinstellung formatiert ist.

* `=Time(TimeValue, 'hh-mm' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh:mm:ss' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh:mm TT' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh:mm' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh.mm.ss' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh TT' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

Ergebnistabelle

| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
| 0.99999 | 23:59:59 | 23-59 | 23:59:59 | 11:59 PM | 23:59 | 23.59.59 | 11 PM | 23 Hrs 59 Mins |
| 35648.375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |

Die Ergebnisse zeigen, wie die Funktion `Time` die Werte basierend auf dem in der Funktionsformel angegebenen Format anzeigen kann.

## Beispiel – Grundlegendes zu „Time“ mit einer anderen TimeFormat-Einstellung

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

#### Diagrammformel

Übersicht

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

Das Ladeskript umfasst:

* Datensatz, der in eine Datentabelle namens `Example` geladen wird

* Die folgenden Felder in einer Datentabelle:

  * `TimeValue`

* Die Variable `TimeFormat`, die das Format `hh.mm.ss` verwendet.

Ladeskript

```
SET TimeFormat='hh.mm.ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```

Ergebnisse

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

* ` TimeValue
                                       `

Erstellen Sie die folgenden Kennzahlen:

* `=Time(TimeValue )`, um den Wert als Uhrzeit anzuzeigen, die entsprechend der Systemeinstellung formatiert ist.

* `=Time(TimeValue, 'hh-mm' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh:mm:ss' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh:mm TT' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh:mm' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh.mm.ss' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh TT' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )`, um den Wert als Uhrzeit anzuzeigen, die mit dem in der Funktion angegebenen Format formatiert ist.

Ergebnistabelle

| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09.00.00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
| 0.99999 | 23.59.59 | 23-59 | 23:59:59 | 11:59 PM | 23:59 | 23.59.59 | 11 PM | 23 Hrs 59 Mins |
| 35648.375 | 09.00.00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |

Die Ergebnisse zeigen, wie die Funktion `Time` die Werte basierend auf dem in der Funktionsformel angegebenen Format anzeigen kann.