Formats de date et de nombre

Les formats de date, d'heure et de nombre vous permettent de contrôler la façon dont vos données s'affichent dans une feuille. Google Sheets propose des formats courants, mais vous pouvez également définir vos propres formats.

Dans l'interface utilisateur de Sheets, vous appliquez des formats numériques et de date aux cellules à l'aide du menu Format > Nombre. Dans l'API Sheets, vous définissez ces formats à l'aide d'un appel de méthode spreadsheets.batchUpdate pour envoyer un élément UpdateCellsRequest ou RepeatCellRequest.

Cette page explique comment définir de nouveaux modèles de date et de format numérique que vous pouvez inclure dans votre requête API. L'exemple Définir un format décimal ou date/heure personnalisé pour une plage montre comment définir un modèle de format à l'aide de l'API. Notez que le rendu réel du format dépend du locale de la feuille de calcul. Ce guide suppose que la valeur de locale est en_US. Vous pouvez déterminer l'élément locale d'une feuille de calcul en lisant le SpreadsheetProperties à l'aide d'une requête spreadsheets.get.

À propos des valeurs de date et d'heure

Comme la plupart des autres applications de feuilles de calcul, Sheets traite les valeurs de date et d'heure comme des valeurs décimales. Cela vous permet d'effectuer des opérations arithmétiques dans des formules, ce qui vous permet d'incrémenter des jours ou des semaines, d'ajouter ou de soustraire deux dates et heures, et d'effectuer d'autres opérations similaires.

Sheets utilise une forme de date d'epoch couramment utilisée dans les feuilles de calcul. La partie correspondant au nombre entier de la valeur (à gauche de la virgule) comptabilise les jours écoulés depuis le 30 décembre 1899. La partie fractionnaire (à droite de la décimale) comptabilise le temps sous la forme d'une fraction d'un jour. Par exemple, le 1er janvier 1900 à midi est 2.5, 2, car c'est deux jours après le 30 décembre 1899, et 0.5, car midi correspond à une demi-journée. Le 1er février 1900 à 15h est 33.625.

Sheets traite correctement l'année 1900 comme une année commune, et non comme une année bissextile.

Modèles de format de date et d'heure

Un modèle de format date-heure est une chaîne de sous-chaînes de jeton qui, lors de l'analyse, sont remplacées par les éléments de date et d'heure correspondants (tels que le mois ou l'heure).

Jetons de format de date et d'heure

Le tableau suivant définit les sous-chaînes de jeton que vous pouvez utiliser dans un modèle au format date-heure. Un caractère + indique que le caractère précédent peut apparaître une ou plusieurs fois et correspondre toujours au modèle. Les caractères qui ne figurent pas dans le tableau ci-dessous sont traités comme des littéraux et sont générés sans modification.

Jeton	Description
h	Heure de la journée. Passe du format 12 au format 24 heures selon que la chaîne comporte un indicateur AM ou PM.
hh+	Identique au précédent, mais avec un zéro devant entre 1 et 9.
m	Si le jeton non littéral précédent était en heures ou si le jeton suivant était en secondes, il représente les minutes dans l'heure (sans un 0 de début). Dans le cas contraire, le mois est représenté sous la forme d'un nombre (sans zéro devant).
M	Mois de l'année, sans zéro devant. Utilisez ce jeton pour indiquer expressément un mois, et non une minute, dans votre modèle.
mm	Identique à m, mais avec un zéro devant dans les deux cas.
MM	Mois de l'année, précédé d'un 0 Utilisez ce jeton pour indiquer expressément un mois, et non une minute, dans votre modèle.
mmm	Abréviation de trois lettres correspondant au mois (par exemple, "février").
mmmm	Nom complet du mois. mmmmmm+ correspond également à cette valeur.
mmmmm	Première lettre du mois (par exemple, "J" pour juin).
s	Secondes dans la minute, sans zéro devant.
ss	Secondes dans la minute, précédées d'un 0.
[h+]	Nombre d'heures écoulées dans une durée. Le nombre de lettres indique un nombre minimal de chiffres (les zéros sont ajoutés au début).
[m+]	Nombre de minutes écoulées dans une durée. Le nombre de lettres indique un nombre minimal de chiffres (les zéros sont ajoutés au début).
[s+]	Nombre de secondes écoulées dans une durée. Le nombre de lettres indique un nombre minimal de chiffres (les zéros sont ajoutés au début).
d	Jour du mois, sans le préfixe 0 pour les nombres inférieurs à 10.
dd	Jour du mois, commençant par 0 si les nombres sont inférieurs à 10.
ddd	Jour de la semaine, abréviation de trois lettres (par exemple, "Lun").
dddd+	Jour de la semaine (nom complet).
y	Année (2 chiffres)
yy
yyy	Année (4 chiffres)
yyyy+
a/p	Affiche "a" pour le matin et "p" pour l'après-midi. Modifie également les heures au format 12 heures. Si la lettre du jeton est en majuscule, le résultat l'est également.
am/pm	Comme ci-dessus, mais affiche "AM" ou "PM" à la place, et commence toujours par une majuscule.
0	Les dixièmes de secondes Vous pouvez augmenter la précision à deux chiffres avec 00 ou trois chiffres (en millisecondes) avec 000.
\	Traite le caractère suivant comme une valeur littérale et non comme une signification particulière qu'il pourrait avoir.
"text"	Affiche le texte entre guillemets sous forme de littéral.

Exemples de format de date et d'heure

Compte tenu de la date et de l'heure Tuesday, April 5, 2016, 4:08:53.528 PM, le tableau suivant présente quelques exemples de modèles et le rendu date-heure correspondant. La deuxième section du tableau présente des exemples de formats pour un temps écoulé de 3 hours, 13 minutes, 41.255 seconds:

Modèles de date et d'heure	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 avril [mardi]
h PM, ddd mmm dd	16:00, mar. 05 avr.
dddd, m/d/yy at h:mm	Mardi 05/04/16 à 16:08
Schémas de temps écoulé	3 hours, 13 minutes, 41.255 seconds
[hh]:[mm]:[ss].000	03:13:41.255
[mmmm]:[ss].000	0193:41,255

Modèles de format numérique

Un modèle de format numérique est une chaîne de sous-chaînes de jeton qui, lors de l'analyse, sont remplacées par les représentations numériques correspondantes. Un modèle de format numérique peut comporter jusqu'à quatre sections, séparées par un point-virgule, qui définissent les formats distincts utilisés pour les nombres positifs, les nombres négatifs, le zéro et le texte (dans cet ordre):

[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]

Vous n'avez pas besoin d'inclure les quatre sections dans un format. Si vous n'incluez qu'une seule section, ce format est utilisé pour toutes les valeurs. Si vous utilisez deux sections, le premier format est appliqué aux nombres zéros et positifs, et le second format aux nombres négatifs. L'utilisation de trois sections permet de définir des formats distincts pour les nombres positifs, négatifs et nuls. Exemple :

[NUMBER FORMAT]
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT]
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]

