Datums- und Zahlenformate

Mit Datums-/Uhrzeit- und Zahlenformaten legen Sie fest, wie Ihre Daten in einem Tabellenblatt dargestellt werden. In Google Tabellen stehen einige gängige Formate zur Auswahl, Sie können aber auch eigene Formate definieren.

In der Google Sheets-Benutzeroberfläche wenden Sie Zahlen- und Datumsformate auf Zellen an, indem Sie das Menü Format > Zahl verwenden. In der Sheets API legen Sie diese Formate mit einem spreadsheets.batchUpdate-Methodenaufruf fest, um eine UpdateCellsRequest oder RepeatCellRequest zu senden.

Auf dieser Seite wird beschrieben, wie Sie neue Muster für Datums- und Zahlenformate definieren, die Sie in Ihre API-Anfrage aufnehmen können. Im Beispiel Benutzerdefiniertes Datums-/Uhrzeit- oder Dezimalformat für einen Bereich festlegen wird gezeigt, wie Sie ein Formatmuster mit der API festlegen. Die tatsächliche Darstellung des Formats hängt von der locale der Tabelle ab. In diesem Leitfaden wird davon ausgegangen, dass locale en_US ist. Sie können die locale einer Tabelle ermitteln, indem Sie die SpreadsheetProperties mit einer spreadsheets.get-Anfrage lesen.

Datums- und Uhrzeitwerte

Wie die meisten anderen Tabellenkalkulationsanwendungen behandelt Google Tabellen Datums- und Zeitwerte als Dezimalwerte. So können Sie in Formeln arithmetische Operationen damit ausführen, z. B. Tage oder Wochen erhöhen, zwei Datums- und Zeitangaben addieren oder subtrahieren und andere ähnliche Operationen ausführen.

In Google Sheets wird eine Form des Epochendatums verwendet, die in Tabellenkalkulationen üblich ist. Der ganzzahlige Teil des Werts (links vom Dezimalkomma) gibt die Anzahl der Tage seit dem 30. Dezember 1899 an. Der Bruchteil (rechts vom Dezimalkomma) gibt die Zeit als Bruchteil eines Tages an. Beispiel: Der 1. Januar 1900 um 12:00 Uhr ist 2.5, 2, da er 2 Tage nach dem 30. Dezember 1899 liegt, und 0.5, da 12:00 Uhr ein halber Tag ist. Der 1. Februar 1900 um 15:00 Uhr ist 33.625.

In Google Tabellen wird das Jahr 1900 korrekt als normales Jahr und nicht als Schaltjahr behandelt.

Muster für Datums- und Uhrzeitformate

Ein Datums-/Uhrzeit-Formatmuster ist ein String aus Token-Teilstrings, die beim Parsen durch die entsprechenden Datums-/Uhrzeit-Elemente (z. B. Monat oder Stunde) ersetzt werden.

Tokens für Datums- und Uhrzeitformat

In der folgenden Tabelle werden die Token-Teilstrings definiert, die Sie in einem Datums-/Uhrzeitformatmuster verwenden können. Das Zeichen + gibt an, dass das vorherige Zeichen ein- oder mehrmals vorkommen kann und trotzdem mit dem Muster übereinstimmt. Zeichen, die nicht in der Tabelle unten aufgeführt sind, werden als Literale behandelt und unverändert ausgegeben.

