Datums- und Zahlenformate

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

In der Google Tabellen-Benutzeroberfläche können Sie Zellen über das Menü Format > Zahl Zahlen- und Datumsformate zuweisen. In der Google Tabellen API legen Sie diese Formate mit einem Methodenaufruf spreadsheets.batchUpdate fest, um 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. Das tatsächliche Rendern 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

In Google Tabellen werden Datums- und Uhrzeitwerte wie in den meisten anderen Tabellenanwendungen als Dezimalwerte behandelt. So können Sie in Formeln arithmetische Operationen darauf ausführen, z. B. Tage oder Wochen hinzufügen oder abziehen, zwei Datumsangaben und Uhrzeiten addieren oder subtrahieren und andere ähnliche Vorgänge ausführen.

In Google Tabellen wird eine Form des Epochendatums verwendet, die in Tabellen häufig verwendet wird. Der Ganzzahlteil des Werts (links vom Dezimalpunkt) gibt die Tage seit dem 30. Dezember 1899 an. Der Bruchteil (rechts vom Dezimalpunkt) gibt die Zeit als Bruchteil eines Tages an. Beispiel: Der 1. Januar 1900 um 12 Uhr entspricht 2.5, 2, da es zwei Tage nach dem 30. Dezember 1899 ist, und 0.5, da 12 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 Datum/Uhrzeit-Formatmuster ist ein String aus Token-Substrings, die beim Parsen durch die entsprechenden Datum/Uhrzeit-Elemente (z. B. den Monat oder die Stunde) ersetzt werden.

Tokens für Datums- und Uhrzeitformate

In der folgenden Tabelle werden die Token-Substrings definiert, die Sie in einem Muster für das Datums-/Uhrzeitformat verwenden können. Ein +-Zeichen gibt an, dass das vorherige Zeichen einmal oder mehrmals vorkommen kann und trotzdem mit dem Muster übereinstimmt. Zeichen, die in der folgenden Tabelle nicht aufgeführt sind, werden als Literale behandelt und ohne Änderungen ausgegeben.

Token	Beschreibung
h	Tageszeit. Hier wird zwischen dem 12- und dem 24-Stunden-Format gewechselt, je nachdem, ob im String ein AM- oder PM-Indikator vorhanden ist.
hh+	Wie oben, aber mit einer führenden Null für die Ziffern 1–9.
m	Wenn das vorherige nicht-literale Token „Stunden“ war oder das nachfolgende „Sekunden“, steht es für Minuten in der Stunde (ohne vorangestellte Null). Andernfalls steht er für den Monat des Jahres als Zahl (ohne führende Null).
M	Der Monat des Jahres ohne führende Null. 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 Null.
MM	Der Monat des Jahres mit einer führenden Null. Verwenden Sie dieses Token, um in Ihrem Muster ausdrücklich einen Monat anstelle einer Minute anzugeben.
mmm	Eine aus drei Buchstaben bestehende monatliche Abkürzung (z. B. „Feb“).
mmmm	Der vollständige Monatsname. mmmmmm+ entspricht auch diesem Muster.
mmmmm	Erster Buchstabe des Monats (z. B. „J“ für Juni).
s	Sekunden der Minute ohne führende Null.
ss	Sekunden der Minute mit einer vorangestellten Null.
[h+]	Die Anzahl der verstrichenen Stunden in einem bestimmten Zeitraum. Die Anzahl der Buchstaben gibt die Mindestanzahl der Ziffern an (Vorangestellte Nullen werden hinzugefügt).
[m+]	Die Anzahl der verstrichenen Minuten in einem bestimmten Zeitraum. Die Anzahl der Buchstaben gibt die Mindestanzahl der Ziffern an (Vorangestellte Nullen werden hinzugefügt).
[s+]	Die Anzahl der vergangenen Sekunden in einem bestimmten Zeitraum. Die Anzahl der Buchstaben gibt die Mindestanzahl der Ziffern an (Vorangestellte Nullen werden hinzugefügt).
d	Der Tag des Monats, ohne führende Null für Zahlen unter 10.
dd	Der Tag des Monats, bei Zahlen unter 10 mit einer führenden Null.
ddd	Wochentag, dreistellige Abkürzung (z. B. „Mon“).
dddd+	Wochentag, vollständiger Name.
y	Zweistellige Jahreszahl.
yy
yyy	Jahr (4-stellig).
yyyy+
a/p	„a“ für „AM“ (Vormittag) und „p“ für „PM“ (Nachmittag) Außerdem wird das Stundenformat in das 12-Stunden-Format geändert. Wenn der Tokenbuchstabe großgeschrieben ist, wird auch die Ausgabe großgeschrieben.
am/pm	Wie oben, aber stattdessen wird „AM“ oder „PM“ angezeigt und die Uhrzeit ist immer großgeschrieben.
0	Zehntel von Sekunden. Mit 00 können Sie die Genauigkeit auf zwei Ziffern erhöhen, mit 000 auf drei Ziffern (Millisekunden).
\	Das nächste Zeichen wird als Literalwert behandelt und nicht als Sonderzeichen.
"text"	Der Text innerhalb der Anführungszeichen wird als Literal angezeigt.