Toutefois, s'il y a au moins deux sections et que la dernière section est au format texte, elle est traitée comme le format texte. Les autres se comportent comme s'il y avait une section de moins. Ainsi, en incluant un format de texte final, il est possible de définir des formats tels que:

[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT]
[NUMBER FORMAT];[TEXT FORMAT]

L'analyse d'un format en sections se produit avant d'autres analyses. Il est donc possible d'inclure un format de date ou d'heure dans l'une des sections (bien que cela soit d'une utilité limitée).

Jetons de format numérique

Le tableau suivant définit les sous-chaînes de jeton que vous pouvez utiliser dans une section de format pour définir comment représenter les valeurs de cette section.

Jeton	Description
0	Représente un chiffre dans un nombre. Si le chiffre est un 0 non significatif, il est rendu par 0. Par exemple, le format numérique 00.0 affiche le nombre 3 sous la forme 03.0.
#	Représente un chiffre dans un nombre. Si le chiffre est un 0 non significatif, il n'est pas affiché. Par exemple, le format numérique ##0 affiche le nombre 12 sous la forme 12.
?	Représente un chiffre dans un nombre. Si le chiffre est un 0 non significatif, il est rendu sous forme d'espace. Il est souvent utilisé pour aligner le séparateur décimal dans une colonne lorsque vous utilisez des polices à largeur fixe. Par exemple, le format numérique ???.??? affiche le nombre 12,4 sous la forme suivante : " 12.4 ".
.	Le premier point représente le séparateur décimal dans le nombre. Les périodes suivantes sont affichées sous forme de littéraux. Si vous incluez un point décimal dans le format, il est toujours affiché, même pour les nombres entiers. Par exemple, #0.# affiche le nombre 3 sous la forme 3..
%	Apparaît sous forme de littéral, mais entraîne également la multiplication par 100 des nombres existants avant d'être affichés afin de rendre les pourcentages plus lisibles. Par exemple, le format numérique #% affiche le nombre 0,25 sous la forme "25%".
,	S'il apparaît entre des caractères à deux chiffres (0, # ou ?), il affiche le nombre entier avec des séparateurs de regroupement (par milliers). S'il suit les chiffres, il les met à l'échelle par millier par virgule (par exemple, le format #0.0,, affiche le nombre 12 200 000 sous la forme 12.2).
E-	Affiche le nombre au format scientifique, avec le formatage à gauche de E utilisé pour la partie sans exposant et le formatage à droite du E à la partie exposant. E+ affiche un signe + pour les exposants positifs. E- n'affiche que le signe des exposants négatifs. Si vous utilisez des minuscules, la sortie e est également en minuscules. Par exemple, le format numérique ##0.00#E+## affiche le nombre 0,0000001 sous la forme "100.00E-9".
E+
e-
e+
/	S'il apparaît entre des caractères à deux chiffres (0, # ou ?), il traite ces groupes de chiffres comme un format fractionnaire. Par exemple, le format numérique 0 #/# affiche le nombre 23,25 sous la forme 23 1/4. Le dénominateur peut également être un entier littéral, auquel cas il applique cet entier comme dénominateur. Le format numérique 0 #/8 affiche le nombre 23,25 sous la forme 23 2/8. La partie "fraction" n'est pas affichée si le numérateur est égal à 0. Le nombre 23,1 au format 0 #/3 s'affiche comme suit : 23 (car 0,1 est arrondi à 0/3). / n'est pas compatible avec le format scientifique ni avec les formats comportant un point décimal.
*	Cet élément est inclus pour assurer la compatibilité avec les formats numériques Microsoft Excel. Il est actuellement ignoré.
_	Le jeton de trait de soulignement ignore le caractère suivant et affiche un espace. Cela permet d'aligner les formats numériques dans lesquels la valeur négative est entourée de parenthèses.
\	Traite le caractère suivant comme une valeur littérale et non comme une signification particulière qu'il pourrait avoir. Par exemple, le format numérique \#0 affiche le nombre 10 sous la forme "#10".
"text"	Affiche le texte entre guillemets sous forme de littéral.
@	Si la cellule comporte une entrée de texte, elle insère le texte brut de la cellule. Non compatible avec les autres caractères spéciaux et ne s'affiche pas pour les valeurs numériques (qui sont affichées au format général).
$ - + ( ) : space	Sheets traite ces caractères comme des littéraux et les affiche tels quels.

Instructions Meta

En outre, chacune des sections de mise en forme peut comporter des méta-instructions facultatives, comprises entre [] et qui précèdent le format et fournissent des instructions supplémentaires. Il existe deux types de méta-instructions, et une section donnée peut utiliser les deux:

Enseignement	Description
[condition]	Remplace la comparaison positive, négative ou nulle par défaut de la section par une autre expression conditionnelle. Par exemple, [<100]”Low”;[>1000]”High”;000 affiche le mot "Faible" pour les valeurs inférieures à 100, "Élevé" pour les valeurs supérieures à 1 000 et un nombre à trois chiffres (avec des zéros au début) pour toute valeur comprise entre les deux. Les conditions ne peuvent être appliquées qu'aux deux premiers sous-formats. Si un nombre correspond à plusieurs sous-formats, il utilise le premier correspondant. S'il existe un troisième format, il est utilisé pour "tout le reste". Sinon, si un nombre ne correspond à aucun format, il est affiché comme tous les "#" remplissant la largeur de la cellule. S'il existe, le quatrième format est toujours utilisé pour le texte.
[Color] or [Color#]	Entraîne l'affichage de toute valeur affichée par ce sous-format avec la couleur de texte indiquée. Les valeurs valides pour Color sont noir, bleu, cyan, vert, magenta, rouge, blanc ou jaune. Les valeurs valides pour le "#" dans Color# sont 0&ndash1;56 (cette palette de couleurs affiche une liste des couleurs correspondant à chaque nombre). Les couleurs du format numérique remplacent les couleurs saisies par l'utilisateur dans la cellule, mais ne remplacent pas les couleurs définies par la mise en forme conditionnelle.

Exemples de format numérique

Le tableau suivant présente quelques exemples de formats et le rendu numérique mis en forme correspondant:

Nombre	Schéma	Valeur mise en forme
12345.125	####.#	12345.1
12.34	000.0000	012.3400
12	#.0#	12.0
5.125	# ???/???	5 1/8
12 000	#,###	12 000
1230000	0.0,,"M"	1,2 M
1234500000	0.00e+00	1,23E+09
123114.15115 MonTexte	###0.000;"TEXT: "_(@_)	123114.151 TEXTE: MonTexte
1234 -1234 0 MonTexte	[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_)	1,234 1,234 0,0 MyText
1005 32 527	[>1000]"HIGH";[Color43][<=200]"LOW";0000	ÉLEVÉE FAIBLE 0527