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, imposti questi formati utilizzando una chiamata al metodo
spreadsheets.batchUpdate
per inviare un
UpdateCellsRequest
o
RepeatCellRequest.
Questa pagina descrive come definire nuovi pattern per il formato di date e numeri, che puoi includere nella richiesta API. L'esempio Impostare 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 dall'elemento locale del foglio di lavoro. Questa guida presuppone che il locale sia en_US. Puoi determinare il locale di un foglio di lavoro leggendo
la
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, in modo da poter aumentare giorni o settimane, aggiungere o sottrarre due date e ore ed eseguire altre operazioni simili.
Fogli utilizza un formato di data dell'epoca comunemente usato nei fogli di lavoro. La parte del numero intero del valore
(a sinistra del decimale) conta i giorni 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é fa due giorni dopo il 30 dicembre 1899 e 0.5 perché mezzogiorno è mezza giornata. del 1° febbraio 1900 alle 15:00
il costo è 33.625.
Fogli tratta correttamente l'anno 1900 come un anno comune, non come un anno bisestile.
Pattern di formato di data e ora
Un pattern del formato data-ora è una stringa di sottostringhe di token che, una volta analizzate, vengono sostituite con gli elementi data-ora corrispondenti (come mese o ora).
Token del formato di data e ora
La seguente tabella definisce le sottostringhe dei token che puoi utilizzare in un pattern in 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. Alterna il formato da 12 a 24 ore in base alla presenza di un indicatore AM o PM nella stringa. |
hh+ |
Come il precedente, ma con 0 in vantaggio per 1-9. |
m |
Se il token non letterale precedente era di ore o quello successivo è in secondi, rappresenta i minuti dell'ora (senza lo 0 iniziale). In caso contrario, rappresenta il mese dell'anno come numero (senza 0 iniziale). |
M |
Il mese dell'anno senza 0 iniziale. Utilizza questo token per indicare in modo esplicito un mese, invece di un minuto, nel tuo pattern. |
mm |
Uguale a m, ma con 0 iniziale in entrambi i casi. |
MM |
Il mese dell'anno con 0 iniziale. Utilizza questo token per indicare in modo esplicito un mese, invece di un minuto, nel tuo pattern. |
mmm |
Abbreviazione di tre lettere del mese (ad es. "Feb"). |
mmmm |
Nome completo del mese. Anche mmmmmm+ corrisponde a questo elemento. |
mmmmm |
Prima lettera del mese (ad es. "J" per giugno). |
s |
Secondi al minuto senza 0 iniziale. |
ss |
Secondi al minuto con 0 in vantaggio. |
[h+] |
Numero di ore trascorse in un intervallo di tempo. "Numero di lettere" indica il numero minimo di cifre (aggiunge 0 iniziali). |
[m+] |
Numero di minuti trascorsi in un determinato periodo di tempo. "Numero di lettere" indica il numero minimo di cifre (aggiunge 0 iniziali). |
[s+] |
Numero di secondi trascorsi in un intervallo di tempo. "Numero di lettere" indica il numero minimo di cifre (aggiunge 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 minori di 10. |
ddd |
Giorno della settimana, abbreviazione di tre lettere (ad esempio, "Lun"). |
dddd+ |
Giorno della settimana, nome e cognome. |
y |
Anno a due cifre. |
yy |
|
yyy |
Anno a quattro cifre. |
yyyy+ |
|
a/p |
Mostra "a" per AM e "p" per PM. Modifica anche gli orari nel formato 12 ore. Se la lettera del token è in maiuscolo, lo è anche l'output. |
am/pm |
Come sopra, ma visualizza "AM" o "PM" ed è sempre in maiuscolo. |
0 |
Deci di secondi. 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 che potrebbe avere. |
"text" |
Visualizza il testo tra virgolette come valore letterale. |
Esempi di formati di data e ora
Considerate la data e l'ora Tuesday, April 5, 2016, 4:08:53.528 PM, la seguente tabella mostra alcuni pattern di esempio e il relativo rendering data-ora. La seconda sezione della tabella mostra esempi di formati di tempo trascorso
per un tempo trascorso di 3 hours, 13 minutes, 41.255 seconds:
| Pattern di data e ora | Tuesday, April 5, 2016, 4:08:53.528 PM |
|---|---|
h:mm:ss.00 a/p |
16: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 05 apr |
dddd, m/d/yy at h:mm |
martedì, 5/4/16 alle 16:08 |
| Modelli 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 del formato numerico
Un pattern di formato numerico è una stringa di sottostringhe di token che, una volta analizzate, vengono sostituite con le rappresentazioni numeriche corrispondenti. Un modello di 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, quel formato viene utilizzato per tutti i valori. Utilizzando due sezioni, il primo formato viene applicato a zero e numeri positivi e il secondo a 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 sono presenti due o più sezioni e la sezione finale è in formato testo, questa viene trattata come formato di testo e le altre si comportano come se ci fosse una sezione in meno. Includendo un formato di testo finale è possibile definire formati quali:
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
L'analisi di un formato in sezioni avviene prima di un'altra analisi, quindi è possibile che una delle sezioni includa un formato di data o ora (anche se di utilità limitata).
Token formato numerico
La seguente tabella 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 non significativo,
viene visualizzato come 0. Ad esempio, il formato numerico 00.0 restituisce il numero 3 come "03.0". |
# |
Rappresenta una cifra nel numero. Se la cifra è uno 0 non significativo,
il rendering non viene eseguito. Ad esempio, il formato numerico ##0
visualizza il numero 12 come "12". |
? |
Rappresenta una cifra nel numero. Se la cifra è uno 0 non significativo, viene eseguito il rendering come uno spazio. Questo viene spesso utilizzato per allineare il punto decimale in una colonna quando si utilizzano caratteri a larghezza fissa. Ad esempio, il formato numerico ???.??? restituisce il numero 12,4 come: " 12.4 ". |
. |
Il primo punto rappresenta la virgola decimale del numero. I punti successivi vengono visualizzati come valori letterali. Se includi una virgola decimale nel formato, il rendering viene sempre eseguito, anche per i numeri interi. Ad esempio, #0.# esegue il rendering del numero 3 come "3.". |
% |
Appare come un valore letterale, ma fa anche sì che i numeri esistenti vengano moltiplicati per 100 prima di essere visualizzati al fine di rendere le percentuali più leggibili. Ad esempio, il formato numerico #%
restituisce il numero 0,25 come "25%". |
, |
Se viene visualizzato tra i caratteri a due cifre (0,
# o ?), visualizza l'intero numero
con separatori di raggruppamento (raggruppamento per migliaia). Se segue i caratteri numerici, le cifre vengono scalate di un migliaio 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 di E utilizzata per la parte non esponente e la formattazione a destra della E utilizzata per la parte esponente. E+ mostra un segno + per gli esponenti
positivi. E- mostra solo un segno per esponenti negativi. Se si utilizza il minuscolo, anche l'output e è in minuscolo.
Ad esempio, il formato numerico ##0.00#E+##
restituisce il numero 0,0000001 come "100.00E-9". |
E+ |
|
e- |
|
e+ |
|
/ |
Se viene visualizzato tra i caratteri a due cifre (0,
# o ?), i gruppi di cifre in questione vengono considerati come un
formato frazionario. Ad esempio, il formato numerico 0 #/# restituisce
il numero 23,25 come 23 1/4. Il denominatore può anche essere un numero intero letterale, nel qual caso viene applicato 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 come
solo 23 (perché 0,1 viene arrotondato a 0/3). / non è compatibile con il formato scientifico o con un formato che contiene una virgola decimale. |
* |
Questo valore è incluso per la compatibilità con i formati numerici di Microsoft Excel. Al momento viene ignorato. |
_ |
Il token del trattino basso salta il carattere successivo e restituisce 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 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 ha un input di testo, inserisce il testo non elaborato per la cella. Non compatibile con gli altri caratteri speciali e non mostra i valori numerici (che vengono visualizzati come formato generale). |
$ - + ( ) : space |
Fogli tratta questi caratteri come valori letterali e li visualizza senza modifiche. |
Metadati
Inoltre, ciascuna sezione del formato può avere meta istruzioni facoltative, racchiuse tra caratteri [], che precedono il formato e forniscono istruzioni aggiuntive. Esistono due tipi di meta istruzioni e una
sezione specifica può utilizzare entrambi:
| Istruzione | Descrizione |
|---|---|
[condition] |
Sostituisce il confronto positivo, negativo o zero predefinito 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 di tre cifre (con 0 iniziali) per qualsiasi elemento intermedio. Le condizioni possono essere applicate solo ai primi due sottoformati e, se un numero corrisponde a più di uno, utilizza il primo corrispondente. Se esiste un terzo formato, viene utilizzato per "tutto il resto". In caso contrario, se un numero non corrisponde a nessuno dei due formati, viene visualizzato perché tutti i caratteri "#" riempiono la larghezza della cella. Se esiste, il quarto formato viene sempre utilizzato 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 ciascun numero). I colori del formato numerico sostituiscono tutti i colori inseriti dall'utente nella cella, ma non quelli impostati dalla formattazione condizionale. |
Esempi di formati numerici
La tabella seguente mostra alcuni pattern di esempio e il rendering dei numeri formattati corrispondente:
| 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 MyText |
###0.000;"TEXT: "_(@_) |
123114.151 TESTO: 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 |
ELEVATO BASSO 0527 |