Formati di data e numero

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