Token Beschreibung
h Tageszeit. Wechselt zwischen dem 12- und 24-Stunden-Format, je nachdem, ob im String ein AM- oder PM-Indikator vorhanden ist.
hh+ Wie oben, aber mit einer führenden 0 für 1–9.
m Wenn das vorherige nicht-literale Token „hours“ (Stunden) war oder das nachfolgende „seconds“ (Sekunden) ist, steht es für Minuten in der Stunde (ohne führende 0). Andernfalls wird der Monat des Jahres als Zahl (ohne führende 0) dargestellt.
M Der Monat des Jahres ohne führende Null. Mit diesem Token können Sie in Ihrem Muster ausdrücklich einen Monat anstelle einer Minute angeben.
mm Wie m, aber in beiden Fällen mit einer führenden 0.
MM Der Monat des Jahres mit einer führenden 0. Mit diesem Token können Sie in Ihrem Muster ausdrücklich einen Monat anstelle einer Minute angeben.
mmm Abkürzung des Monats aus drei Buchstaben (z. B. „Feb“).
mmmm Vollständiger Monatsname. mmmmmm+ entspricht ebenfalls diesem Muster.
mmmmm Erster Buchstabe des Monats (z. B. „J“ für Juni).
s Sekunden der Minute ohne führende 0.
ss Sekunden in der Minute mit einer führenden 0.
[h+] Anzahl der verstrichenen Stunden in einem Zeitraum. „Number of letters“ (Anzahl der Buchstaben) gibt die Mindestanzahl der Ziffern an (fügt führende Nullen hinzu).
[m+] Anzahl der verstrichenen Minuten in einem Zeitraum. „Number of letters“ (Anzahl der Buchstaben) gibt die Mindestanzahl der Ziffern an (fügt führende Nullen hinzu).
[s+] Anzahl der verstrichenen Sekunden in einem Zeitraum. „Number of letters“ (Anzahl der Buchstaben) gibt die Mindestanzahl der Ziffern an (fügt führende Nullen hinzu).
d Der Tag des Monats ohne führende Null für Zahlen unter 10.
dd Der Tag des Monats mit einer führenden 0 für Zahlen unter 10.
ddd Wochentag, Abkürzung aus drei Buchstaben (z. B. „Mon“).
dddd+ Wochentag, vollständiger Name.
y Jahr (2-stellig).
yy
yyy Jahr (4-stellig).
yyyy+
a/p Zeigt „a“ für AM und „p“ für PM an. Außerdem wird das 12-Stunden-Format für die Stunden verwendet. Wenn der Tokenbuchstabe großgeschrieben ist, wird auch die Ausgabe großgeschrieben.
am/pm Wie oben, aber es wird stattdessen „AM“ oder „PM“ angezeigt und die Abkürzung ist immer großgeschrieben.
0 Zehntelsekunden. Sie können die Genauigkeit mit 00 auf zwei Stellen oder mit 000 auf drei Stellen (Millisekunden) erhöhen.
\ Behandelt das nächste Zeichen als Literalwert und nicht als Sonderzeichen.
"text" Zeigt den Text in Anführungszeichen als Literal an.

Beispiele für Datums- und Uhrzeitformate

Die folgende Tabelle enthält einige Beispielmuster und die entsprechende Darstellung von Datum und Uhrzeit für das Datum und die Uhrzeit Tuesday, April 5, 2016, 4:08:53.528 PM. Im zweiten Abschnitt der Tabelle sehen Sie Beispiele für Formate für die verstrichene Zeit für eine verstrichene Zeit von 3 hours, 13 minutes, 41.255 seconds:

Muster für Datum/Uhrzeit Tuesday, April 5, 2016, 4:08:53.528 PM
h:mm:ss.00 a/p 4:08:53.53 p
hh:mm A/P".M." 16:08 Uhr
yyyy-mm-dd 2016-04-05
mmmm d \[dddd\] 5. April [Dienstag]
h PM, ddd mmm dd 16:00 Uhr, Di., 05.04.
dddd, m/d/yy at h:mm Dienstag, 05.04.2016 um 16:08 Uhr
Muster für die verstrichene Zeit 3 hours, 13 minutes, 41.255 seconds
[hh]:[mm]:[ss].000 03:13:41.255
[mmmm]:[ss].000 0193:41.255

Muster für Zahlenformate

Ein Zahlenformatmuster ist eine Zeichenfolge mit Token-Teilstrings, die beim Parsen durch die entsprechenden Zahlendarstellungen ersetzt werden. Ein Zahlenformatmuster kann aus bis zu vier Abschnitten bestehen, die durch Semikolons getrennt sind. Sie definieren die separaten Formate, die für positive Zahlen, negative Zahlen, Null und Text verwendet werden (in dieser Reihenfolge):

[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]

Sie müssen nicht alle vier Abschnitte in ein Format aufnehmen. Wenn Sie nur einen Abschnitt einfügen, wird dieses Format für alle Werte verwendet. Wenn Sie zwei Abschnitte verwenden, wird das erste Format auf Null und positive Zahlen und das zweite Format auf negative Zahlen angewendet. Wenn Sie drei Abschnitte verwenden, definieren Sie separate Formate für positive, negative und Nullzahlen. Beispiel:

[NUMBER FORMAT]
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT]
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]

Wenn es jedoch zwei oder mehr Abschnitte gibt und der letzte Abschnitt ein Textformat ist, wird dieser Abschnitt als Textformat behandelt und die anderen verhalten sich so, als gäbe es einen Abschnitt weniger. Durch die Einbeziehung eines finalen Textformats ist es möglich, Formate wie die folgenden zu definieren:

[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT]
[NUMBER FORMAT];[TEXT FORMAT]

Die Aufteilung eines Formats in Abschnitte erfolgt vor anderen Analysen. Daher kann ein Datums- oder Zeitformat als einer der Abschnitte enthalten sein (obwohl dies nur begrenzt nützlich ist).

Tokens für Zahlenformat

In der folgenden Tabelle sind die Token-Teilstrings definiert, die Sie in einem Formatabschnitt verwenden können, um festzulegen, wie die Werte für diesen Abschnitt dargestellt werden sollen.

Token Beschreibung
0 Stellt eine Ziffer in der Zahl dar. Wenn die Ziffer eine unbedeutende 0 ist, wird sie als 0 gerendert. Mit dem Zahlenformat 00.0 wird die Zahl 3 beispielsweise als „03.0“ gerendert.
# Stellt eine Ziffer in der Zahl dar. Wenn die Ziffer eine unbedeutende 0 ist, wird sie nicht gerendert. Mit dem Zahlenformat ##0 wird die Zahl 12 beispielsweise als „12“ gerendert.
? Stellt eine Ziffer in der Zahl dar. Wenn die Ziffer eine unbedeutende 0 ist, wird sie als Leerzeichen gerendert. Wird häufig verwendet, um den Dezimalpunkt in einer Spalte auszurichten, wenn Schriftarten mit fester Breite verwendet werden. Mit dem Zahlenformat ???.??? wird die Zahl 12, 4 beispielsweise so gerendert: „ 12.4 “.
. Der erste Punkt stellt das Dezimalkomma in der Zahl dar. Nachfolgende Punkte werden als Literale gerendert. Wenn Sie ein Dezimalzeichen in das Format einfügen, wird es immer gerendert, auch bei ganzen Zahlen. Beispiel: #0.# gibt die Zahl 3 als „3.“ aus.
% Wird als Literal angezeigt, bewirkt aber auch, dass vorhandene Zahlen mit 100 multipliziert werden, bevor sie gerendert werden, damit Prozentsätze besser lesbar sind. Mit dem Zahlenformat #% wird die Zahl 0, 25 beispielsweise als „25%“ dargestellt.
, Wenn es zwischen zweistelligen Zeichen (0, # oder ?) steht, wird die gesamte Zahl mit Gruppierungstrennzeichen (Gruppierung nach Tausendern) gerendert. Wenn es auf die Ziffernzeichen folgt, werden die Ziffern pro Komma um Tausend skaliert. Mit dem Format #0.0,, wird die Zahl 12.200.000 beispielsweise als 12.2 dargestellt.
E- Die Zahl wird im wissenschaftlichen Format gerendert. Die Formatierung links von E wird für den Teil ohne Exponent verwendet, die Formatierung rechts von E für den Exponententeil. E+ zeigt ein +-Zeichen für positive Exponenten. E- zeigt nur ein Vorzeichen für negative Exponenten an. Wenn Kleinbuchstaben verwendet werden, ist die Ausgabe e ebenfalls in Kleinbuchstaben. Mit dem Zahlenformat ##0.00#E+## wird die Zahl 0, 0000001 beispielsweise als „100.00E-9“ dargestellt.
E+
e-
e+
/ Wenn es zwischen zweistelligen Zeichen (0, # oder ?) steht, werden diese Zifferngruppen als Bruchformat behandelt. Mit dem Zahlenformat 0 #/# wird die Zahl 23, 25 beispielsweise als 23 1/4 dargestellt. Der Nenner kann auch ein Literal vom Typ „Integer“ sein. In diesem Fall wird diese Ganzzahl als Nenner verwendet. Im Zahlenformat 0 #/8 wird die Zahl 23,25 als 23 2/8 angezeigt. Der Bruch wird nicht gerendert, wenn der Zähler 0 wird. Die Zahl 23,1 wird mit dem Zahlenformat 0 #/3 als 23 gerendert, da 0,1 auf 0/3 gerundet wird. / ist nicht mit dem wissenschaftlichen Format oder einem Format mit einem Dezimalzeichen kompatibel.
* Diese Option ist für die Kompatibilität mit Microsoft Excel-Zahlenformaten enthalten. Er wird derzeit ignoriert.
_ Mit dem Unterstrich-Token wird das nächste Zeichen übersprungen und ein Leerzeichen gerendert. Wird verwendet, um Zahlenformate auszurichten, bei denen der negative Wert in Klammern steht.
\ Behandelt das nächste Zeichen als Literalwert und nicht als Sonderzeichen. Mit dem Zahlenformat \#0 wird die Zahl 10 beispielsweise als „#10“ dargestellt.
"text" Zeigt den Text in Anführungszeichen als Literal an.
@ Wenn die Zelle Texteingaben enthält, wird der Rohtext für die Zelle eingefügt. Nicht mit anderen Sonderzeichen kompatibel und wird nicht für numerische Werte angezeigt (die im allgemeinen Format dargestellt werden).
$ - + ( ) : space In Google Tabellen werden diese Zeichen als Literale behandelt und unverändert angezeigt.

Meta-Anweisungen

Außerdem kann jeder Formatabschnitt optionale Metaanweisungen enthalten, die in []-Zeichen eingeschlossen sind und vor dem Format stehen. Es gibt zwei Arten von Meta-Anweisungen, und in einem bestimmten Abschnitt können beide verwendet werden:

Anleitung Beschreibung
[condition] Ersetzt den standardmäßigen positiven, negativen oder Nullvergleich des Abschnitts durch einen anderen bedingten Ausdruck. Beispiel: Mit [<100]”Low”;[>1000]”High”;000 wird das Wort „Niedrig“ für Werte unter 100, „Hoch“ für Werte über 1.000 und eine dreistellige Zahl (mit führenden Nullen) für alle Werte dazwischen gerendert. Bedingungen können nur auf die ersten beiden Unterformate angewendet werden. Wenn eine Zahl mit mehr als einem übereinstimmt, wird das erste verwendet, mit dem sie übereinstimmt. Wenn es ein drittes Format gibt, wird es für „alles andere“ verwendet. Andernfalls wird eine Zahl, die mit keinem der beiden Formate übereinstimmt, als eine Reihe von „#“-Zeichen dargestellt, die die Zellbreite ausfüllen. Wenn es vorhanden ist, wird das vierte Format immer für Text verwendet.
[Color] or [Color#] Bewirkt, dass jeder Wert, der mit diesem Unterformat gerendert wird, in der angegebenen Textfarbe angezeigt wird. Gültige Werte für Color sind „Black“ (Schwarz), „Blue“ (Blau), „Cyan“ (Cyan), „Green“ (Grün), „Magenta“ (Magenta), „Red“ (Rot), „White“ (Weiß) oder „Yellow“ (Gelb). Gültige Werte für „#“ in Color# sind 1–56. In dieser Farbpalette finden Sie eine Liste der Farben, die den einzelnen Zahlen entsprechen. Mit dem Zahlenformat werden alle vom Nutzer eingegebenen Farben für die Zelle überschrieben, jedoch nicht die Farben, die durch die bedingte Formatierung festgelegt wurden.

Beispiele für Zahlenformate

Die folgende Tabelle enthält einige Beispielmuster und die entsprechende gerenderte formatierte Zahl:

Zahl Muster Formatierter Wert
12345.125 ####.# 12345.1
12,34 000.0000 012.3400
12 #.0# 12.0
5,125 # ???/??? 5 1/8
12.000 #,### 12.000
1230000 0.0,,"M" 1,2 Mio.
1234500000 0.00e+00 1,23e+09
123114.15115
MyText		 ###0.000;"TEXT: "_(@_) 123114.151
TEXT: MyText
1234
-1234
0
MyText		 [Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) 1.234
1.234
0.0
MyText
1005
32
527		 [>1000]"HIGH";[Color43][<=200]"LOW";0000 HOCH
NIEDRIG
0527