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 e definire i tuoi formati.
Nell'interfaccia utente di Fogli, applichi i formati numerici e di data alle celle utilizzando il
Formato > Menu Numero. Nell'API Fogli, imposti questi formati utilizzando una
spreadsheets.batchUpdate
per inviare un
UpdateCellsRequest
o
RepeatCellRequest
In questa pagina viene descritto come definire nuovi pattern per il formato di date e numeri, che puoi
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
locale è en_US. Puoi determinare il locale di un foglio di lavoro leggendo
il
SpreadsheetProperties
con spreadsheets.get
richiesta.
Informazioni su data e valori temporali
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 operazioni aritmetiche nelle formule, incrementare giorni o settimane, aggiungere o sottrarre due date e ore ed eseguire altre operazioni simili.
Fogli utilizza un formato
epoca
comunemente utilizzata nei fogli di lavoro. La porzione del numero intero del valore
(a sinistra del decimale) conta i giorni dal 30 dicembre 1899. Il valore frazionario
(a destra del decimale) conta il tempo come frazione di un giorno. Per
ad esempio, il 1° gennaio 1900 a mezzogiorno è 2.5, 2 perché sono due giorni dopo
30 dicembre 1899 e 0.5 perché mezzogiorno è mezza giornata. 1° febbraio 1900 alle 15:00
è 33.625.
Fogli tratta correttamente l'anno 1900 come un anno comune, non come un anno bisestile.
Data e pattern del formato dell'ora
Un pattern di formato data-ora è una stringa di sottostringhe di token che, una volta analizzate, vengono sostituiti con i corrispondenti elementi di data e ora (come il mese o ore).
Data e token formato ora
La tabella seguente definisce le sottostringhe del token che puoi utilizzare in un intervallo di date/ora
pattern del formato. Un carattere + indica che il carattere precedente può essere visualizzato
una o più volte e corrispondere comunque allo schema. I caratteri non elencati nel
vengono trattate come valori letterali e l'output non viene modificato.
| Token | Descrizione |
|---|---|
h |
Ora del giorno. Alterna il formato 12-24 ore in base se nella stringa è presente un indicatore AM o PM. |
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 è secondi, rappresenta i minuti dell'ora (senza lo 0 iniziale). Altrimenti, 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 |
Visualizza "a" per AM e "p" per il pomeriggio. Modifica anche gli orari in Formato 12 ore. Se la lettera del token è maiuscola, 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 utilizzando
00 o tre cifre (millisecondi) con 000. |
\ |
Tratta il carattere successivo come valore letterale e non come valore speciale significato che potrebbe avere. |
"text" |
Visualizza il testo tra virgolette come valore letterale. |
Data e esempi di formati ora
Considerate la data e l'ora Tuesday, April 5, 2016, 4:08:53.528 PM, la
la seguente tabella mostra alcuni pattern di esempio e le relative date e ore
per il rendering delle immagini. La seconda sezione della tabella mostra esempi di tempo trascorso
formati 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ì, 4/5/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 corrispondenti rappresentazioni numeriche. Un pattern per il formato numerico può essere composto da massimo quattro sezioni, separate da punti e virgola, che definiscono utilizza formati separati per i numeri positivi, i numeri negativi, lo zero e il testo (in tale ordine):
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
Non è necessario includere tutte e quattro le sezioni in un formato. Se includi un solo elemento questo formato viene utilizzato per tutti i valori. L'uso di due sezioni fa sì che la prima da applicare a zero e numeri positivi, mentre il secondo formato a numeri negativi. L'utilizzo di tre sezioni definisce formati separati per positivi, numeri 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 la sezione finale è un testo questa sezione viene trattata come il formato di testo e le altre si comportano come se c'è una sezione in meno. Includere un formato di testo finale permette di per 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 includere un formato di data o ora in una delle sezioni (sebbene è di utilità limitata).
Token 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 il numero è uno 0 non significativo,
viene restituito 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 non significativo,
non ne viene eseguito il rendering. Ad esempio, il formato numerico ##0
visualizza il numero 12 come "12". |
? |
Rappresenta una cifra nel numero. Se il numero è uno 0 non significativo,
il rendering è come uno spazio. Questo viene spesso utilizzato per allineare la virgola decimale
una colonna quando utilizzi 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. Successiva
i punti vengono visualizzati come valori letterali. Se includi una virgola decimale nella
viene sempre eseguito, anche per i numeri interi. Ad esempio:
#0.# restituisce il numero 3 come "3.". |
% |
Appare come un valore letterale, ma causa anche la moltiplicazione dei numeri esistenti
di 100 prima di eseguirne il rendering per ottenere percentuali di 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 ?), esegue il rendering dell'intero numero
con separatori di raggruppamento (raggruppandoli per migliaia). Se segue
caratteri numerici, scala le cifre di un migliaio
virgola (ad esempio, il formato #0.0,, consente di visualizzare il numero
12.200.000 come 12.2). |
E- |
Visualizza il numero in formato scientifico, con
formattazione a sinistra del valore E utilizzata per l'elemento non esponente
e la formattazione a destra della E usata per l'esponente
una parte. E+ mostra il segno + di positivo
esponenti. E- mostra solo un segno per esponenti negativi. Se
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 ?), tratta questi gruppi di cifre come un
frazionario. Ad esempio, viene eseguito il rendering del formato numerico 0 #/#
il numero 23.25 come 23 1/4. Il denominatore
può anche essere un numero intero letterale, nel qual caso viene applicato in modo forzato
il denominatore. Il formato numerico 0 #/8
mostra il numero 23,25 come 23 2/8. La parte della frazione non è
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 un formato con punto decimale
al suo interno. |
* |
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. che viene utilizzato per allineare formati numerici in cui il valore negativo è racchiuso tra parentesi. |
\ |
Tratta il carattere successivo come valore letterale e non come valore speciale
significato 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. No compatibile con gli altri caratteri speciali e non viene visualizzata valori numerici (visualizzati in formato generale). |
$ - + ( ) : space |
Fogli tratta questi caratteri come valori letterali e li visualizza senza modifiche. |
Metadati
Inoltre, ogni sezione del formato può avere meta-istruzioni facoltative,
racchiusi tra [] caratteri, che precedono il formato e forniscono
istruzioni aggiuntive. Esistono due tipi di meta-istruzione e un dato
possono utilizzare entrambi:
| Istruzione | Descrizione |
|---|---|
[condition] |
Sostituisce il confronto predefinito positivo, negativo o zero del
con un'altra espressione condizionale. Ad esempio:
[<100]”Low”;[>1000]”High”;000 esegue il rendering della parola
"Basso" per i valori inferiori a 100, "Alto" per i valori superiori a 1000 e un valore di tre cifre
numero (con 0 iniziali) per qualsiasi intervallo intermedio. Le condizioni possono essere
applicata ai primi due sottoformati e, se un numero corrisponde a più di uno,
utilizza il primo che corrisponde. Se esiste un terzo formato,
utilizzato per "tutto il resto", altrimenti se un numero non corrisponde
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#] |
Fa sì che qualsiasi valore visualizzato da questo sottoformato venga visualizzato con un determinato colore del testo. I valori validi per Color sono nero, Blu, Ciano, Verde, Magenta, rosso, Bianco o giallo. Valori validi per "#" in Color# sono 0–56 (questo tavolozza dei colori mostra un elenco dei colori che corrispondono a ciascun numero). Formato numerico i colori sostituiscono qualsiasi colore inserito dall'utente nella cella, ma sostituire i colori impostati dalla formattazione condizionale. |
Esempi di formati numerici
La tabella seguente mostra alcuni pattern di esempio e le relative corrispondenze rendering di numeri formattati:
| 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 TESTO: MyText |
| 1234 -1234 0 MyText |
[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) |
1234 1.234 0,0 MyText |
| 1005 32 527 |
[>1000]"HIGH";[Color43][<=200]"LOW";0000 |
ELEVATO BASSO 0527 |