Datums- und Zahlenformate

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

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

Auf dieser Seite wird beschrieben, wie Sie neue Datums- und Zahlenformatmuster definieren, die Sie in Ihre API-Anfrage aufnehmen können. Im Beispiel Benutzerdefiniertes Datums- oder Dezimalformat für einen Bereich festlegen wird gezeigt, wie mit der API ein Formatmuster festgelegt wird. Das tatsächliche Rendering des Formats hängt vom locale der Tabelle ab. In dieser Anleitung wird davon ausgegangen, dass locale en_US ist. Sie können den locale einer Tabelle ermitteln, indem Sie den SpreadsheetProperties mit einer spreadsheets.get-Anfrage lesen.

Datums- und Uhrzeitwerte

Wie die meisten anderen Tabellenkalkulationsanwendungen behandelt Google Tabellen Datums- und Uhrzeitwerte als Dezimalwerte. Auf diese Weise können Sie arithmetische Operationen in Formeln ausführen, um Tage oder Wochen zu erhöhen, zwei Datums- und Uhrzeitangaben addieren oder subtrahieren sowie andere ähnliche Operationen durchzuführen.

In Google Tabellen wird ein Epochendatum verwendet, das häufig in Tabellen verwendet wird. Der ganze Zahlenteil des Werts (links von der Dezimalstelle) zählt die Tage seit dem 30. Dezember 1899. Der Bruchteil (rechts vom Dezimaltrennzeichen) zählt die Zeit als Bruchteil eines Tages. Beispiel: Der 1. Januar 1900 um 12:00 Uhr ist 2.5, 2, weil es 2 Tage nach dem 30. Dezember 1899 sind, und 0.5, weil Mittag ein halber Tag ist. Am 1. Februar 1900 um 15:00 Uhr findet 33.625.

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

Formatmuster für Datum und Uhrzeit

Ein Datum/Uhrzeit-Formatmuster ist ein String von Token-Teilstrings, die beim Parsen durch die entsprechenden Datum-Uhrzeit-Elemente wie Monat oder Stunde ersetzt werden.

Tokens für das Datums- und Uhrzeitformat

In der folgenden Tabelle werden die Token-Teilstrings definiert, die Sie in einem Datum-Uhrzeit-Formatmuster verwenden können. Das Zeichen + gibt an, dass das vorherige Zeichen einmal oder mehrmals vorkommen kann und dennoch mit dem Muster übereinstimmen kann. Zeichen, die in der nachfolgenden Tabelle nicht aufgeführt sind, werden als Literale behandelt und unverändert ausgegeben.

Token	Beschreibung
h	Tageszeit. Schaltet zwischen dem 12- und 24-Stunden-Format um, je nachdem, ob der String eine AM- oder PM-Anzeige enthält.
hh+	Wie zuvor, nur mit einer führenden 0 für 1–9.
m	Wenn das vorherige nicht-Literal-Token Stunden war oder das nachfolgende Token Sekunden war, stellt es Minuten in der Stunde dar (ohne vorangestellte 0). Andernfalls wird der Monat des Jahres als Zahl ohne vorangestellte Null dargestellt.
M	Der Monat des Jahres ohne führende 0. Verwenden Sie dieses Token, um in Ihrem Muster ausdrücklich einen Monat anstelle einer Minute anzugeben.
mm	Wie m, aber in beiden Fällen mit einer führenden 0.
MM	Der Monat des Jahres mit einer führenden 0. Verwenden Sie dieses Token, um in Ihrem Muster ausdrücklich einen Monat anstelle einer Minute anzugeben.
mmm	Abkürzung für den Monat aus drei Buchstaben (z. B. "Feb").
mmmm	Vollständiger Monatsname. mmmmmm+ stimmt auch hiermit überein.
mmmmm	Erster Buchstabe des Monats (z. B. „J“ für Juni).
s	Sekunden der Minuten ohne vorangestellte 0.
ss	Sekunden der Minuten mit einer führenden 0.
[h+]	Anzahl der verstrichenen Stunden in einer Zeitdauer. Die Anzahl der Buchstaben gibt die Mindestanzahl von Ziffern an (addiert Nullen).
[m+]	Anzahl der verstrichenen Minuten in einer Zeitdauer. Die Anzahl der Buchstaben gibt die Mindestanzahl von Ziffern an (addiert Nullen).
[s+]	Anzahl der verstrichenen Sekunden in einer Zeitdauer. Die Anzahl der Buchstaben gibt die Mindestanzahl von Ziffern an (addiert Nullen).
d	Tag des Monats ohne führende 0 für Zahlen unter 10
dd	Tag des Monats mit einer führenden 0 für Zahlen unter 10.
ddd	Wochentag, dreistellige Abkürzung (z. B. „Mo“).
dddd+	Wochentag, vollständiger Name
y	Jahr (zweistellig)
yy
yyy	Jahr (4-stellig).
yyyy+
a/p	Hier wird „a“ für AM und „p“ für PM angezeigt. Ändert außerdem das 12-Stunden-Format. Wenn der Tokenbuchstabe großgeschrieben ist, wird die Ausgabe ebenfalls großgeschrieben.
am/pm	Wie oben, zeigt jedoch stattdessen „AM“ oder „PM“ an und ist immer großgeschrieben.
0	Zehntelsekunden. Sie können die Genauigkeit mit 00 auf zwei Ziffern oder mit 000 auf drei Ziffern (Millisekunden) erhöhen.
\	Behandelt das nächste Zeichen als Literalwert und ohne besondere Bedeutung.
"text"	Zeigt den zwischen den Anführungszeichen gesetzten Text als Literal an.

