I formati di data, ora e numero ti consentono di controllare il modo in cui i dati vengono visualizzati in un foglio. Fogli Google offre alcuni formati comuni tra cui scegliere, ma puoi anche definire formati personalizzati.
Nell'interfaccia utente di Fogli, puoi applicare i formati numerici e di data alle celle utilizzando il menu
Formato > Numero. Nell'API Fogli, imposta questi formati utilizzando una chiamata del metodo spreadsheets.batchUpdate per inviare UpdateCellsRequest o RepeatCellRequest.
Questa pagina descrive come definire nuovi pattern per il formato di data e numero, che puoi includere nella richiesta API. L'esempio Imposta un formato data/ora o decimale personalizzato per un intervallo mostra come impostare un pattern di formato utilizzando l'API. Tieni presente che il rendering effettivo
del formato dipende dal valore locale del foglio di lavoro. Questa guida presuppone che il 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 per fogli di lavoro, tratta i valori di data e ora come valori decimali. In questo modo puoi eseguire calcoli matematici in formule, in modo da poter aumentare i giorni o le settimane, aggiungere o sottrarre due date e ore ed eseguire altre operazioni simili.
Fogli utilizza una forma di data del periodo, comunemente usata nei fogli di lavoro. La parte del numero intero del valore (a sinistra del separatore decimale) conteggia i giorni a partire dal 30 dicembre 1899. La porzione frazionaria (a destra del decimale) conteggia il tempo come una frazione di un giorno. Ad esempio, il 1° gennaio 1900 a mezzogiorno è 2.5, 2 perché sono due giorni dopo il 30 dicembre 1899 e 0.5 perché mezzogiorno è mezza giornata. Il 1° febbraio 1900 alle 15:00
è 33.625.
Fogli considera correttamente l'anno 1900 come un anno comune, non un anno bisestile.
Pattern del formato di data e ora
Un pattern del formato data-ora è una stringa di sottostringhe di token che, quando analizzate, vengono sostituite con gli elementi di data e ora corrispondenti (come mese o ora).
Token di formato di data e ora
La seguente tabella definisce le sottostringhe del token che puoi utilizzare in un pattern di formato data-ora. Un carattere + indica che il carattere precedente può apparire
una o più volte e comunque corrispondere 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. Passa dal formato a 12 ore a quello a 24 ore in base alla presenza di un indicatore AM o PM nella stringa. |
hh+ |
Come il precedente, ma con uno 0 iniziale che fa 1-9. |
m |
Se il token precedente non letterale era di ore o quello successivo è in secondi, rappresenta i minuti nell'ora (senza 0 iniziale). Altrimenti, rappresenta il mese dell'anno in formato numerico (senza 0 iniziale). |
M |
Il mese dell'anno senza 0 iniziale. Utilizza questo token per indicare espressamente un mese, anziché un minuto, nel tuo 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 tuo pattern. |
mmm |
Abbreviazione del mese di tre lettere (ad es. "feb"). |
mmmm |
Nome completo del mese. Anche mmmmmm+ corrisponde a questo elemento. |
mmmmm |
Prima lettera del mese (ad esempio, "J" per giugno). |
s |
Secondi nel minuto senza uno 0 iniziale. |
ss |
Secondi nel minuto con uno 0 iniziale. |
[h+] |
Numero di ore trascorse in un determinato periodo di tempo. Il numero di lettere indica il numero minimo di cifre (aggiunge gli 0 iniziali). |
[m+] |
Numero di minuti trascorsi in un determinato periodo di tempo. Il numero di lettere indica il numero minimo di cifre (aggiunge gli 0 iniziali). |
[s+] |
Numero di secondi trascorsi in un intervallo di tempo. Il numero di lettere indica il numero minimo di cifre (aggiunge gli 0 iniziali). |
d |
Giorno del mese, senza 0 iniziale per i numeri inferiori a 10. |
dd |
Giorno del mese, con uno 0 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 |
Mostra "a" per AM e "p" per PM. Modifica anche le ore impostandole sul formato 12 ore. Se la lettera del token è in maiuscolo, lo è anche l'output. |
am/pm |
Come sopra, ma mostra "AM" o "PM" ed è sempre in maiuscolo. |
0 |
Deci di secondi. Puoi aumentare la precisione a due cifre con 00 o tre cifre (millisecondi) con 000. |
\ |
Tratta il carattere successivo come un valore letterale e senza alcun significato speciale che potrebbe avere. |
"text" |
Visualizza il testo tra virgolette come valore letterale. |
Esempi di formati di data e ora
Viste la data e l'ora Tuesday, April 5, 2016, 4:08:53.528 PM, la tabella seguente mostra alcuni pattern di esempio e il relativo rendering 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 |
16:08:53,53 |
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, martedì apr 05 |
dddd, m/d/yy at h:mm |
martedì, 5/04/16 alle 16:08 |
| Pattern del tempo trascorso | 3 hours, 13 minutes, 41.255 seconds |
[hh]:[mm]:[ss].000 |
03:13:41,255 |
[mmmm]:[ss].000 |
0193:41,255 |
Pattern del formato numerico
Un pattern del formato numerico è una stringa di sottostringhe di token che, quando analizzate, vengono sostituite con le rappresentazioni numeriche corrispondenti. Un pattern del formato numerico può essere composto da massimo quattro sezioni, separate da punti e virgola, che definiscono i formati separati utilizzati per i numeri positivi, i numeri negativi, lo zero e il 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 ai numeri zero e positivi e il secondo ai numeri negativi. L'uso di tre sezioni definisce 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 ci sono due o più sezioni e l'ultima è in formato testo, questa sezione viene trattata come testo 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 viene eseguita prima di un'altra analisi, pertanto è possibile includere un formato di data o ora in una delle sezioni (anche se questa operazione è di utilità limitata).
Token del formato numerico
La seguente tabella definisce le sottostringhe del token che puoi utilizzare in una sezione Formato per definire come rappresentare i valori per quella sezione.
| Token | Descrizione |
|---|---|
0 |
Rappresenta una cifra nel numero. Se la cifra è uno 0 non significativo,
viene visualizzato come 0. Ad esempio, il formato numerico 00.0 mostra il numero 3 come "03.0". |
# |
Rappresenta una cifra nel numero. Se la cifra è uno 0 non significativo,
non viene visualizzata. Ad esempio, il formato numerico ##0
esegue il rendering del numero 12 come "12". |
? |
Rappresenta una cifra nel numero. Se la cifra è uno 0 non significativo,
viene visualizzata come uno spazio. Viene spesso utilizzato per allineare il punto decimale in una colonna quando si utilizzano caratteri a larghezza fissa. Ad esempio, il formato numerico
???.??? esegue il rendering del numero 12.4 come:
" 12.4 ". |
. |
Il primo punto rappresenta il punto decimale nel numero. I periodi 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 di essere visualizzati per rendere le percentuali più leggibili. Ad esempio, il formato numerico #%
esegue il rendering del numero 0,25 come "25%". |
, |
Se compare tra caratteri a due cifre (0,
# o ?), esegue il rendering dell'intero numero con separatori di raggruppamento (raggruppati per migliaia). Se segue i caratteri numerici, le cifre vengono scalate di mille per virgola (ad esempio, il formato #0.0,, restituisce il numero 12.200.000 come 12.2). |
E- |
Visualizza il numero in formato scientifico, con la formattazione a sinistra del E utilizzata per la parte non esponente e la formattazione a destra della parte E utilizzata per la parte dell'esponente. E+ mostra un segno + per gli
esponenti positivi. E- mostra solo un segno per gli esponenti negativi. Se viene utilizzato il minuscolo, anche l'output e sarà in minuscolo.
Ad esempio, il formato numerico ##0.00#E+## esegue il rendering del numero 0,0000001 come "100.00E-9". |
E+ |
|
e- |
|
e+ |
|
/ |
Se compare tra caratteri a due cifre (0,
# o ?), questi gruppi di cifre vengono considerati 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 applica quel numero intero come denominatore. Il formato numerico 0 #/8 mostra il numero 23,25 come 23 2/8. La parte della frazione non viene visualizzata se il numeratore diventa 0. Il numero 23.1 con il formato numerico 0 #/3 viene visualizzato solo come 23 (perché 0,1 viene arrotondato a 0/3). / non è compatibile con il formato scientifico o con un formato che contiene un punto decimale. |
* |
È incluso per la compatibilità con i formati numerici di Microsoft Excel. Al momento è ignorato. |
_ |
Il token del trattino basso salta il carattere successivo e mostra 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 senza alcun significato speciale che potrebbe avere. Ad esempio, il formato numerico \#0
visualizza il numero 10 come "#10". |
"text" |
Visualizza il testo tra virgolette come valore letterale. |
@ |
Se la cella include un input di testo, inserisce il testo non elaborato per la cella. Non è compatibile con nessuno degli altri caratteri speciali e non viene visualizzato per i valori numerici (visualizzati come formato generale). |
$ - + ( ) : space |
Fogli tratta questi caratteri come valori letterali e li visualizza invariati. |
Meta istruzioni
Inoltre, ciascuna delle sezioni del formato può avere istruzioni meta facoltative, racchiuse tra caratteri [], che precedono il formato e forniscono istruzioni aggiuntive. Esistono due tipi di meta-istruzione e una determinata
sezione può utilizzarli entrambi:
| Istruzione | Descrizione |
|---|---|
[condition] |
Sostituisce il confronto predefinito positivo, negativo o pari a zero della sezione con un'altra espressione condizionale. Ad esempio, [<100]”Low”;[>1000]”High”;000 restituisce la parola "Basso" per i valori inferiori a 100, "Alto" per i valori superiori a 1000 e un numero a tre cifre (con 0 iniziali) per tutti gli elementi intermedi. Le condizioni possono essere applicate solo ai primi due sottoformati e, se un numero corrisponde a più di uno, utilizza il primo corrispondente. Se c'è 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 esiste, viene sempre utilizzato il quarto formato per il testo. |
[Color] or [Color#] |
Consente di visualizzare qualsiasi valore visualizzato da questo sottoformato 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 0-56 (questa tavolozza dei colori mostra un elenco dei colori che corrispondono a ogni numero). I colori del formato numerico sostituiscono eventuali colori inseriti dall'utente nella cella, ma non sostituiscono quelli impostati dalla formattazione condizionale. |
Esempi di formati numerici
La seguente tabella mostra alcuni pattern di esempio e il relativo rendering dei numeri formattati:
| Numero | Sequenza | 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 MioTesto |
###0.000;"TEXT: "_(@_) |
123114.151 TESTO: MyText |
| 1234 -1234 0 MioTesto |
[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 |