Formati di data e numero

I formati di data/ora e numero ti consentono di controllare in che modo i tuoi dati vengono visualizzati in un foglio. Fogli Google fornisce alcuni formati comuni tra cui scegliere, ma puoi anche definire formati personalizzati.

Nell'interfaccia utente di Fogli, applichi i formati di numeri e date alle celle utilizzando il menu Formato > Numero. Nell'API Sheets, imposta questi formati utilizzando una chiamata al metodo spreadsheets.batchUpdate per inviare un UpdateCellsRequest o RepeatCellRequest.

Questa pagina descrive come definire nuovi pattern di formato di data e numero, che puoi includere nella richiesta API. L'esempio Impostare un formato personalizzato per data e ora o decimale 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 il SpreadsheetProperties con una richiesta spreadsheets.get.

Informazioni sui valori di data e ora

Fogli, come la maggior parte delle altre applicazioni per fogli di lavoro, considera 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 ore ed eseguire altre operazioni simili.

Fogli utilizza una forma di data epoca comunemente utilizzata nei fogli di lavoro. La parte intera del valore (a sinistra della virgola decimale) conta i giorni dal 30 dicembre 1899. La parte frazionaria (a destra della virgola) conta il tempo come frazione di un giorno. Ad esempio, il 1° gennaio 1900 a mezzogiorno è 2.5, 2 perché è 2 giorni dopo il 30 dicembre 1899 e 0.5 perché mezzogiorno è metà giornata. 1° febbraio 1900 alle ore 15:00 è 33.625.

Fogli tratta correttamente l'anno 1900 come anno comune, non bisestile.

Pattern di formato di data e ora