Beispiele für Datums- und Uhrzeitformate

Unter Angabe des Datums und der Uhrzeit Tuesday, April 5, 2016, 4:08:53.528 PM enthält die folgende Tabelle einige Beispielmuster und das entsprechende Datum-Uhrzeit-Rendering. Der zweite Abschnitt der Tabelle enthält Beispiele für verstrichene Zeitformate für eine verstrichene Zeit von 3 hours, 13 minutes, 41.255 seconds:

Datum-Uhrzeit-Muster	Tuesday, April 5, 2016, 4:08:53.528 PM
h:mm:ss.00 a/p	16:08:53,53
hh:mm A/P".M."	16:08
yyyy-mm-dd	2016-04-05
mmmm d \[dddd\]	5. April [Dienstag]
h PM, ddd mmm dd	16:00 Uhr, Di., 5. April
dddd, m/d/yy at h:mm	Dienstag, 05.04.2016, 16:08 Uhr
Verstrichene Zeitmuster	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 ein String von Token-Teilstrings, die beim Parsen durch die entsprechenden Zahlendarstellungen ersetzt werden. Ein Zahlenformatmuster kann aus bis zu vier durch Semikolons getrennten Abschnitten bestehen, die die separaten Formate für positive Zahlen, negative Zahlen, Null und Text (in dieser Reihenfolge) definieren:

