Les formats de date-heure et de nombre vous permettent de contrôler comment vos données s'affichent dans une feuille. Google Sheets propose des formats courants parmi lesquels choisir, mais vous pouvez également définir vos propres formats.
Dans l'interface utilisateur de Sheets, vous appliquez des formats de nombre 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 un RepeatCellRequest.
Cette page explique comment définir de nouveaux formats de date et de nombre, que vous pouvez inclure dans votre requête API. L'exemple Définir un format de date et heure ou décimal personnalisé pour une plage montre comment définir un format à l'aide de l'API. Notez que le rendu réel du format dépend de l'locale de la feuille de calcul. Ce guide suppose que locale est en_US. Vous pouvez déterminer le 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 feuilles de calcul, traite les valeurs de date et d'heure comme des valeurs décimales. Vous pouvez ainsi effectuer des calculs arithmétiques sur ces valeurs 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'époque couramment utilisée dans les feuilles de calcul. La partie entière de la valeur (à gauche du point décimal) compte les jours écoulés depuis le 30 décembre 1899. La partie fractionnaire (à droite de la virgule) comptabilise le temps en fraction d'une journée. Par exemple, le 1er janvier 1900 à midi correspond à 2.5, 2, car il s'agit de 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 correspond à 33.625.
Sheets traite correctement l'année 1900 comme une année commune, et non comme une année bissextile.
Motifs de format de date et d'heure
Un format de date et d'heure est une chaîne de sous-chaînes de jetons 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 jetons que vous pouvez utiliser dans un format de 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 affichés sans modification.
| Jeton | Description |
|---|---|
h |
Heure de la journée. Bascule entre le format 12 heures et le format 24 heures selon qu'un indicateur AM ou PM est présent dans la chaîne. |
hh+ |
Identique à la précédente, mais avec un zéro au début pour les valeurs de 1 à 9. |
m |
Si le jeton non littéral précédent était des heures ou que le suivant est des secondes, il représente les minutes de l'heure (sans zéro initial). Sinon, il représente le mois de l'année sous la forme d'un nombre (sans zéro initial). |
M |
Mois de l'année sans zéro initial. Utilisez ce jeton pour indiquer explicitement un mois, au lieu d'une minute, dans votre modèle. |
mm |
Identique à m, mais avec un 0 au début dans les deux cas. |
MM |
Mois de l'année avec un zéro devant. Utilisez ce jeton pour indiquer explicitement un mois, au lieu d'une minute, dans votre modèle. |
mmm |
Abréviation de trois lettres correspondant à un mois (par exemple, "Feb") |
mmmm |
Nom complet du mois. mmmmmm+ correspond également à ce schéma. |
mmmmm |
Première lettre du mois (par exemple, "J" pour juin). |
s |
Secondes de la minute sans zéro devant. |
ss |
Secondes de la minute, avec un zéro devant. |
[h+] |
Nombre d'heures écoulées au cours d'une période. Le nombre de lettres indique le nombre minimal de chiffres (ajoute les zéros au début). |
[m+] |
Nombre de minutes écoulées au cours d'une durée. Le nombre de lettres indique le nombre minimal de chiffres (ajoute les zéros au début). |
[s+] |
Nombre de secondes écoulées au cours d'une durée. Le nombre de lettres indique le nombre minimal de chiffres (ajoute les zéros au début). |
d |
Jour du mois, sans zéro initial pour les nombres inférieurs à 10. |
dd |
Jour du mois, avec un zéro devant pour les nombres inférieurs à 10. |
ddd |
Jour de la semaine, abréviation à trois lettres (par exemple, "Mon"). |
dddd+ |
Nom complet du jour de la semaine. |
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. Les heures sont également converties au format 12 heures. Si la lettre du jeton est en majuscules, la sortie l'est également. |
am/pm |
Comme ci-dessus, mais affiche "AM" ou "PM" à la place et est toujours en majuscules. |
0 |
Dixièmes de seconde. 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 spéciale qu'il pourrait avoir. |
"text" |
Affiche le texte entre guillemets sous forme de valeur littérale. |
Exemples de formats de date et d'heure
Pour la date et l'heure Tuesday, April 5, 2016, 4:08:53.528 PM, le tableau suivant présente des exemples de formats et leur rendu de date et d'heure correspondants. 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 d'heure | Tuesday, April 5, 2016, 4:08:53.528 PM |
|---|---|
h:mm:ss.00 a/p |
4: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 |
16h, Mar. 05 avr. |
dddd, m/d/yy at h:mm |
Mardi 5 avril 2016 à 16h08 |
| Modèles 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 de nombre est une chaîne de sous-chaînes de jetons 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 des points-virgules, qui définissent les formats distincts utilisés pour les nombres positifs, les nombres négatifs, 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 nuls et positifs, et le second 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, si vous avez au moins deux sections et que la dernière est un format de texte, cette section est traitée comme le 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, vous pouvez 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).
Jetons de format numérique
Le tableau suivant définit les sous-chaînes de jetons que vous pouvez utiliser dans une section de format pour définir la manière de 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 affiché sous la forme 0. Par exemple, le format de nombre 00.0 affiche le nombre 3 sous la forme "03.0". |
# |
Représente un chiffre du 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 du nombre. Si le chiffre est un 0 non significatif, il est affiché sous forme d'espace. Cette option est souvent utilisée pour aligner le point décimal d'une colonne lorsque vous utilisez des polices à largeur fixe. Par exemple, le format de nombre ???.??? affiche le nombre 12,4 comme suit : "12.4 ". |
. |
La première virgule représente la virgule décimale du 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.". |
% |
S'affiche comme une valeur littérale, mais multiplie également les nombres existants par 100 avant de les afficher pour 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 l'intégralité du nombre avec des séparateurs de regroupement (regroupement par milliers). S'il suit les caractères numériques, il multiplie les chiffres par mille 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 la mise en forme à gauche de E utilisée pour la partie non exponentielle et la mise en forme à droite de E utilisée pour la partie exponentielle. E+ affiche un signe + pour les exposants positifs. E- n'affiche un signe que pour les exposants négatifs. Si des minuscules sont utilisées, 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 fractionnaire n'est pas affichée si le numérateur devient 0. Le nombre 23,1 avec le format de nombre 0 #/3 s'affiche simplement sous la forme 23 (car 0,1 est arrondi à 0/3). / n'est pas compatible avec le format scientifique ni avec un format contenant un séparateur décimal. |
* |
Cette option est incluse pour assurer la compatibilité avec les formats de nombres Microsoft Excel. Il est actuellement ignoré. |
_ |
Le jeton souligné ignore le caractère suivant et affiche un espace. Il permet d'aligner les formats numériques lorsque 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 spéciale 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 valeur littérale. |
@ |
Si la cellule contient du texte, le texte brut est inséré. Il n'est pas compatible avec les autres caractères spéciaux et ne s'affiche pas pour les valeurs numériques (qui s'affichent au format général). |
$ - + ( ) : space |
Sheets considère ces caractères comme des littéraux et les affiche sans modification. |
Instructions Meta
De plus, chacune des sections de format peut comporter des méta-instructions facultatives, entourées de caractères [], qui précèdent le format et fournissent des instructions supplémentaires. Il existe deux types d'instructions méta, 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 "Bas" 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 les valeurs intermédiaires. Les conditions ne peuvent être appliquées qu'aux deux premiers sous-formats. Si un numéro correspond à plusieurs, il utilise le premier. Si un troisième format existe, il est utilisé pour "tout le reste". Sinon, si un nombre ne correspond à aucun des formats, il est affiché avec des "#" remplissant la largeur de la cellule. Le quatrième format est toujours utilisé pour le texte, le cas échéant. |
[Color] or [Color#] |
Fait en sorte que toute valeur affichée par ce sous-format s'affiche avec la couleur de texte donnée. Les valeurs valides pour Color sont Black, Blue, Cyan, Green, Magenta, Red, White ou Yellow. Les valeurs valides pour le "#" dans Color# sont comprises entre 1 et 56 (cette palette de couleurs affiche la liste des couleurs correspondant à chaque numéro). Les couleurs du format de nombre remplacent toutes les couleurs saisies par l'utilisateur dans la cellule, mais pas les couleurs définies par la mise en forme conditionnelle. |
Exemples de formats numériques
Le tableau suivant présente des exemples de formats et le rendu correspondant:
| Nombre | Modèle | 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 TEXT: MyText |
| 1234 -1234 0 Mon texte |
[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 BASSE 0527 |