Formaty daty i liczb

Formaty daty i godziny oraz liczby pozwalają kontrolować sposób wyświetlania danych w arkuszu. W Arkuszach Google możesz wybierać spośród popularnych formatów, ale możesz też definiują własne formaty.

W interfejsie Arkuszy do komórek możesz zastosować formaty liczb i dat za pomocą funkcji Format > Menu Liczba. W interfejsie Arkuszy API możesz ustawić te formaty za pomocą spreadsheets.batchUpdate wywołanie metody do wysłania UpdateCellsRequest lub RepeatCellRequest.

Na tej stronie opisano definiowanie nowych wzorców formatów daty i liczb, które można uwzględnić w żądaniu do interfejsu API. Przykład Ustawianie niestandardowego formatu daty i godziny lub formatu dziesiętnego dla zakresu pokazuje, jak ustawić wzorzec formatu za pomocą interfejsu API. Pamiętaj, że podczas renderowania formatu zależy od locale arkusza kalkulacyjnego. W tym przewodniku przyjęto założenie, Obecny stan „locale”: en_US. Wartość locale w arkuszu kalkulacyjnym można określić, czytając SpreadsheetProperties. z spreadsheets.get użytkownika.

Informacje o dacie i wartości czasu

Arkusze, podobnie jak większość innych aplikacji do obsługi arkuszy kalkulacyjnych, traktują wartości daty i godziny jako wartości dziesiętne. Dzięki temu można przeprowadzać na nich działania arytmetyczne w formułach, zwiększaj liczbę dni lub tygodni, dodaj lub odejmij dwie daty i godziny oraz wykonaj inne w podobny sposób.

Arkusze używają formatu data epoki które są często wykorzystywane w arkuszach kalkulacyjnych. Część wartości będąca liczbą całkowitą (po lewej od cyfry dziesiętnej) zlicza dni od 30 grudnia 1899 r. Ułamek (po prawej stronie liczby dziesiętnej) zlicza czas jako ułamek jednego dnia. Dla: na przykład 1 stycznia 1900 r. w południe to 2.5, 2, bo są 2 dni później 30 grudnia 1899 roku i 0.5, bo południe to pół dnia. 1 lutego 1900 roku o 15:00 jest 33.625.

Arkusze poprawnie traktują rok 1900 jako wspólny, a nie przestępny.

Data i wzorce formatu czasu

Wzorzec formatu daty i godziny to ciąg podłańcuchów tokenów, które podczas analizy są zastąpione odpowiednimi elementami daty i godziny (takimi jak miesiąc lub godz.).

Data i tokeny formatu godziny

Poniższa tabela definiuje podłańcuchy tokenów, których możesz używać w polach daty i godziny format. Znak + oznacza, że poprzedni znak może się pojawić co najmniej raz i będą pasować do wzorca. Znaki niewymienione w tabeli poniżej są traktowane jak literały i w danych wyjściowych nie wpływają.

Token Opis
h Pora dnia. Przełącza między formatem 12-godzinnym a 24-godzinnym w zależności od czy w ciągu znaków występuje wskaźnik AM czy PM.
hh+ Tak samo jak poprzednio, ale z początkowym 0 dla 1–9.
m Jeśli poprzedni token niedosłowny trwał kilka godzin, a kolejny to s oznacza minuty w godzinie (bez zera na początku). W przeciwnym razie reprezentuje miesiąc w roku w postaci liczby (bez zera na początku).
M Miesiąc roku bez zera na początku. Za pomocą tego tokena możesz we wzorcu wyraźnie określić miesiąc, a nie minutę.
mm Tak samo jak m, ale w obu przypadkach z 0 na początku.
MM Miesiąc roku z początkowym 0. Za pomocą tego tokena możesz we wzorcu wyraźnie określić miesiąc, a nie minutę.
mmm 3-literowy skrót oznaczający miesiąc (np. „lut”).
mmmm Pełna nazwa miesiąca. mmmmmm+ również pasuje do tej wartości.
mmmmm Pierwsza litera nazwy miesiąca (na przykład „J” dla czerwca).
s Sekundy w minucie bez zera na początku.
ss Liczba sekund w minucie z 0 na początku.
[h+] Liczba godzin, które upłynęły w określonym czasie. Liczba liter wskazuje minimalną liczbę cyfr (dodaje zera na początku).
[m+] Liczba minut, które upłynęły w określonym czasie. Liczba liter wskazuje minimalną liczbę cyfr (dodaje zera na początku).
[s+] Liczba sekund, które upłynęły w określonym czasie. Liczba liter wskazuje minimalną liczbę cyfr (dodaje zera na początku).
d Dzień miesiąca, bez zera na początku dla liczb mniejszych niż 10.
dd Dzień miesiąca z wartością na początku 0 w przypadku liczb mniejszych niż 10.
ddd Dzień tygodnia, trzyliterowy skrót (np. „pon”).
dddd+ Dzień tygodnia, pełna nazwa.
y Rok w formacie 2-cyfrowym.
yy
yyy Rok w formacie 4-cyfrowym.
yyyy+
a/p Wyświetla „a” dla AM i „p” na popołudnie. Zmienia też godziny otwarcia na Format 12-godzinny. Jeśli litera tokena jest pisana wielką literą, wynik będzie taki: .
am/pm Tak jak wyżej, ale wyświetla „AM” lub „PM” i zawsze jest pisane wielkimi literami.
0 Część dziesiętna sekundy. Możesz zwiększyć precyzję do dwóch cyfr za pomocą funkcji 00 lub 3 cyfry (w milisekundach) z 000.
\ Traktuje następny znak jako wartość literałową, a nie jako wartość specjalną co może mieć.
"text" Wyświetla tekst znajdujący się w cudzysłowie jako literał.

