Formats de date et de nombre

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

Dans l'interface utilisateur de Sheets, vous pouvez appliquer 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 UpdateCellsRequest ou RepeatCellRequest.

Cette page explique comment définir de nouveaux modèles de format de date et de nombre, que vous pouvez inclure dans votre requête API. L'exemple Définir un format de date et d'heure personnalisé ou un format décimal 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 locale est défini sur en_US. Vous pouvez déterminer la locale d'une feuille de calcul en lisant le SpreadsheetProperties avec une requête spreadsheets.get.

À propos des valeurs de date et d'heure

Sheets, comme la plupart des autres applications de tableur, traite les valeurs de date et d'heure comme des valeurs décimales. Cela vous permet d'effectuer des opérations arithmétiques sur celles-ci dans des formules. Vous pouvez ainsi incrémenter des jours ou des semaines, ajouter ou soustraire deux dates et heures, et effectuer d'autres opérations similaires.

Sheets utilise une forme de date d'epoch couramment utilisée dans les feuilles de calcul. La partie nombre entier de la valeur (à gauche de la décimale) compte les jours écoulés depuis le 30 décembre 1899. La partie fractionnaire (à droite de la décimale) compte le temps comme une fraction d'un jour. Par exemple, le 1er janvier 1900 à midi correspond à 2.5, 2, car il est 2 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 considère 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 jetons qui, lorsqu'elles sont analysées, sont remplacées par les éléments date-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 jetons que vous pouvez utiliser dans un modèle de format date-heure. Un caractère + indique que le caractère précédent peut apparaître une ou plusieurs fois et qu'il correspond 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 heures au format 24 heures selon qu'un indicateur AM ou PM est présent dans la chaîne.
hh+	Identique au précédent, mais avec un zéro pour commencer le 1-9.
m	Si le jeton non littéral précédent était des heures ou que le suivant est en secondes, il représente des minutes dans l'heure (sans zéro 0 au début). Sinon, elle représente le mois de l'année sous forme de nombre (sans zéro au début).
M	Mois de l'année, sans zéro avant. Utilisez ce jeton pour indiquer expressément un mois, au lieu d'une minute, dans votre schéma.
mm	Identique à m, mais précédé d'un 0 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, au lieu d'une minute, dans votre schéma.
mmm	Abréviation du mois à trois lettres (par exemple, "fév").
mmmm	Nom complet du mois mmmmmm+ y correspond également.
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, avec un 0 devant.
[h+]	Nombre d'heures écoulées dans une durée. Le champ "Nombre de lettres" indique le nombre minimal de chiffres (en ajoutant les 0 au début).
[m+]	Nombre de minutes écoulées dans une durée. Le champ "Nombre de lettres" indique le nombre minimal de chiffres (en ajoutant les 0 au début).
[s+]	Nombre de secondes écoulées dans une durée. Le champ "Nombre de lettres" indique le nombre minimal de chiffres (en ajoutant les 0 au début).
d	Jour du mois, sans zéro initial pour les nombres inférieurs à 10.
dd	Jour du mois, avec un "0" initial pour les nombres inférieurs à 10.
ddd	Jour de la semaine, abréviation en trois lettres (par exemple, "Mon").
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. Passe également les heures au format 12 heures. Si la lettre du jeton est en majuscules, la sortie l'est aussi.
am/pm	Comme ci-dessus, mais affiche "AM" ou "PM", toujours en majuscules.
0	Dixièmes de secondes. Vous pouvez augmenter la précision à deux chiffres avec 00 ou à trois chiffres (millisecondes) avec 000.
\	Traite le caractère suivant comme une valeur littérale et non comme une signification particulière.
"text"	Affiche le texte situé entre guillemets en tant que littéral.

Exemples de formats 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 leur rendu date-heure correspondant. La deuxième section du tableau présente des exemples de formats de temps écoulé pour un temps écoulé de 3 hours, 13 minutes, 41.255 seconds:

