Les formats de date, d'heure et de nombre vous permettent de contrôler l'affichage de vos données dans une feuille de calcul. Google Sheets propose certains 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 une date/heure personnalisée 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 l'élément locale d'une feuille de calcul en lisant le SpreadsheetProperties avec une requête spreadsheets.get.
À propos des valeurs de date et d'heure
Comme la plupart des autres applications de feuille 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, afin 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 entière 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) comptabilise le temps par fraction d'un jour. Par exemple, le 1er janvier 1900 à midi est 2.5, 2, car deux jours se sont écoulés après le 30 décembre 1899, et 0.5, car midi dure une demi-journée. Le 1er février 1900 à 15h00 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 de format date-heure. Le caractère + indique que le caractère précédent peut apparaître une ou plusieurs fois et correspondre toujours au schéma. Les caractères non répertoriés 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 contient un indicateur AM ou PM. |
hh+ |
Identique au précédent, mais avec un zéro devant pour les 1 à 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 0 au début). Sinon, il représente le mois de l'année 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 |
Le mois de l'année, avec un zéro devant. Utilisez ce jeton pour indiquer expressément un mois, et non une minute, dans votre modèle. |
mmm |
Abréviation à trois lettres du mois (par exemple, "février"). |
mmmm |
Nom complet du mois. mmmmmm+ correspond aussi à ce résultat. |
mmmmm |
Première lettre du mois (par exemple, "J" pour juin). |
s |
Nombre de secondes dans la minute, sans zéro devant. |
ss |
Secondes de la minute, précédées d'un 0. |
[h+] |
Nombre d'heures écoulées dans une durée. Le nombre de lettres indique le nombre minimal de chiffres (en ajoutant les zéros au début). |
[m+] |
Nombre de minutes écoulées dans une durée. Le nombre de lettres indique le nombre minimal de chiffres (en ajoutant les zéros au début). |
[s+] |
Nombre de secondes écoulées dans une durée. Le nombre de lettres indique le nombre minimal de chiffres (en ajoutant les zéros au début). |
d |
Jour du mois, sans zéro devant pour les nombres inférieurs à 10. |
dd |
Jour du mois, avec un 0 au début pour les nombres 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 (deux chiffres) |
yy |
|
yyy |
Année (4 chiffres) |
yyyy+ |
|
a/p |
Affiche "a" pour le matin et "p" pour l'après-midi. Convertit également les heures au format 12 heures. Si la lettre du jeton est en majuscule, la sortie l'est également. |
am/pm |
Comme ci-dessus, mais affiche toujours "AM" ou "PM" à la place et est toujours en majuscule. |
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 qu'il pourrait avoir. |
"text" |
Affiche le texte entre guillemets sous forme de littéral. |
Exemples de format de date et d'heure
Avec la date et 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 contient des exemples de formats de temps écoulé pour un temps écoulé de 3 hours, 13 minutes, 41.255 seconds:
| Schémas date-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 5/4/16 à 16:08 |
| 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 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 des points-virgules, 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éro et positif, 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 zéros. 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 un format de texte, cette section est traitée comme le format 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 a lieu avant toute autre analyse. Il est donc possible d'inclure un format de date ou d'heure dans l'une des sections (bien que son utilité soit 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 affiché sous la forme d'un 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 affiché sous forme d'espace. Cette valeur est souvent utilisée 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 correspond au séparateur décimal du nombre. Les points suivants sont affichés sous forme de littéraux. Si vous incluez un point décimal dans le format, il sera 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 les nombres existants sont également 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 ?), il affiche le nombre entier avec des séparateurs de regroupement (par milliers). S'il suit les caractères numériques, il met les chiffres à l'échelle de 1 000 par virgule (par exemple, le format #0.0,, affiche le nombre 12 200 000 en 12.2). |
E- |
Affiche le nombre au format scientifique, avec la mise en forme à gauche de E utilisée pour la partie sans exposant et la mise en forme à droite du E utilisé pour la partie exposant. E+ affiche un signe + pour les exposants positifs. E- affiche uniquement un signe 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 sous la forme 23 2/8. La partie de la 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 (car la valeur 0,1 est arrondie à 0/3). / n'est pas compatible avec le format scientifique ni avec un format comportant un séparateur décimal. |
* |
Ceci est inclus pour assurer la compatibilité avec les formats de numéro Microsoft Excel. Il est actuellement ignoré. |
_ |
Le jeton 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 contient du texte, le texte brut est inséré. 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 format peut comporter des méta-instructions facultatives, séparé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:
| 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 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 correspondant. S'il existe un troisième format, il est utilisé pour "tout le reste". Sinon, si un nombre ne correspond à aucun format, il s'affiche comme tous les "#" remplissent 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 rendue par ce sous-format avec la couleur de texte donné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-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 celles 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 du format correspondant:
| Nombre | Schéma | Valeur formatée |
|---|---|---|
| 12 345,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: 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É BAS 0527 |