Data i przykłady formatów godziny

W przypadku daty i godziny Tuesday, April 5, 2016, 4:08:53.528 PM, poniższa tabela zawiera kilka przykładowych wzorców wraz z odpowiadającymi im datami i godzinami jak renderowanie. Druga sekcja tabeli zawiera przykłady upływu czasu formaty dla czasu, który upłynął 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 16: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 16:00, wt 5 kwi
dddd, m/d/yy at h:mm Wtorek, 5.04.16 o 16:08
Wzorce czasu upływu 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

Wzorzec formatu liczb to ciąg podłańcuchów tokenów, które po analizie są z odpowiednimi liczbami. Wzór formatu liczb może się składać z maksymalnie czterech sekcji rozdzielonych średnikami, które definiują osobne formaty dla liczb dodatnich, ujemnych, 0 i tekstowych (w w tej kolejności):

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

Nie musisz przesyłać wszystkich 4 sekcji w formacie. Jeśli użyjesz tylko jednej opcji ten format jest używany dla wszystkich wartości. Jeśli użyjesz dwóch sekcji, pierwsza z nich który ma zostać zastosowany do zera i liczb dodatnich, a drugi format do liczby ujemne. Stosując 3 sekcje, definiujemy osobne formaty dla wartości dodatnich, ujemnych i zerowych. Na przykład:

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

Jeśli jednak są co najmniej dwie sekcje i ostatnia sekcja zawiera tekst , ta sekcja jest traktowana jako format tekstowy, a pozostałe działają tak, jakby jest o jedna mniej. Dlatego podanie ostatecznego formatu tekstowego pozwala aby zdefiniować formaty, takie jak:

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

Analiza formatu na sekcje ma miejsce przed innymi analizami, więc jest to można użyć formatu daty lub godziny jako jednej z tych sekcji (chociaż ma ograniczone zastosowanie).

Tokeny formatu liczb

Tabela poniżej zawiera podłańcuchy tokenów, których możesz używać w sekcji formatu aby zdefiniować sposób odzwierciedlenia wartości danej sekcji.