Modèles de date et 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. 5 avr.
dddd, m/d/yy at h:mm	Mardi 05/04/16 à 16h08
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 jetons qui, lorsqu'elles sont analysées, 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 des points-virgules, définissant 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. L'utilisation de deux sections entraîne l'application du premier format aux nombres zéro et positif, et le second format aux nombres négatifs. L'utilisation de trois sections définit 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 deux sections ou plus et que la dernière section est au format texte, elle est traitée comme un format de texte et 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 toute autre analyse. 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).

Format numérique des jetons

Le tableau suivant définit les sous-chaînes de jetons 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 du nombre. Si le chiffre est un 0 non significatif, il est restitué sous la forme 0. Par exemple, le format numérique 00.0 affiche le chiffre 3 sous la forme "03.0".
#	Représente un chiffre du nombre. Si le chiffre correspond à 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 du nombre. Si le chiffre est un 0 non significatif, il est affiché sous forme d'espace. Elle est souvent utilisée pour aligner le point décimal dans une colonne lors de l'utilisation de 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 du nombre. Les points suivants sont affichés sous forme de littéraux. Si vous incluez un séparateur décimal dans le format, il est toujours affiché, même pour les nombres entiers. Par exemple, #0.# affiche le chiffre 3 sous la forme "3.".
%	S'affiche sous la forme d'un littéral, mais entraîne également le fait que les nombres existants sont multipliés par 100 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 ?), le nombre entier est affiché avec des séparateurs de regroupement (regroupement par milliers). S'il suit les caractères numériques, il met à l'échelle les chiffres de 1 000 par virgule (par exemple, le format #0.0,, restitue le nombre 12 200 000 à 12.2).
E-	Affiche le nombre dans un format scientifique, avec la mise en forme à gauche de la valeur E utilisée pour la partie non exposant et la mise en forme à droite du E utilisé pour la partie exposant. E+ affiche un signe + pour les exposants positifs. E- n'affiche un signe que pour les exposants négatifs. Si vous utilisez des minuscules, la sortie e l'est également. 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 au format 23 2/8. La partie fraction n'est pas affichée si le numérateur devient 0. Le nombre 23,1 au format numérique 0 #/3 s'affiche sous la forme 23 uniquement (parce que 0,1 est arrondi à 0/3). / n'est pas compatible avec le format scientifique ni avec un format comportant un point décimal.
*	Elle est incluse pour assurer la compatibilité avec les formats numériques Microsoft Excel. Il est actuellement ignoré.
_	Le trait de soulignement ignore le caractère suivant et affiche un espace. Ceci est utilisé pour aligner les formats numériques où 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. Par exemple, le format numérique \#0 affiche le nombre 10 sous la forme "#10".
"text"	Affiche le texte situé entre guillemets en tant que littéral.
@	Si la cellule contient du texte, le texte brut de la cellule est inséré. Elle n'est pas compatible avec les autres caractères spéciaux et ne s'affiche pas pour les valeurs numériques (qui sont affichées sous forme de 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 format peut contenir des méta-instructions facultatives, délimitées par des caractères [], qui précèdent le format et fournissent des instructions supplémentaires. Il existe deux types d'instructions Meta, et une section donnée peut utiliser les deux:

Instruction	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 toutes les valeurs intermédiaires. Les conditions ne peuvent être appliquées qu'aux deux premiers sous-formats. Si un nombre correspond à plusieurs sous-formats, il utilise le premier auquel il correspond. S'il existe un troisième format, il est utilisé pour "tout le reste". Sinon, si un nombre ne correspond à aucun des formats, il est affiché sous la forme d'un symbole # qui remplit 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 donnée. Les valeurs valides pour Color sont le noir, le bleu, le cyan, le vert, le magenta, le rouge, le blanc ou le jaune. Les valeurs valides pour le signe "#" dans Color# sont 0 à 56 (cette palette de couleurs affiche une liste des couleurs qui correspondent à 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 schémas et le rendu des nombres mis en forme correspondant:

Nombre	Schéma	Valeur formatée
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,23 e + 09
123114.15115 MonTexte	###0.000;"TEXT: "_(@_)	123114.151 TEXTE: MyText
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É FAIBLE 0527