[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 auf negative Zahlen angewendet. In drei Abschnitten werden separate Formate für positive, negative und Nullzahlen definiert. 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 weniger. Durch Einbeziehen eines endgültigen Textformats ist es daher möglich, Formate wie die folgenden zu definieren:

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

Das Parsen eines Formats in Abschnitte erfolgt vor anderen Parsing-Fehlern. Daher ist es möglich, ein Datums- oder Uhrzeitformat als einen der Abschnitte zu verwenden (obwohl dies von begrenztem Nutzen ist).

Tokens für das Zahlenformat

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

Token	Beschreibung
0	Stellt eine Ziffer in der Zahl dar. Wenn die Ziffer eine unbedeutende 0 ist, wird sie als 0 gerendert. Zum Beispiel wird durch das Zahlenformat 00.0 die Zahl 3 als „03.0“ gerendert.
#	Stellt eine Ziffer in der Zahl dar. Ist die Ziffer eine unwesentliche 0, wird sie nicht gerendert. Beispielsweise wird durch das Zahlenformat ##0 die Zahl 12 als „12“ gerendert.
?	Stellt eine Ziffer in der Zahl dar. Wenn die Ziffer eine unbedeutende 0 ist, wird sie als Leerzeichen gerendert. Dies wird häufig verwendet, um das Dezimalkomma in einer Spalte auszurichten, wenn Schriftarten mit fester Breite verwendet werden. Das Zahlenformat ???.??? rendert die Zahl 12.4 beispielsweise so: " 12.4 ".
.	Der erste Punkt stellt das Dezimalzeichen in der Zahl dar. Nachfolgende Zeiträume werden als Literale wiedergegeben. Wenn du ein Dezimalzeichen in das Format einfügst, wird es immer gerendert, auch wenn ganze Zahlen. Zum Beispiel rendert #0.# die Zahl 3 als „3.“.
%	Wird als Literal angezeigt, führt jedoch auch dazu, dass vorhandene Zahlen vor dem Rendern mit 100 multipliziert werden, damit Prozentsätze besser lesbar sind. Beispielsweise wird durch das Zahlenformat #% die Zahl 0, 25 als „25%“ gerendert.
,	Erscheint er zwischen zweistelligen Zeichen (0, # oder ?), wird die gesamte Zahl mit Gruppierungstrennzeichen (Gruppierung nach Tausenden) gerendert. Wenn sie auf die Ziffern folgt, werden die Ziffern um eintausend pro Komma skaliert (z. B. gibt das Format #0.0,, die Zahl 12.200.000 als 12.2 aus).
E-	Gibt die Zahl im wissenschaftlichen Format an. Dabei wird die Formatierung links von der E für den Nicht-Exponententeil und die rechts vom E für den Exponententeil verwendet. E+ zeigt ein +-Zeichen für positive Exponenten. E- zeigt nur ein Vorzeichen für negative Exponenten. Wird kleingeschrieben, wird auch die Ausgabe-e kleingeschrieben. Beispielsweise wird durch das Zahlenformat ##0.00#E+## die Zahl 0, 0000001 als „100.00E-9“ gerendert.
E+
e-
e+
/	Wenn er zwischen zweistelligen Zeichen (0, # oder ?) steht, werden diese Zifferngruppen als Bruchformat behandelt. Beispielsweise wird durch das Zahlenformat 0 #/# die Zahl 23, 25 als 23 1/4 gerendert. Der Nenner kann auch eine literale Ganzzahl sein. In diesem Fall wird diese Ganzzahl als Nenner erzwungen. Im Zahlenformat 0 #/8 wird die Zahl 23,25 als 23 2/8 angezeigt. Der Bruchteil wird nicht gerendert, wenn der Zähler 0 wird. Die Zahl 23.1 mit dem Zahlenformat 0 #/3 wird nur als 23 gerendert, weil „0,1“ auf 0/3 gerundet wird. / ist nicht mit einem wissenschaftlichen Format oder einem Format mit Dezimalzeichen kompatibel.
*	Dies ist aus Gründen der Kompatibilität mit Zahlenformaten von Microsoft Excel enthalten. Er wird derzeit ignoriert.
_	Das Unterstrich-Token überspringt das nächste Zeichen und rendert ein Leerzeichen. Dies wird verwendet, um Zahlenformate auszurichten, bei denen der negative Wert von Klammern umgeben ist.
\	Behandelt das nächste Zeichen als Literalwert und ohne besondere Bedeutung. Beispielsweise wird durch das Zahlenformat \#0 die Zahl 10 als „#10“ gerendert.
"text"	Zeigt den zwischen den Anführungszeichen gesetzten Text als Literal an.
@	Wenn in die Zelle Text eingegeben wurde, wird der Rohtext in die Zelle eingefügt. Nicht kompatibel mit den anderen Sonderzeichen und wird nicht für numerische Werte (die im allgemeinen Format angezeigt werden) angezeigt.
$ - + ( ) : space	Diese Zeichen werden in Google Tabellen als Literale behandelt und unverändert angezeigt.

Meta-Anweisungen

Darüber hinaus kann jeder der Formatabschnitte optionale Metaanweisungen enthalten, die in []-Zeichen vor dem Format stehen und zusätzliche Anweisungen enthalten. Es gibt zwei Metaanweisungstypen und ein bestimmter Abschnitt kann beide verwenden:

Anleitung	Beschreibung
[condition]	Ersetzt den standardmäßigen positiven, negativen oder Nullvergleich des Abschnitts durch einen anderen bedingten Ausdruck. Zum Beispiel gibt [<100]”Low”;[>1000]”High”;000 bei Werten unter 100 das Wort „Niedrig“, bei Werten über 1000 „Hoch“ und bei Werten dazwischen eine dreistellige Zahl (mit vorangestellten Nullen) aus. Bedingungen können nur auf die ersten beiden Unterformate angewendet werden. Wenn eine Zahl mit mehr als einem Unterformat übereinstimmt, wird das erste verwendet, mit dem sie übereinstimmt. Gibt es ein drittes Format, wird es für „Alles andere“ verwendet. Wenn eine Zahl mit keinem der Formate übereinstimmt, wird sie so gerendert, dass das gesamte „#“-Zeichen die Zellenbreite einnimmt. Falls vorhanden, wird immer das vierte Format für Text verwendet.
[Color] or [Color#]	Sämtliche Werte, die durch dieses Unterformat gerendert werden, werden mit der angegebenen Textfarbe angezeigt. Gültige Werte für Color sind Schwarz, Blau, Cyan, Grün, Magenta, Rot, Weiß oder Gelb. Gültige Werte für „#“ in Color# sind 0&ndash1;56 (diese Farbpalette enthält eine Liste der Farben, die den einzelnen Zahlen entsprechen). Farben für das Zahlenformat überschreiben alle vom Nutzer in der Zelle eingegebenen Farben. Farben, die durch die bedingte Formatierung festgelegt wurden, werden nicht überschrieben.

Beispiele für Zahlenformate

Die folgende Tabelle enthält einige Beispielmuster und das entsprechende formatierte Zahlenrendering:

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 Mein Text	###0.000;"TEXT: "_(@_)	123114.151 TEXT: MeinText
1234 –1234 0 MeinText	[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_)	1.234 1.234 0,0 MyText
1.005 32 527	[>1000]"HIGH";[Color43][<=200]"LOW";0000	HOCH NIEDRIG 0527