Beispiele für Datums- und Uhrzeitformate

Die folgende Tabelle enthält einige Beispielmuster und die entsprechende Datums- und Uhrzeitdarstellung für das Datum und die Uhrzeit Tuesday, April 5, 2016, 4:08:53.528 PM. Der zweite Abschnitt der Tabelle enthält Beispiele für Formate für die vergangene Zeit für eine vergangene 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 Uhr
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. April
dddd, m/d/yy at h:mm	Dienstag, 05.04.2016 um 16:08
Muster für 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 Muster für das Zahlenformat ist eine Zeichenfolge aus Token-Substrings, die beim Parsen durch die entsprechenden Zahlendarstellungen ersetzt werden. Ein Muster für das Zahlenformat kann aus bis zu vier Abschnitten bestehen, die durch Semikolons getrennt sind und 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 einem Format angeben. Wenn Sie nur einen Abschnitt angeben, 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. Mit 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 Abschnitte verhalten sich so, als gäbe es einen Abschnitt weniger. Wenn Sie also ein endgültiges Textformat angeben, können Sie Formate wie die folgenden definieren:

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

Das Parsen eines Formats in Abschnitte erfolgt vor dem Parsen anderer Formate. Daher ist es möglich, dass ein Datums- oder Zeitformat in einem der Abschnitte enthalten ist. Dies ist jedoch nur bedingt sinnvoll.

Tokens für das Zahlenformat

In der folgenden Tabelle sind die Token-Substrings definiert, mit denen Sie in einem Formatabschnitt festlegen können, wie die Werte für diesen Abschnitt dargestellt werden.