Token Opis
0 Reprezentuje cyfrę w liczbie. Jeśli cyfra jest nieistotnym 0, jest on renderowany jako 0. Na przykład format liczb 00.0 renderuje liczbę 3 jako „03.0”.
# Reprezentuje cyfrę w liczbie. Jeśli cyfra jest nieistotnym 0, nie zostanie wyrenderowana. Na przykład format liczb ##0 renderuje liczbę 12 jako „12”.
? Reprezentuje cyfrę w liczbie. Jeśli cyfra jest nieistotnym 0, i wyświetlany jako spacja. Jest to często używane do wyrównywania przecinka dziesiętnego w kolumny przy korzystaniu z czcionek o stałej szerokości. Na przykład format liczb ???.??? renderuje liczbę 12.4 jako: ” 12.4”.
. Pierwsza kropka reprezentuje separator dziesiętny w liczbie. Kolejna okresy są renderowane w postaci literałów. Jeśli dodasz separator dziesiętny w , jest zawsze renderowany, nawet w przypadku liczb całkowitych. Przykład: #0.# renderuje liczbę 3 jako „3.”.
% Przedstawia się jako literał, ale powoduje też mnożenie istniejących liczb o 100 przed wyrenderowaniem, aby zwiększyć odsetek czytelna. Na przykład format liczb #% renderuje liczbę 0,25 jako „25%”.
, Jeśli występuje między znakami 2-cyfrowymi (0, # lub ?), renderuje całą liczbę z separatorami grup (pogrupowanymi do tysięcy). Jeśli jest cyfr, skaluje cyfry o tysiąc na przecinek (na przykład w formacie #0.0,, renderowana jest liczba 12 200 000 jako 12.2).
E- Renderuje liczbę w formacie naukowym, przy czym sformatuj po lewej stronie wartości E używanej dla funkcji bez wykładnika i formatowanie po prawej stronie litery E używane dla wykładnika części składowej. E+ pokazuje znak + jako dodatni wykładniki. E- pokazuje tylko znak ujemnych wykładników. Jeśli małe litery, wynik e również jest zapisany małymi literami. Na przykład format liczb ##0.00#E+## renderuje liczbę 0,0000001 jako „100.00E-9”.
E+
e-
e+
/ Jeśli występuje między znakami 2-cyfrowymi (0, # lub ?), traktuje te grupy cyfr jako w formacie ułamkowym. Na przykład w formacie liczbowym renderuje się 0 #/# liczbę 23,25 jako 23 1/4. Mianownik może być też dosłowną liczbą całkowitą, w którym to przypadku wymusza ją jako czyli mianownika. Format liczb 0 #/8 wyświetli liczbę 23,25 jako 23 2/8. Część ułamkowa nie jest różna od zostanie wyrenderowany, jeśli licznik zmieni wartość na 0. Numer 23.1 z formatem liczb 0 #/3 renderuje się tak samo 23 (ponieważ 0,1 jest zaokrąglane do 0/3). / to niezgodne z formatem naukowym lub formatem z separatorem dziesiętnym w nim zawarte.
* Ta wartość jest uwzględniana w celu zapewnienia zgodności z formatami liczb w programie Microsoft Excel. Jest on obecnie ignorowany.
_ Token podkreślenia pomija kolejny znak i powoduje wyrenderowanie spacji. Jest używane do dopasowywania w formacie liczbowym, w którym wartość ujemna jest umieszczona w nawiasie.
\ Traktuje następny znak jako wartość literałową, a nie jako wartość specjalną co może mieć. Na przykład format liczb \#0 renderuje liczbę 10 jako „#10”.
"text" Wyświetla tekst znajdujący się w cudzysłowie jako literał.
@ Jeśli komórka zawiera pole tekstowe, wstawia nieprzetworzony tekst. Nie jest zgodny z pozostałymi znakami specjalnymi i nie wyświetla się wartości liczbowe (w formacie ogólnym).
$ - + ( ) : space Arkusze traktuje te znaki jak literały i wyświetla je bez zmian.

Metainstrukcje

Dodatkowo każda sekcja dotycząca formatu może zawierać opcjonalne metainstrukcje, ujęte w [] znaków, które poprzedza format i zapewniają instrukcje. Istnieją dwa typy metainstrukcji: mogą zawierać obie te wartości:

Instrukcja Opis
[condition] Zastępuje domyślne porównanie wartości dodatniej, ujemnej lub zero dla funkcji z innym wyrażeniem warunkowym. Przykład: [<100]”Low”;[>1000]”High”;000 renderuje słowo „Niska” dla wartości poniżej 100, „Wysoka” dla wartości powyżej 1000 i 3 cyfry (z początkowym zerem) dla dowolnego elementu pośredniego. Warunki mogą być zostanie zastosowana do pierwszych dwóch podformatów, a jeśli liczba będzie odpowiadać więcej niż jednemu, użyto pierwszego pasującego hasła. Jeśli istnieje trzeci format, służy do określenia „wszystkie pozostałe”, w przeciwnym razie, jeśli liczba nie pasuje do żadnego formatu, renderuje się, gdy wszystkie znaki „#” wypełniają szerokość komórki. Jeśli istnieje, czwarty format jest zawsze używany w przypadku tekstu.
[Color] or [Color#] Sprawia, że każda wartość renderowana przez ten podformat pojawia się z tagiem danego koloru tekstu. Prawidłowe wartości dla atrybutu Color to czarny, niebieski, błękitny, zielony, purpurowy, czerwony, biały lub żółty. Prawidłowe wartości znaku „#” w Color# wynosi 0&ndash1;56 (to paleta kolorów wyświetla listę kolorów odpowiadających poszczególnym numerom). Format liczb kolory zastępują wszystkie kolory wpisane przez użytkownika w komórce, ale nie nadpisz kolory ustawione przez formatowanie warunkowe.

Przykłady formatu liczb

W tabeli poniżej znajdziesz przykładowe wzorce i odpowiadające im renderowanie sformatowanej liczby:

Liczba Wzór Sformatowana wartość
12 345 ####.# 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
Mój tekst
###0.000;"TEXT: "_(@_) 123114.151
TEKST: MyText
1234
-1234
0
Mój tekst
[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) 1234
1234
0,0
MyText
1005
32
527
[>1000]"HIGH";[Color43][<=200]"LOW";0000 WYSOKA
NISKA
0527