Un pattern di formato data e ora è una stringa di sottostringhe di token che, una volta analizzate, vengono sostituite con gli elementi di data e ora corrispondenti (ad esempio il mese o l'ora).

Token di formato di data e ora

La seguente tabella definisce le sottostringhe dei token che puoi utilizzare in un pattern di formato data e ora. Il carattere + indica che il carattere precedente può essere presente una o più volte e corrispondere comunque al pattern. I caratteri non elencati nella tabella seguente vengono trattati come valori letterali e vengono restituiti senza modifiche.

Token Descrizione
h Ora del giorno. Alterna il formato di 12 e 24 ore a seconda che nella stringa sia presente un indicatore AM o PM.
hh+ Come il precedente, ma con uno 0 iniziale per i numeri da 1 a 9.
m Se il token non letterale precedente era ore o quello successivo è secondi, rappresenta i minuti nell'ora (senza uno zero iniziale). Altrimenti, 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 uno 0 iniziale per entrambi i casi.
MM Il mese dell'anno con uno 0 iniziale. Utilizza questo token per indicare espressamente un mese, anziché un minuto, nel pattern.
mmm Abbreviazione di tre lettere del mese (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 0 iniziale.
ss Secondi del minuto con uno 0 iniziale.
[h+] Numero di ore trascorse in un periodo di tempo. Numero di lettere indica il numero minimo di cifre (aggiunge zeri iniziali).
[m+] Numero di minuti trascorsi in un periodo di tempo. Numero di lettere indica il numero minimo di cifre (aggiunge zeri iniziali).
[s+] Numero di secondi trascorsi in un periodo di tempo. Numero di lettere indica il numero minimo di cifre (aggiunge zeri iniziali).
d Giorno del mese, senza zero iniziale per i numeri inferiori a 10.
dd Il giorno del mese, con uno zero iniziale per i numeri inferiori a 10.
ddd Giorno della settimana, abbreviazione di tre lettere (ad esempio, "lun").
dddd+ Giorno della settimana, nome completo.
y Anno a 2 cifre.
yy
yyy Anno a 4 cifre.
yyyy+
a/p Visualizza "a" per AM e "p" per PM. Inoltre, cambia le ore nel formato a 12 ore. Se la lettera del token è in maiuscolo, anche l'output lo sarà.
am/pm Come sopra, ma visualizza "AM" o "PM" e viene sempre scritto in maiuscolo.
0 Decimi di secondo. Puoi aumentare la precisione a due cifre con 00 o a tre cifre (millisecondi) con 000.
\ Considera il carattere successivo come un valore letterale e non come un carattere speciale con un significato particolare.
"text" Visualizza il testo tra 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 di data e 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." 16:08
yyyy-mm-dd 2016-04-05
mmmm d \[dddd\] 5 aprile [martedì]
h PM, ddd mmm dd 16:00, mar 5 apr
dddd, m/d/yy at h:mm Martedì 05/04/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 token che, una volta analizzate, vengono sostituite dalle rappresentazioni numeriche corrispondenti. Un pattern di formato numerico può essere composto 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 ai numeri negativi. L'utilizzo di tre sezioni definisce formati separati per i numeri positivi, negativi e pari a 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 l'ultima è in formato di testo, questa sezione viene trattata come formato di testo e le altre si comportano come se ci fosse 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, quindi è possibile includere un formato di data o ora come una delle sezioni (anche se questa operazione è di utilità limitata).

Token di formato numerico

La tabella seguente definisce le sottostringhe del token che puoi utilizzare in una sezione del formato per definire come rappresentare i valori per quella sezione.

Token Descrizione
0 Rappresenta una cifra nel numero. Se la cifra è uno 0 senza significato, viene visualizzata come 0. Ad esempio, il formato numerico 00.0 visualizza il numero 3 come "03.0".
# Rappresenta una cifra nel numero. Se la cifra è uno 0 senza significato, non viene visualizzata. Ad esempio, il formato numerico ##0 visualizza il numero 12 come "12".
? Rappresenta una cifra nel numero. Se la cifra è uno 0 senza significato, viene visualizzata come spazio. Viene spesso utilizzato per allineare il punto decimale in una colonna quando si utilizzano caratteri a larghezza fissa. Ad esempio, il formato numerico ???.??? visualizza il numero 12,4 come: " 12.4 ".
. Il primo punto rappresenta il separatore decimale del numero. I punti successivi vengono visualizzati come valori letterali. Se includi un punto decimale nel formato, questo viene sempre visualizzato, anche per i numeri interi. Ad esempio, #0.# restituisce il numero 3 come "3.".
% Viene visualizzato come valore letterale, ma fa anche sì che i numeri esistenti vengano moltiplicati per 100 prima del rendering per rendere le percentuali più leggibili. Ad esempio, il formato numerico #% visualizza il numero 0,25 come "25%".
, Se viene visualizzato tra caratteri a due cifre (0, # o ?), viene visualizzato l'intero numero con i separatori di raggruppamento (raggruppamento per migliaia). Se segue i caratteri numerici, ridimensiona le cifre di mille per virgola (ad esempio, il formato #0.0,, visualizza il numero 12.200.000 come 12.2).
E- Visualizza il numero in formato scientifico, con la formattazione a sinistra di E utilizzata per la parte non esponente e la formattazione a destra di E utilizzata per la parte esponente. E+ mostra il segno + per gli esponenti positivi. E- mostra solo un segno per gli esponenti negativi. Se vengono utilizzate lettere minuscole, anche l'output e sarà 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 a due cifre (0, # o ?), considera questi gruppi di cifre come un formato frazionario. Ad esempio, il formato numerico 0 #/# esegue il rendering del numero 23,25 come 23 1/4. Il denominatore può anche essere un numero intero letterale, nel qual caso lo impone come denominatore. Il formato numerico 0 #/8 visualizza 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 (perché 0,1 viene arrotondato a 0/3). / non è compatibile con il formato scientifico o con un formato con un punto decimale.
* Questo è incluso per la compatibilità con i formati numerici di Microsoft Excel. Al momento viene ignorato.
_ Il token di sottolineatura salta il carattere successivo e visualizza uno spazio. Viene utilizzato per allineare i formati numerici in cui il valore negativo è racchiuso tra parentesi.
\ Considera il carattere successivo come un valore letterale e non come un carattere speciale con un significato particolare. Ad esempio, il formato numerico \#0 visualizza il numero 10 come "#10".
"text" Visualizza il testo tra virgolette come valore letterale.
@ Se la cella contiene testo inserito, viene inserito il testo non elaborato per la cella. Non compatibile con altri caratteri speciali e non viene visualizzato per valori numerici (che vengono visualizzati come formato generale).
$ - + ( ) : space Fogli tratta questi caratteri come valori letterali e li visualizza senza modifiche.

Istruzioni per Meta

Inoltre, ogni sezione del formato può avere meta istruzioni facoltative, racchiuse tra i caratteri [], che precedono il formato e forniscono istruzioni aggiuntive. Esistono due tipi di metainstruzioni e una determinata sezione può utilizzarli entrambi:

Istruzione Descrizione
[condition] Sostituisce il confronto positivo, negativo o pari a zero predefinito della sezione con un'altra espressione condizionale. Ad esempio, [<100]”Low”;[>1000]”High”;000 visualizza la parola "Basso" per i valori inferiori a 100, "Alto" per i valori superiori a 1000 e un numero a tre cifre (con zeri iniziali) per tutti gli altri valori. Le condizioni possono essere applicate solo ai primi due sottoformati e, se un numero corrisponde a più di uno, viene utilizzato il primo. Se è presente un terzo formato, viene utilizzato per "tutto il resto", altrimenti se un numero non corrisponde a nessuno dei due formati, viene visualizzato con tutti i caratteri "#" che riempiono la larghezza della cella. Se esiste, il quarto formato viene sempre utilizzato per il testo.
[Color] or [Color#] Fa sì che qualsiasi valore visualizzato da questo sottoformato venga visualizzato con il colore del 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 ogni numero). I colori del formato numerico ignorano i colori inseriti dall'utente nella cella, ma non ignorano i colori impostati dalla formattazione condizionale.

Esempi di formati numerici

La seguente tabella mostra alcuni pattern di esempio e il rendering del numero formattato corrispondente:

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
MyText		 ###0.000;"TEXT: "_(@_) 123114.151
TEXT: 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 ALTO
BASSO
0527