Mit den Datums-/Uhrzeitformaten und den Zahlenformaten können Sie festlegen, 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 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 Sie mit der API ein Formatmuster festlegen. Das tatsächliche Rendering des Formats hängt von der locale der Tabelle ab. In dieser Anleitung wird davon ausgegangen, dass locale en_US ist. Sie können die locale einer Tabelle ermitteln, indem Sie SpreadsheetProperties mit einer spreadsheets.get-Anfrage lesen.
Datums- und Uhrzeitwerte
Google Tabellen behandelt wie die meisten anderen Tabellenkalkulationsanwendungen Datums- und Uhrzeitwerte als Dezimalwerte. Auf diese Weise können Sie in Formeln arithmetische Berechnungen durchführen, sodass Sie Tage oder Wochen erhöhen, zwei Datum und Uhrzeiten addieren oder subtrahieren und andere ähnliche Operationen ausführen können.
In Google Tabellen wird eine Form von Epochendatum verwendet, die häufig in Tabellen verwendet wird. Der ganze Zahlenteil des Werts (links vom Dezimalzeichen) zählt die Tage seit dem 30. Dezember 1899. Der Bruchteil (rechts vom Dezimalzeichen) zählt die Zeit als Bruchteil eines Tages. Beispiel: Der 1. Januar 1900 ist mittags 2.5, 2, weil es 2 Tage nach dem 30. Dezember 1899 ist, und 0.5, weil Mittag ein halber Tag ist. Der 1. Februar 1900 um 15:00 Uhr ist 33.625.
Google Tabellen behandelt das Jahr 1900 korrekt als gemeinsames Jahr und nicht als Schaltjahr.
Formatmuster für Datum und Uhrzeit
Ein Datum/Uhrzeit-Formatmuster ist ein String von Token-Teilstrings, die beim Parsen durch die entsprechenden Datum-Uhrzeitelemente (z. B. Monat oder Stunde) ersetzt werden.
Formattokens für Datum und Uhrzeit
In der folgenden Tabelle werden die Token-Teilstrings definiert, die Sie in einem Datum-Uhrzeit-Formatmuster verwenden können. Ein +-Zeichen bedeutet, dass das vorherige Zeichen einmal oder mehrmals vorkommen kann und trotzdem mit dem Muster übereinstimmen kann. Zeichen, die nicht in der folgenden Tabelle aufgeführt sind, werden als Literale behandelt und ohne Änderungen ausgegeben.
| Token | Beschreibung |
|---|---|
h |
Tageszeit. Wechselt zwischen 12- und 24-Stunden-Format, je nachdem, ob im String ein AM- oder PM-Indikator vorhanden ist. |
hh+ |
Wie Vorherige, aber mit einer vorangestellten 0 für 1–9. |
m |
Wenn das vorherige, nicht literale Token Stunden war oder das nachfolgende Token Sekunden ist, stellt es die Minuten in der Stunde (ohne vorangestellte 0) dar. Andernfalls wird der Monat des Jahres als Zahl (ohne vorangestellte 0) dargestellt. |
M |
Der Monat des Jahres ohne vorangestellte 0. Verwenden Sie dieses Token, um in Ihrem Muster ausdrücklich einen Monat statt einer Minute anzugeben. |
mm |
Wie m, aber mit einer führenden 0 in beiden Fällen. |
MM |
Der Monat des Jahres mit einer führenden 0. Verwenden Sie dieses Token, um in Ihrem Muster ausdrücklich einen Monat statt einer Minute anzugeben. |
mmm |
Monatsabkürzung aus drei Buchstaben (z. B. „Feb“). |
mmmm |
Vollständiger Monatsname. mmmmmm+ stimmt auch mit diesem überein. |
mmmmm |
Erster Buchstabe des Monats, z. B. „J“ für Juni. |
s |
Sekunden in der Minute ohne vorangestellte 0. |
ss |
Sekunden in der Minute mit einer führenden 0. |
[h+] |
Die Anzahl der verstrichenen Stunden in einer Zeitdauer. Die Anzahl der Buchstaben gibt die Mindestanzahl von Ziffern an (vorangestellte Nullen werden addiert). |
[m+] |
Anzahl der verstrichenen Minuten in einer Zeitdauer. Die Anzahl der Buchstaben gibt die Mindestanzahl von Ziffern an (vorangestellte Nullen werden addiert). |
[s+] |
Die Anzahl der verstrichenen Sekunden in einer Zeitdauer. Die Anzahl der Buchstaben gibt die Mindestanzahl von Ziffern an (vorangestellte Nullen werden addiert). |
d |
Tag des Monats, ohne vorangestellte 0 für Zahlen unter 10. |
dd |
Tag des Monats mit einer vorangestellten 0 für Zahlen unter 10. |
ddd |
Wochentag, dreistellige Abkürzung (z. B. „Mo“). |
dddd+ |
Wochentag, vollständiger Name |
y |
Jahr (2-stellig). |
yy |
|
yyy |
Jahr (4-stellig). |
yyyy+ |
|
a/p |
Es wird „a“ für AM und „p“ für PM angezeigt. Außerdem werden die Öffnungszeiten auf das 12-Stunden-Format geändert. Wenn der Tokenbuchstabe großgeschrieben wird, wird die Ausgabe ebenfalls großgeschrieben. |
am/pm |
Wie oben, nur dass stattdessen "AM" oder "PM" angezeigt wird und immer großgeschrieben wird. |
0 |
Zehn Sekunden 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 nicht mit einer speziellen Bedeutung. |
"text" |
Zeigt den Text innerhalb der Anführungszeichen als Literal an. |
Beispiele für Datums- und Uhrzeitformate
In Anbetracht des Datums und der Uhrzeit Tuesday, April 5, 2016, 4:08:53.528 PM zeigt 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 |
4: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., 05. Apr. |
dddd, m/d/yy at h:mm |
Dienstag, 05.04.2016, 16:08 |
| Verstrichene Zeitmuster | 3 hours, 13 minutes, 41.255 seconds |
[hh]:[mm]:[ss].000 |
03:13:41.255 |
[mmmm]:[ss].000 |
0193:41,255 |
Zahlenformatmuster
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 verschiedenen 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 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. Die anderen verhalten sich so, als gäbe es einen Abschnitt weniger. Durch Einbinden eines endgültigen Textformats können daher Formate wie die folgenden definiert werden:
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
Das Parsen eines Formats in Abschnitte erfolgt vor einem anderen Parsen. Daher kann ein Datums- oder Zeitformat in einem der Abschnitte enthalten sein. Dies ist jedoch von begrenztem Nutzen.
Tokens für das Zahlenformat
In der folgenden Tabelle werden die Token-Teilstrings definiert, die Sie in einem Formatabschnitt verwenden können, um zu definieren, wie die Werte für diesen Abschnitt dargestellt werden sollen.
| Token | Beschreibung |
|---|---|
0 |
Stellt eine Zahl in der Zahl dar. Wenn die Zahl eine unbedeutende 0 ist, wird sie als 0 gerendert. Das Zahlenformat 00.0 rendert beispielsweise die Zahl 3 als „03.0“. |
# |
Stellt eine Zahl in der Zahl dar. Wenn die Zahl eine unbedeutende Null ist, wird sie nicht gerendert. Das Zahlenformat ##0 rendert beispielsweise die Zahl 12 als „12“. |
? |
Stellt eine Zahl in der Zahl dar. Wenn die Zahl eine unbedeutende Null ist, wird sie als Leerzeichen gerendert. Dies wird häufig verwendet, um das Dezimaltrennzeichen in einer Spalte auszurichten, wenn Schriftarten mit fester Breite verwendet werden. Das Zahlenformat ???.??? rendert beispielsweise die Zahl 12, 4 so: „ 12.4“. |
. |
Der erste Punkt stellt das Dezimaltrennzeichen in der Zahl dar. Nachfolgende Zeiträume werden als Literale gerendert. Wenn Sie ein Dezimaltrennzeichen in das Format verwenden, wird es immer gerendert, auch bei ganzen Zahlen. Zum Beispiel rendert #0.# die Zahl 3 als „3.“. |
% |
Wird als Literal angezeigt, führt aber auch dazu, dass vorhandene Zahlen mit 100 multipliziert werden, bevor sie gerendert werden, um Prozentsätze besser lesbar zu machen. Zum Beispiel wird durch das Zahlenformat #% die Zahl 0, 25 als „25%“ gerendert. |
, |
Wenn sie zwischen zweistelligen Zeichen steht (0, # oder ?), wird die gesamte Zahl mit Gruppierungstrennzeichen (Gruppierung nach Tausenden) gerendert. Wenn sie auf die Ziffernzeichen folgt, werden die Ziffern pro Komma um eintausend skaliert. Beispiel: Das Format #0.0,, rendert die Zahl 12.200.000 als 12.2. |
E- |
Gibt die Zahl im wissenschaftlichen Format wieder, wobei die Formatierung links von der E für den Nicht-Exponententeil und die Formatierung rechts neben dem E für den Exponententeil verwendet wird. E+ zeigt ein +-Zeichen für positive Exponenten. E- zeigt nur ein Vorzeichen für negative Exponenten. In diesem Fall erfolgt der Ausgabe-e ebenfalls in Kleinbuchstaben.
Das Zahlenformat ##0.00#E+## rendert beispielsweise die Zahl 0, 0000001 als „100.00E-9“. |
E+ |
|
e- |
|
e+ |
|
/ |
Wenn sie zwischen zweistelligen Zeichen steht (0, # oder ?), werden diese Zifferngruppen als Bruchformat behandelt. Das Zahlenformat 0 #/# rendert beispielsweise die Zahl 23, 25 als 23 1/4. Der Nenner kann auch eine literale Ganzzahl sein, die in diesem Fall als Nenner erzwungen wird. 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, da 0,1 auf 0/3 gerundet wird. / ist nicht mit einem wissenschaftlichen Format oder einem Format mit Dezimalzeichen kompatibel. |
* |
Aus Kompatibilitätsgründen mit Zahlenformaten in Microsoft Excel sind diese bereits enthalten. Es wird derzeit ignoriert. |
_ |
Das Unterstrich-Token überspringt das nächste Zeichen und rendert ein Leerzeichen. Damit lassen sich Zahlenformate ausrichten, bei denen der negative Wert von Klammern umgeben ist. |
\ |
Behandelt das nächste Zeichen als Literalwert und nicht mit einer speziellen Bedeutung. Das Zahlenformat \#0 rendert beispielsweise die Zahl 10 als „#10“. |
"text" |
Zeigt den Text innerhalb der Anführungszeichen als Literal an. |
@ |
Wenn die Zelle Text enthält, wird der Rohtext in die Zelle eingefügt. Es ist mit keinem der anderen Sonderzeichen kompatibel und wird nicht für numerische Werte angezeigt, die im allgemeinen Format angezeigt werden. |
$ - + ( ) : space |
In Google Tabellen werden diese Zeichen als Literale behandelt und unverändert angezeigt. |
Meta-Anleitung
Außerdem kann jeder Formatabschnitt optionale Meta-Anweisungen in []-Zeichen enthalten, die dem Format vorangestellt sind und zusätzliche Anweisungen enthalten. Es gibt zwei Meta-Anweisungstypen und ein bestimmter Abschnitt kann beide verwenden:
| Anleitung | Beschreibung |
|---|---|
[condition] |
Ersetzt den positiven, negativen oder Null-Standardvergleich des Abschnitts durch einen anderen bedingten Ausdruck. [<100]”Low”;[>1000]”High”;000 rendert beispielsweise 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 alles dazwischen. Bedingungen können nur auf die ersten beiden Unterformate angewendet werden. Wenn eine Zahl mit mehreren Unterformaten übereinstimmt, wird das erste Unterformat verwendet, mit dem sie übereinstimmt. Ist ein drittes Format vorhanden, wird es für „Alles andere“ verwendet. Wenn eine Zahl mit keinem der Formate übereinstimmt, wird sie als „#“ gerendert, die die Zellenbreite einnehmen. Wenn es vorhanden ist, wird immer das vierte Format für Text verwendet. |
[Color] or [Color#] |
Sorgt dafür, dass jeder Wert, den dieses Subformat rendert, mit der angegebenen Textfarbe angezeigt wird. 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 – Diese Farbpalette enthält eine Liste der Farben, die der jeweiligen Zahl entsprechen. Farben für Zahlenformate überschreiben alle vom Nutzer eingegebenen Farben in der Zelle. Farben, die durch die bedingte Formatierung festgelegt wurden, werden jedoch nicht überschrieben. |
Beispiele für Zahlenformate
Die folgende Tabelle enthält einige Beispielmuster und das entsprechende Rendering formatierter 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 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 |