I formati data/ora e numerici ti consentono di controllare la visualizzazione dei dati in un foglio. Fogli Google offre alcuni formati comuni tra cui scegliere, ma puoi anche definire i tuoi formati.
Nell'interfaccia utente di Fogli, puoi applicare i formati di numeri e date alle celle utilizzando il menu Formato > Numero. Nell'API Fogli, imposti questi formati utilizzando una chiamata al metodo
spreadsheets.batchUpdate per inviare un
UpdateCellsRequest o
RepeatCellRequest.
Questa pagina descrive come definire nuovi pattern di formato della data e numerico, che puoi includere nella richiesta API. L'esempio
Imposta un formato decimale o data/ora personalizzato per un intervallo
mostra come impostare un pattern di formato utilizzando l'API. Tieni presente che il rendering effettivo
del formato dipende dal locale del foglio di lavoro. Questa guida presuppone che locale sia en_US. Puoi determinare il locale di un foglio di lavoro leggendo
SpreadsheetProperties
con una richiesta spreadsheets.get.
Informazioni sui valori di data e ora
Fogli, come la maggior parte delle altre applicazioni di fogli di lavoro, tratta i valori di data e ora come valori decimali. In questo modo puoi eseguire operazioni aritmetiche nelle formule, ad esempio incrementare giorni o settimane, aggiungere o sottrarre due date e orari ed eseguire altre operazioni simili.
Fogli utilizza una forma di
data di epoca
comunemente utilizzata nei fogli di lavoro. La parte intera del valore
(a sinistra della virgola decimale) conteggia i giorni dal 30 dicembre 1899. La parte frazionaria (a destra del decimale) conteggia il tempo come frazione di un giorno. Per
esempio, il 1° gennaio 1900 a mezzogiorno è 2.5, 2 perché sono trascorsi 2 giorni dal
30 dicembre 1899 e 0.5 perché mezzogiorno è metà giornata. Il 1° febbraio 1900 alle ore 15
è 33.625.
Fogli tratta correttamente l'anno 1900 come un anno comune, non bisestile.
Pattern di formato di data e ora
Un pattern di formato data/ora è una stringa di sottostringhe di token che, durante l'analisi, vengono sostituite con gli elementi data/ora corrispondenti (ad esempio il mese o l'ora).
Token per i formati di data e ora
La tabella seguente definisce le sottostringhe di token che puoi utilizzare in un pattern di formato della data e dell'ora. Un carattere + indica che il carattere precedente può comparire
una o più volte e comunque corrispondere al pattern. I caratteri non elencati nella tabella di seguito vengono trattati come letterali e vengono visualizzati senza modifiche.
| Token | Descrizione |
|---|---|
h |
Ora del giorno. Passa dal formato 12 ore a quello 24 ore a seconda che nella stringa sia presente un indicatore AM o PM. |
hh+ |
Come sopra, ma con uno zero iniziale per 1-9. |
m |
Se il token non letterale precedente era ore o quello successivo è secondi, rappresenta i minuti nell'ora (senza lo zero iniziale). In caso contrario, rappresenta il mese dell'anno come numero (senza zero iniziale). |
M |
Il mese dell'anno senza zero iniziale. Utilizza questo token per indicare espressamente un mese, anziché un minuto, nel pattern. |
mm |
Uguale a m, ma con un 0 iniziale per entrambi i casi. |
MM |
Il mese dell'anno con uno zero iniziale. Utilizza questo token per indicare espressamente un mese, anziché un minuto, nel pattern. |
mmm |
Abbreviazione del mese di tre lettere (ad esempio, "Feb"). |
mmmm |
Nome completo del mese. Anche mmmmmm+ corrisponde a questo. |
mmmmm |
La prima lettera del mese (ad esempio, "G" per giugno). |
s |
Secondi del minuto senza lo zero iniziale. |
ss |
Secondi del minuto con un 0 iniziale. |
[h+] |
Numero di ore trascorse in un periodo di tempo. Il numero di lettere indica il numero minimo di cifre (vengono aggiunti zeri iniziali). |
[m+] |
Numero di minuti trascorsi in un periodo di tempo. Il numero di lettere indica il numero minimo di cifre (vengono aggiunti zeri iniziali). |
[s+] |
Numero di secondi trascorsi in un periodo di tempo. Il numero di lettere indica il numero minimo di cifre (vengono aggiunti zeri iniziali). |
d |
Giorno del mese, senza zero iniziale per i numeri minori di 10. |
dd |
Giorno del mese, con uno zero iniziale per i numeri minori di 10. |
ddd |
Giorno della settimana, abbreviato in tre lettere (ad es. "Mon"). |
dddd+ |
Giorno della settimana, nome completo. |
y |
Anno a due cifre. |
yy |
|
yyy |
Anno a 4 cifre. |
yyyy+ |
|
a/p |
Mostra "a" per AM e "p" per PM. Modifica anche le ore in formato di 12 ore. Se la lettera del token è maiuscola, lo è anche l'output. |
am/pm |
Come sopra, ma viene visualizzato "AM" o "PM" ed è sempre scritto in lettere maiuscole. |
0 |
Decimi di secondo. Puoi aumentare la precisione a due cifre con
00 o a tre cifre (millisecondi) con 000. |
\ |
Tratta il carattere successivo come un valore letterale e non come un significato speciale. |
"text" |
Mostra il testo all'interno delle virgolette come valore letterale. |
Esempi di formati di data e ora
Data e ora Tuesday, April 5, 2016, 4:08:53.528 PM, la tabella seguente mostra alcuni pattern di esempio e il rendering corrispondente della data e dell'ora. La seconda sezione della tabella mostra esempi di formati del tempo trascorso per un tempo trascorso di 3 hours, 13 minutes, 41.255 seconds:
| Pattern data/ora | Tuesday, April 5, 2016, 4:08:53.528 PM |
|---|---|
h:mm:ss.00 a/p |
4:08:53.53 p |
hh:mm A/P".M." |
04:08 |
yyyy-mm-dd |
2016-04-05 |
mmmm d \[dddd\] |
5 aprile [martedì] |
h PM, ddd mmm dd |
16:00, martedì 05 aprile |
dddd, m/d/yy at h:mm |
Martedì 5/4/16 alle 16:08 |
| Pattern di tempo trascorso | 3 hours, 13 minutes, 41.255 seconds |
[hh]:[mm]:[ss].000 |
03:13:41.255 |
[mmmm]:[ss].000 |
0193:41.255 |
Pattern di formato numerico
Un pattern di formato numerico è una stringa di sottostringhe di token che, durante l'analisi, vengono sostituite con le rappresentazioni numeriche corrispondenti. Un pattern di formato numerico può essere costituito da un massimo di quattro sezioni separate da punti e virgola che definiscono i formati separati utilizzati per numeri positivi, numeri negativi, zero e testo (in questo ordine):
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
Non è necessario includere tutte e quattro le sezioni in un formato. Se includi una sola sezione, questo formato viene utilizzato per tutti i valori. L'utilizzo di due sezioni fa sì che il primo formato venga applicato a zero e ai numeri positivi e il secondo formato ai numeri negativi. L'utilizzo di tre sezioni consente di definire formati separati per i numeri positivi, negativi e zero. Ad esempio:
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]
Tuttavia, se sono presenti due o più sezioni e la sezione finale è in formato testo, questa viene trattata come tale e le altre si comportano come se fosse presente una sezione in meno. Pertanto, includendo un formato di testo finale è possibile definire formati come:
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
L'analisi di un formato in sezioni avviene prima di altre analisi, pertanto è possibile includere un formato di data o ora in una delle sezioni (anche se questo è di utilità limitata).
Token formato numerico
La tabella seguente definisce le sottostringhe di token che puoi utilizzare in una sezione di formato per definire la modalità di rappresentazione dei valori per quella sezione.
| Token | Descrizione |
|---|---|
0 |
Rappresenta una cifra nel numero. Se il numero è uno 0 senza significato, viene visualizzato come 0. Ad esempio, il formato numerico
00.0 restituisce il numero 3 come "03.0". |
# |
Rappresenta una cifra nel numero. Se il numero è uno 0 senza significato,
non viene visualizzato. Ad esempio, il formato numerico ##0
mostra il numero 12 come "12". |
? |
Rappresenta una cifra nel numero. Se la cifra è uno 0 senza significato, viene visualizzata come uno spazio. Questo viene spesso utilizzato per allineare la virgola decimale in
una colonna quando si utilizzano caratteri di larghezza fissa. Ad esempio, il formato numerico
???.??? mostra il numero 12,4 come:
" 12.4 ". |
. |
Il primo punto rappresenta la virgola decimale nel numero. I periodi
successivi vengono visualizzati come letterali. Se includi un punto decimale nel formato, viene sempre visualizzato, anche per i numeri interi. Ad esempio,
#0.# restituisce il numero 3 come "3.". |
% |
Viene visualizzato come un valore letterale, ma i numeri esistenti vengono anche moltiplicati per 100 prima di essere visualizzati per rendere le percentuali più leggibili. Ad esempio, il formato numerico #%
visualizza il numero 0,25 come "25%". |
, |
Se viene visualizzato tra caratteri di due cifre (0,
# o ?), viene visualizzato l'intero numero
con i separatori di raggruppamento (raggruppamento per migliaia). Se segue
i caratteri numerici, moltiplica le cifre per mille per ogni
virgola (ad esempio, il formato #0.0,, visualizza il numero
12.200.000 come 12.2). |
E- |
Il numero viene visualizzato in formato scientifico, con la formattazione a sinistra di E utilizzata per la parte non esponenziale e la formattazione a destra di E utilizzata per la parte esponenziale. E+ mostra un segno + per gli exponenti positivi. E- mostra un segno solo per gli esponenti negativi. Se viene utilizzata la minuscola, anche l'output e è in minuscolo.
Ad esempio, il formato numerico ##0.00#E+##
visualizza il numero 0,0000001 come "100.00E-9". |
E+ |
|
e- |
|
e+ |
|
/ |
Se viene visualizzato tra caratteri di due cifre (0,
# o ?), questi gruppi di cifre vengono trattati come un
formato frazionario. Ad esempio, il formato numerico 0 #/# visualizza
il numero 23,25 come 23 1/4. Il denominatore può essere anche un numero intero letterale, in tal caso viene applicato come denominatore. Il formato numerico 0 #/8
mostra il numero 23,25 come 23 2/8. La parte frazionaria non viene visualizzata se il numeratore diventa 0. Il numero
23,1 con il formato numerico 0 #/3 viene visualizzato come
23 (poiché 0,1 viene arrotondato a 0/3). / non è compatibile con il formato scientifico o con un formato contenente un punto decimale. |
* |
Questo valore è incluso per la compatibilità con i formati numerici di Microsoft Excel. Al momento viene ignorato. |
_ |
Il token underscore salta il carattere successivo e visualizza uno spazio. Viene utilizzato per allineare i formati numerici in cui il valore negativo è racchiuso tra parentesi. |
\ |
Tratta il carattere successivo come un valore letterale e non come un significato speciale. Ad esempio, il formato numerico \#0
mostra il numero 10 come "#10". |
"text" |
Mostra il testo all'interno delle virgolette come valore letterale. |
@ |
Se la cella ha un input di testo, viene inserito il testo non elaborato della cella. Non è compatibile con gli altri caratteri speciali e non viene visualizzato per i valori numerici (che vengono visualizzati come formato generale). |
$ - + ( ) : space |
Fogli tratta questi caratteri come letterali e li visualizza immutati. |
Istruzioni meta
Inoltre, ciascuna delle sezioni di formato può avere istruzioni meta facoltative, chiuse tra caratteri [], che precedono il formato e forniscono istruzioni aggiuntive. Esistono due tipi di istruzioni meta e una determinata sezione può utilizzarle entrambe:
| Istruzione | Descrizione |
|---|---|
[condition] |
Sostituisce il confronto predefinito positivo, negativo o zero della
sezione con un'altra espressione condizionale. Ad esempio,
[<100]”Low”;[>1000]”High”;000 mostra la parola
"Basso" per i valori inferiori a 100, "Alto" per i valori superiori a 1000 e un numero di tre cifre (con zeri iniziali) per i valori intermedi. Le condizioni possono essere applicate solo ai primi due sottoformati e, se un numero corrisponde a più di uno, viene utilizzato il primo. Se esiste un terzo formato, viene utilizzato per "tutto il resto", altrimenti, se un numero non corrisponde a nessuno dei due formati, viene visualizzato come tutti i "#" che riempiono la larghezza della cella. Se esistente, viene sempre utilizzato il quarto formato per il testo. |
[Color] or [Color#] |
Consente di visualizzare qualsiasi valore visualizzato da questo sottoformato con il colore di testo specificato. I valori validi per Color sono Nero, Blu, Ciano, Verde, Magenta, Rosso, Bianco o Giallo. I valori validi per "#" in Color# sono 1-56 (questa tavolozza dei colori mostra un elenco dei colori corrispondenti a ciascun numero). I colori del formato numerico sovrascrivono i colori inseriti dall'utente nella cella, ma non sovrascrivono i colori impostati dalla formattazione condizionale. |
Esempi di formati numerici
La tabella seguente mostra alcuni pattern di esempio e il rendering corrispondente del numero formato:
| Numero | Pattern | Valore formattato |
|---|---|---|
| 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 Il mio testo |
###0.000;"TEXT: "_(@_) |
123114.151 TEXT: MyText |
| 1234 -1234 0 Il mio testo |
[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) |
1.234 1.234 0,0 MyText |
| 1005 32 527 |
[>1000]"HIGH";[Color43][<=200]"LOW";0000 |
ALTO BASSO 0527 |