Token	Beschreibung
0	Stellt eine Ziffer in der Zahl dar. Wenn die Ziffer eine unerhebliche Null ist, wird sie als „0“ dargestellt. Mit dem Zahlenformat 00.0 wird die Zahl 3 beispielsweise als „03.0“ dargestellt.
#	Stellt eine Ziffer in der Zahl dar. Wenn die Ziffer eine unerhebliche Null ist, wird sie nicht gerendert. Mit dem Zahlenformat ##0 wird beispielsweise die Zahl 12 als „12“ dargestellt.
?	Stellt eine Ziffer in der Zahl dar. Wenn die Ziffer eine unerhebliche Null ist, wird sie als Leerzeichen dargestellt. Diese Option 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 dargestellt: 12.4.
.	Der erste Punkt steht für den Dezimalpunkt in der Zahl. Nachfolgende Zeiträume werden als Literale gerendert. Wenn Sie im Format einen Dezimalpunkt angeben, wird er immer gerendert, auch bei ganzen Zahlen. Beispiel: Mit #0.# wird die Zahl 3 als „3.“ dargestellt.
%	Wird als Literal angezeigt, bewirkt aber auch, dass vorhandene Zahlen vor der Darstellung mit 100 multipliziert werden, um Prozentsätze besser lesbar zu machen. Mit dem Zahlenformat #% wird beispielsweise die Zahl 0, 25 als „25%“ dargestellt.
,	Wenn es zwischen zweistelligen Ziffern (0, # oder ?) erscheint, wird die gesamte Zahl mit Gruppierungstrennzeichen (Gruppierung nach Tausendern) dargestellt. Wenn das Komma auf die Ziffern folgt, werden die Ziffern um 1.000 pro Komma skaliert. Im Format #0.0,, wird die Zahl 12.200.000 beispielsweise als 12.2 dargestellt.
E-	Die Zahl wird im wissenschaftlichen Format gerendert. Dabei wird die Formatierung links von E für den nicht exponentiellen Teil und die Formatierung rechts von E für den exponentiellen Teil verwendet. In E+ wird für positive Exponenten ein +-Zeichen angezeigt. Bei E- wird nur ein Vorzeichen für negative Exponenten angezeigt. Wenn Kleinbuchstaben verwendet werden, wird auch die Ausgabe e in Kleinbuchstaben geschrieben. Mit dem Zahlenformat ##0.00#E+## wird beispielsweise die Zahl 0, 0000001 als „100.00E-9“ dargestellt.
E+
e-
e+
/	Wenn er zwischen zweistelligen Ziffern (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 eine 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 Nenner 0 wird. Die Zahl 23.1 wird mit dem Zahlenformat 0 #/3 nur als 23 dargestellt, da 0,1 auf 0/3 gerundet wird. / ist nicht mit dem wissenschaftlichen Format oder einem Format mit Dezimalpunkt kompatibel.
*	Dies dient der Kompatibilität mit den Zahlenformaten von Microsoft Excel. Sie wird derzeit ignoriert.
_	Das Unterstrich-Token überspringt das nächste Zeichen und fügt ein Leerzeichen ein. Damit werden Zahlenformate ausgerichtet, bei denen der negative Wert in Klammern steht.
\	Das nächste Zeichen wird als Literalwert behandelt und nicht als Sonderzeichen. Mit dem Zahlenformat \#0 wird beispielsweise die Zahl 10 als „#10“ dargestellt.
"text"	Der Text innerhalb der Anführungszeichen wird als Literal angezeigt.
@	Wenn in der Zelle Text eingegeben wurde, wird der Rohtext in die Zelle eingefügt. Dieses Zeichen ist mit keinem anderen Sonderzeichen kompatibel und wird nicht für numerische Werte angezeigt (diese werden im allgemeinen Format angezeigt).
$ - + ( ) : space	In Google Tabellen werden diese Zeichen als Literale behandelt und unverändert angezeigt.

Meta-Anleitung

Außerdem können die einzelnen Formatabschnitte optionale Metaanweisungen enthalten, die in []-Zeichen eingeschlossen sind und vor dem Format stehen. Sie enthalten zusätzliche Anweisungen. Es gibt zwei Arten von Metaanweisungen und ein bestimmter Abschnitt kann beide verwenden:

Anleitung	Beschreibung
[condition]	Ersetzt den standardmäßigen Vergleich „positiv“, „negativ“ oder „null“ des Abschnitts durch einen anderen bedingten Ausdruck. Mit [<100]”Low”;[>1000]”High”;000 wird beispielsweise „Niedrig“ für Werte unter 100, „Hoch“ für Werte über 1.000 und eine dreistellige Zahl (mit führenden Nullen) für Werte dazwischen dargestellt. Bedingungen können nur auf die ersten beiden Unterformate angewendet werden. Wenn eine Zahl mit mehreren übereinstimmt, wird das erste davon verwendet. Wenn es ein drittes Format gibt, wird es für „Sonstiges“ verwendet. Wenn eine Zahl keinem der Formate entspricht, wird sie als „#“ gerendert, wobei die gesamte Zellenbreite ausgefüllt wird. Ist das der Fall, wird das vierte Format immer für Text verwendet.
[Color] or [Color#]	Dadurch wird jeder Wert, der mit diesem Unterformat gerendert wird, in der angegebenen Textfarbe angezeigt. Gültige Werte für Color sind „Black“, „Blue“, „Cyan“, „Green“, „Magenta“, „Red“, „White“ oder „Yellow“. Gültige Werte für das „#“ in Color# sind 1–56. In dieser Farbpalette sind die Farben aufgeführt, die den einzelnen Zahlen entsprechen. Die Farben des Zahlenformats überschreiben alle vom Nutzer eingegebenen Farben in der Zelle, aber nicht die Farben, die durch die bedingte Formatierung festgelegt wurden.

Beispiele für Zahlenformate

Die folgende Tabelle enthält einige Beispielmuster und die entsprechende Formatierung von Zahlen:

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 MeinText	###0.000;"TEXT: "_(@_)	123114.151 TEXT: MyText
1234 -1234 0 MeinText	[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