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. Pozwala to wykonywać 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 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 danym okresie. 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, przy pierwszej 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 |