Les formats de date et d'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 la 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
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 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 de la virgule) correspond au nombre de jours écoulés depuis le 30 décembre 1899. La partie fractionnaire (à droite de la virgule) compte le temps comme une 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 à 15h00 correspond à 33.625.
Sheets traite correctement l'année 1900 comme une année normale, 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, une fois analysées, sont remplacées par les éléments de date et d'heure correspondants (comme 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 de date et d'heure. Un caractère + indique que le caractère précédent peut apparaître une ou plusieurs fois et 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 affiché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 à la précédente, mais avec un zéro en tête pour les nombres de 1 à 9. |
m |
Si le jeton non littéral précédent était "heures" ou si le jeton suivant est "secondes", il représente les minutes de l'heure (sans zéro non significatif). Sinon, il représente le mois de l'année sous forme de nombre (sans zéro initial). |
M |
Mois de l'année sans zéro initial. Utilisez ce jeton pour indiquer explicitement un mois, et non une minute, dans votre modèle. |
mm |
Identique à m, mais avec un zéro en tête dans les deux cas. |
MM |
Mois de l'année avec un zéro devant. Utilisez ce jeton pour indiquer explicitement un mois, et non une minute, dans votre modèle. |
mmm |
Abréviation du mois sur trois lettres (par exemple, "Feb"). |
mmmm |
Nom complet du mois. mmmmmm+ 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 zéro devant. |
[h+] |
Nombre d'heures écoulées dans une durée. Le nombre de lettres indique le nombre minimal de chiffres (ajoute des zéros non significatifs). |
[m+] |
Nombre de minutes écoulées dans une durée. Le nombre de lettres indique le nombre minimal de chiffres (ajoute des zéros non significatifs). |
[s+] |
Nombre de secondes écoulées dans une durée. Le nombre de lettres indique le nombre minimal de chiffres (ajoute des zéros non significatifs). |
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, "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. 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 "AM" ou "PM" à la place et est toujours en majuscules. |
0 |
Dixième 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 un caractère spécial. |
"text" |
Affiche le texte entre guillemets comme un littéral. |
Exemples de formats de date et d'heure
Étant donné la date et l'heure Tuesday, April 5, 2016, 4:08:53.528 PM, le tableau suivant présente quelques exemples de formats et le rendu de date et heure correspondant. La deuxième section du tableau présente des exemples de formats de temps écoulé pour une durée de 3 hours, 13 minutes, 41.255 seconds :
| Formats 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." |
16h08 |
yyyy-mm-dd |
2016-04-05 |
mmmm d \[dddd\] |
5 avril [mardi] |
h PM, ddd mmm dd |
16h, mar. 5 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 schéma de format numérique est une chaîne de sous-chaînes de jetons qui, une fois analysées, sont remplacées par les représentations numériques correspondantes. Un format de nombre 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 positifs et à zéro, 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, s'il y a au moins deux sections et que la dernière est au format texte, cette section est traitée comme du 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 comme 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 façon dont les valeurs de cette section doivent être représentées.
| 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 numérique 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 la virgule dans une colonne lorsque vous utilisez des polices à chasse fixe. Par exemple, le format numérique ???.??? affiche le nombre 12,4 comme suit : " 12.4 ". |
. |
Le premier point représente la virgule décimale du nombre. Les périodes suivantes sont affichées 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 nombre 3 sous la forme "3.". |
% |
Apparaît sous forme de littéral, mais multiplie également les nombres existants par 100 avant d'être affiché 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 le nombre entier avec des séparateurs de regroupement (regroupement par milliers). S'il suit les caractères numériques, il met à l'échelle 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 du E utilisé pour la partie non exponentielle et la mise en forme à droite du E utilisé 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 deux caractères numériques (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 est appliqué en tant que 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 nul. Le nombre 23,1 avec le format numérique 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 nombre Microsoft Excel. Il est actuellement ignoré. |
_ |
Le jeton de soulignement ignore le caractère suivant et affiche un espace. Cette option permet d'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 un caractère spécial. Par exemple, le format numérique \#0 affiche le nombre 10 sous la forme "#10". |
"text" |
Affiche le texte entre guillemets comme un littéral. |
@ |
Si la cellule contient du texte saisi, le texte brut de la cellule 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 sont affichées au format général). |
$ - + ( ) : space |
Sheets traite ces caractères comme des littéraux et les affiche sans les modifier. |
Méta-instructions
De plus, chacune des sections de format peut comporter des méta-instructions facultatives, placées entre des caractères [], 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 :
| Instruction | Description |
|---|---|
[condition] |
Remplace la comparaison par défaut (positive, négative ou nulle) 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 non significatifs) pour les valeurs intermédiaires. Les conditions ne peuvent être appliquées qu'aux deux premiers sous-formats. Si un nombre correspond à plusieurs conditions, la première à laquelle il correspond est utilisée. S'il existe un troisième format, il est utilisé pour "tout le reste". Sinon, si un nombre ne correspond à aucun des deux formats, il est affiché avec des "#" qui remplissent la largeur de la cellule. S'il existe, le quatrième format est toujours utilisé pour le texte. |
[Color] or [Color#] |
Permet d'afficher toute valeur rendue par ce sous-format avec la couleur de texte indiquée. Les valeurs valides pour Color sont "Black" (Noir), "Blue" (Bleu), "Cyan" (Cyan), "Green" (Vert), "Magenta" (Magenta), "Red" (Rouge), "White" (Blanc) ou "Yellow" (Jaune). Les valeurs valides pour "#" dans Color# sont comprises entre 1 et 56 (cette palette de couleurs affiche la liste des couleurs correspondant à chaque nombre). Les couleurs du format numérique remplacent toutes les couleurs saisies par l'utilisateur dans la cellule, mais pas celles définies par la mise en forme conditionnelle. |
Exemples de formats numériques
Le tableau suivant présente quelques exemples de formats et le rendu du nombre 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.23e+09 |
| 123114.15115 MyText |
###0.000;"TEXT: "_(@_) |
123114.151 TEXT: MyText |
| 1234 -1234 0 MyText |
[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 |