Formati di data e numero

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ì, 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 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 punto 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