Formaty daty, czasu i liczb pozwalają określić sposób wyświetlania danych w arkuszu. Masz do wyboru kilka popularnych formatów, ale możesz też zdefiniować własne formaty.
W interfejsie Arkuszy formaty liczb i dat stosuje się do komórek za pomocą menu Format > Liczba. W interfejsie Sheets API te formaty ustawiasz za pomocą wywołania metody spreadsheets.batchUpdate, aby wysłać element UpdateCellsRequest lub RepeatCellRequest.
Ta strona zawiera informacje o tym, jak definiować nowe wzorce formatu dat i liczb, które możesz uwzględnić w żądaniu do interfejsu API. Przykład Ustawianie niestandardowego formatu daty i godziny lub dziesiętnego dla zakresu pokazuje, jak ustawić wzór formatu za pomocą interfejsu API. Pamiętaj, że rzeczywiste renderowanie formatu zależy od locale arkusza kalkulacyjnego. W tym przewodniku przyjęto założenie, że locale to en_US. Aby określić locale arkusza kalkulacyjnego, odczytaj SpreadsheetProperties za pomocą żądania spreadsheets.get.
Wartości daty i godziny
Podobnie jak większość innych aplikacji do arkuszy kalkulacyjnych, Sheets traktuje wartości daty i godziny jako wartości dziesiętne. Dzięki temu możesz wykonywać w formułach operacje arytmetyczne, np. zwiększać liczbę dni lub tygodni, dodawać lub odejmować 2 daty i czasy oraz wykonywać inne podobne operacje.
Arkusze używają formy daty epoki, która jest powszechnie stosowana w arkuszach kalkulacyjnych. Część całkowita wartości (po lewej stronie kropki dziesiętnej) liczy dni od 30 grudnia 1899 r. Ułamek (po prawej stronie przecinka) oznacza czas jako ułamek 1 dnia. Na przykład 1 stycznia 1900 r. o godzinie 12:00 to 2.5, 2, ponieważ to 2 dni po 30 grudnia 1899 r., i 0.5, ponieważ południe to pół dnia. 1 lutego 1900 r., godz. 15:00
to 33.625.
Arkusze prawidłowo traktują rok 1900 jako rok przestępny, a nie zwykły.
Wzorce formatów daty i godziny
Wzór formatu daty i godziny to ciąg podciągów znaków, które po przeanalizowaniu są zastępowane odpowiednimi elementami daty i godziny (np. miesiącem lub godziną).
Elementy formatu daty i godziny
W tabeli poniżej określono podciągi znaków tokenów, których można używać w wzorze formatu daty i godziny. Znak + wskazuje, że poprzedni znak może wystąpić co najmniej raz i nadal pasować do wzorca. Znaki, których nie ma w tabeli poniżej, są traktowane jako znaki dosłowne i wyprowadzane bez zmian.
| Token | Opis |
|---|---|
h |
Godzina. Przełącza się między formatem 12- i 24-godzinnym w zależności od tego, czy w ciągu występuje wskaźnik AM czy PM. |
hh+ |
To samo co poprzednio, ale z zerem na początku w przypadku wartości 1–9. |
m |
Jeśli poprzedni nieliterowy element był hours lub następny to seconds, oznacza to minuty w godzinie (bez zera na początku). W przeciwnym razie oznacza miesiąc w roku jako liczbę (bez zera na początku). |
M |
Miesiąc w roku bez zera na początku. Użyj tego elementu, aby w wzorze wyraźnie określić miesiąc zamiast minuty. |
mm |
To samo co m, ale z cyfrą 0 na początku w obu przypadkach. |
MM |
Miesiąc jako liczba z zerem na początku. Użyj tego elementu, aby w wzorze wyraźnie określić miesiąc zamiast minuty. |
mmm |
Trzyliterowy skrót miesiąca (np. „luty”). |
mmmm |
Pełna nazwa miesiąca. mmmmmm+ również pasuje do tego. |
mmmmm |
Pierwsza litera miesiąca (np. „C” dla czerwca). |
s |
sekundy w minucie bez wiodącego 0. |
ss |
sekundy w minucie z dodatkowym zerem na początku. |
[h+] |
Liczba godzin w okresie czasu. Liczba liter wskazuje minimalną liczbę cyfr (dodaje zera na początku). |
[m+] |
Liczba minut, które upłynęły w okresie czasu. Liczba liter wskazuje minimalną liczbę cyfr (dodaje zera na początku). |
[s+] |
Liczba sekund, które upłynęły w okresie czasu. Liczba liter wskazuje minimalną liczbę cyfr (dodaje zera na początku). |
d |
Dzień miesiąca bez zera na początku w przypadku liczb mniejszych niż 10. |
dd |
Dzień miesiąca z zerem na początku w przypadku liczb mniejszych niż 10. |
ddd |
Dzień tygodnia, 3-literowy skrót (np. „Pn”). |
dddd+ |
Dzień tygodnia, imię i nazwisko. |
y |
2-cyfrowy rok. |
yy |
|
yyy |
Czterocyfrowy rok. |
yyyy+ |
|
a/p |
Wyświetla „a” dla AM i „p” dla PM. Zmień godziny na format 12-godzinny. Jeśli litera tokenu jest wielką literą, dane wyjściowe również będą. |
am/pm |
Podobnie jak powyżej, ale zamiast tego wyświetla „AM” lub „PM” i zawsze jest pisana wielkimi literami. |
0 |
Dziesiątki sekund. Możesz zwiększyć dokładność do 2 cyfr za pomocą funkcji 00 lub do 3 cyfr (milisekund) za pomocą funkcji 000. |
\ |
Traktuje następny znak jako wartość dosłowną, a nie jako znak specjalny. |
"text" |
Wyświetla tekst zawarty w cudzysłowie jako wartość dosłowną. |
Przykłady formatów daty i godziny
W tabeli poniżej znajdziesz przykładowe wzorce zapisu daty i czasu Tuesday, April 5, 2016, 4:08:53.528 PM oraz odpowiadające im sposoby wyświetlania daty i czasu. Druga sekcja tabeli zawiera przykłady formatów czasu upływu dla wartości 3 hours, 13 minutes, 41.255 seconds:
| Wzorce daty i godziny | 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 kwietnia [wtorek] |
h PM, ddd mmm dd |
Środa, 5 kwietnia, godz. 16:00 |
dddd, m/d/yy at h:mm |
Wtorek, 5 kwietnia 2016 r., 16:08 |
| Wzorce upłynięcia czasu | 3 hours, 13 minutes, 41.255 seconds |
[hh]:[mm]:[ss].000 |
03:13:41.255 |
[mmmm]:[ss].000 |
0193:41.255 |
Wzorce formatu liczb
Wzór formatu liczby to ciąg podciągów znaków tokenów, które po przeanalizowaniu są zastępowane odpowiednimi reprezentacjami liczb. Wzór formatu liczby może składać się z maksymalnie 4 sekcji rozdzielonych średnikami, które definiują oddzielne formaty używane dla liczb dodatnich, liczb ujemnych, zera i tekstu (w tej kolejności):
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
Nie musisz uwzględniać wszystkich 4 sekcji w danym formacie. Jeśli uwzględnisz tylko jedną sekcję, ten format zostanie zastosowany do wszystkich wartości. Użycie 2 sekcji powoduje, że pierwszy format jest stosowany do zera i liczb dodatnich, a drugi – do liczb ujemnych. Użycie 3 sekcji definiuje oddzielne formaty dla liczb dodatnich, ujemnych i zerowych. Na przykład:
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]
Jeśli jednak jest co najmniej 2 sekcje, a ostatnia z nich ma format tekstowy, jest ona traktowana jako format tekstowy, a pozostałe sekcje zachowują się tak, jakby było ich o jedną mniej. Dzięki temu można zdefiniować formaty takie jak:
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
Analizowanie formatu na sekcje następuje przed innymi analizami, więc można uwzględnić format daty lub czasu jako jedną z sekcji (chociaż ma to ograniczone zastosowanie).
Tokeny formatu liczb
Tabela poniżej definiuje podciągi znaków tokenów, których możesz używać w sekcji formatu, aby określić sposób przedstawiania wartości w tej sekcji.
| Token | Opis |
|---|---|
0 |
Reprezentuje cyfrę w liczbie. Jeśli cyfra jest nieuwzględniana, jest renderowana jako 0. Na przykład format liczby
00.0 wyświetla liczbę 3 jako „03.0”. |
# |
Reprezentuje cyfrę w liczbie. Jeśli cyfra jest nieistotna (0), nie jest renderowana. Na przykład format liczby ##0
wyświetla liczbę 12 jako „12”. |
? |
Reprezentuje cyfrę w liczbie. Jeśli cyfra jest nieuwzględnianą 0, jest renderowana jako spacja. Jest to często używane do wyrównywania przecinka dziesiętnego w kolumnie przy użyciu czcionek o stałyej szerokości. Na przykład format liczby
???.??? wyświetla liczbę 12, 4 jako:
" 12.4 ". |
. |
Pierwsza kropka oznacza przecinek dziesiętny w liczbie. Kolejne przecinki są renderowane jako ciągi znaków. Jeśli w formatowaniu uwzględnisz przecinek dziesiętny, będzie on zawsze wyświetlany, nawet w przypadku liczb całkowitych. Na przykład:
#0.# renderuje liczbę 3 jako „3.”. |
% |
Wyświetla się jako wartość dosłowna, ale przed wyświetleniem mnoży istniejące liczby przez 100, aby ułatwić odczytywanie wartości procentowych. Na przykład format liczby #%
wyświetla liczbę 0, 25 jako „25%”. |
, |
Jeśli znak pojawia się między dwucyfrowymi znakami (0,
# lub ?), cały numer jest renderowany z separatorami grup (grupowanie co tysiąc). Jeśli występuje po cyfrach, skaluje cyfry o 1000 na każdą przecinkę (np. format #0.0,, renderuje liczbę 12 200 000 jako 12.2). |
E- |
Wyświetla liczbę w formacie wykładniczym, przy czym formatowanie po lewej stronie znaku E jest używane do części bez wykładnika, a formatowanie po prawej stronie znaku E – do części z wykładnikiem. E+ pokazuje znak + w przypadku dodatnich wykładniczych. E- wyświetla tylko znak dla wykładniczych ujemnych. Jeśli użyjesz małych liter, wynik e będzie również w małej literze.
Na przykład format liczby ##0.00#E+##
wyświetla liczbę 0, 0000001 jako „100.00E-9”. |
E+ |
|
e- |
|
e+ |
|
/ |
Jeśli pojawia się między dwucyfrowymi znakami (0, # lub ?), traktowane są one jako ułamek. Na przykład format liczby 0 #/# wyświetla liczbę 23, 25 jako 23 1/4. Mianownik może też być liczbą całkowitą, w którym przypadku jest ona używana jako mianownik. Format liczby 0 #/8 wyświetla liczbę 23,25 jako 23 2/8. Część ułamkowa nie jest renderowana, jeśli licznik jest równy 0. Liczba
23.1 w formacie liczby 0 #/3 jest wyświetlana jako
23 (ponieważ 0,1 jest zaokrąglane do 0/3). / jest niezgodny z formatem wykładniczym lub formatem z przecinkiem. |
* |
Jest to uwzględniane ze względu na zgodność z formatami liczb w programie Microsoft Excel. Jest ona obecnie ignorowana. |
_ |
Podkreślnik pomija następny znak i renderuje spację. Służy on do dopasowywania formatów liczb, w których wartość ujemna jest otoczona nawiasami. |
\ |
Traktuje kolejny znak jako wartość dosłowną, a nie jako znak specjalny. Na przykład format liczby \#0
wyświetla liczbę 10 jako „#10”. |
"text" |
Wyświetla tekst zawarty w cudzysłowie jako wartość dosłowną. |
@ |
Jeśli komórka zawiera tekst, zostanie wstawiony surowy tekst. Nie jest zgodny z żadnymi innymi znakami specjalnymi i nie jest wyświetlany w przypadku wartości liczbowych (które są wyświetlane w formacie ogólnym). |
$ - + ( ) : space |
Arkusze traktują te znaki jako znaki dosłowne i wyświetlają je bez zmian. |
Instrukcje dotyczące metadanych
Dodatkowo każda sekcja formatu może zawierać opcjonalne instrukcje meta, ujęte w znaki [], które poprzedzają format i zawierają dodatkowe instrukcje. Istnieją 2 typy metainstrukcji, z których dana sekcja może korzystać:
| Instrukcja | Opis |
|---|---|
[condition] |
Zastępuje domyślne porównanie dodatnie, ujemne lub zerowe w sekcji przez inne wyrażenie warunkowe. Na przykład:
[<100]”Low”;[>1000]”High”;000 renderuje słowo
„Niski” w przypadku wartości poniżej 100, „Wysoki” w przypadku wartości powyżej 1000, a w przypadku wartości pośrednich – trzycyfrową
liczbę (z cyframi 0 na początku). Warunki można stosować tylko do 2 pierwszych formatów podrzędnych. Jeśli numer pasuje do więcej niż jednego formatu, zostanie użyty pierwszy pasujący format. Jeśli istnieje trzeci format, jest on używany do „wszystkiego innego”. W przeciwnym razie, jeśli liczba nie pasuje do żadnego z formatów, jest renderowana jako ciąg znaków „#”, wypełniając szerokość komórki. Jeśli istnieje, czwarty format jest zawsze używany do tekstu. |
[Color] or [Color#] |
Sprawia, że każda wartość renderowana przez ten format podrzędny jest wyświetlana w danym kolorze tekstu. Prawidłowe wartości parametru Color to czarny, niebieski, cyjan, zielony, magenta, czerwony, biały lub żółty. Prawidłowe wartości dla „#” w Color# to 1–56 (ta paletka kolorów pokazuje listę kolorów odpowiadających poszczególnym liczbom). Kolory formatu liczby zastępują wszystkie kolory wprowadzone przez użytkownika w komórce, ale nie zastępują kolorów ustawionych przez formatowanie warunkowe. |
Przykłady formatów liczb
W tabeli poniżej znajdziesz przykładowe wzorce i odpowiadające im formaty liczb:
| Liczba | Wzór | Wartość sformatowana |
|---|---|---|
| 12345.125 | ####.# |
12345.1 |
| 12,34 | 000.0000 |
012.3400 |
| 12 | #.0# |
12.0 |
| 5.125 | # ???/??? |
5 1/8 |
| 12000 | #,### |
12 000 |
| 1230000 | 0.0,,"M" |
1,2 mln |
| 1234500000 | 0.00e+00 |
1,23e+09 |
| 123114.15115 MyText |
###0.000;"TEXT: "_(@_) |
123114.151 TEKST: MyText |
| 1234 -1234 0 MyText |
[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) |
1234 1234 0.0 MyText |
| 1005 32 527 |
[>1000]"HIGH";[Color43][<=200]"LOW";0000 |
HIGH LOW 0527 |