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 des formats courants parmi lesquels choisir, mais vous pouvez également définissez vos propres formats.
Dans l'interface utilisateur de Sheets, vous pouvez appliquer des formats numériques et de date aux cellules à l'aide des
Format > Menu Nombre. Dans l'API Sheets, vous définissez ces formats à l'aide d'un
spreadsheets.batchUpdate
pour envoyer une
UpdateCellsRequest
ou
RepeatCellRequest
Cette page explique comment définir de nouveaux modèles de format de date et de nombre, que vous
que vous pouvez inclure dans votre requête API. L'exemple
Définir un format de date et d'heure personnalisé ou 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 paramètre locale
de la feuille de calcul. Ce guide part du principe que
locale
est en_US
. Vous pouvez déterminer la locale
d'une feuille de calcul en lisant
la
SpreadsheetProperties
avec un spreadsheets.get
requête.
À propos de la date et valeurs temporelles
Sheets, comme la plupart des autres applications de tableur, traite les valeurs de date et d'heure comme les valeurs décimales. Cela vous permet d’effectuer des opérations arithmétiques sur celles-ci dans les formules, afin que vous puissiez augmenter les jours ou les semaines, ajouter ou soustraire deux dates et heures, et effectuer d'autres des opérations similaires.
Sheets utilise une forme de
epoch date
qui est couramment utilisé
dans les feuilles de calcul. La partie nombre entier de la valeur
(à gauche de la décimale) compte le nombre de jours écoulés depuis le 30 décembre 1899. La fonction
(à droite de la décimale) compte le temps comme une fraction d'un jour. Pour
Exemple : le 1er janvier 1900 à midi correspond à 2.5
, 2
, car c'est deux jours après
Le 30 décembre 1899 et le 0.5
, car midi est une demi-journée. 1er février 1900 à 15 h
est 33.625
.
Sheets considère correctement l'année 1900 comme une année commune, et non comme une année bissextile.
Date et modèles de format 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és par les éléments date-heure correspondants (comme le mois ou heure).
Date et jetons de format d'heure
Le tableau suivant définit les sous-chaînes de jetons que vous pouvez utiliser dans une fonction date-heure
format unique. Le caractère +
indique que le caractère précédent peut apparaître
une ou plusieurs fois et toujours
correspondre au schéma. Les caractères qui ne figurent pas dans le champ
du 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 si 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 en heures ou si le suivant est secondes, elle représente les minutes dans l'heure (sans le 0 au début). Sinon, représente le mois de l'année sous forme de nombre (sans un 0 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. Nombre de lettres indique le nombre minimal de chiffres (ajoute les 0 au début). |
[m+] |
Nombre de minutes écoulées dans une durée. Nombre de lettres indique le nombre minimal de chiffres (ajoute les 0 au début). |
[s+] |
Nombre de secondes écoulées dans une durée. Nombre de lettres indique le nombre minimal de chiffres (ajoute 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 AM et "p" pour l'après-midi. Remplacer également les horaires par Format 12 heures. Si la lettre du jeton est en majuscule, la sortie est . |
am/pm |
Comme ci-dessus, mais avec "AM" ou "PM" et est toujours en majuscule. |
0 |
Dixièmes de secondes. Vous pouvez augmenter la précision à deux chiffres avec
00 , soit trois chiffres (millisecondes) avec 000 . |
\ |
Traite le caractère suivant comme une valeur littérale et non comme une valeur ce qu’elle pourrait avoir. |
"text" |
Affiche le texte situé entre guillemets en tant que littéral. |
Date et exemples de format d'heure
Compte tenu de la date et de l'heure Tuesday, April 5, 2016, 4:08:53.528 PM
, le
Le tableau suivant présente quelques exemples de modèles et les dates-heures correspondantes
le rendu. La deuxième section du tableau présente des exemples de temps écoulé
formats pour une durée écoulée 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 motif de format numérique est une chaîne de sous-chaînes de jetons qui, lorsqu'elles sont analysées, remplacé 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, définissant formats distincts utilisés pour les nombres positifs, les nombres négatifs, le zéro et le texte (dans cette commande):
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
Vous n'avez pas besoin d'inclure les quatre sections dans un format. Si vous n'en incluez , ce format est utilisé pour toutes les valeurs. Si vous utilisez deux sections, à appliquer aux nombres nuls et positifs, et le second format à les nombres négatifs. L'utilisation de trois sections définit des formats distincts pour les valeurs les nombres 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 un texte cette section est traitée comme le format texte, et les autres se comportent comme si il y a une section de moins. Ainsi, en incluant un format de texte final, il est possible pour 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. possible d'inclure un format de date ou d'heure dans l'une des sections (même si son utilité est 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 pour cette section.
Jeton | Description |
---|---|
0 |
Représente un chiffre du nombre. Si le chiffre est un 0 non significatif,
la valeur affichée est 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 est un 0 non significatif,
s'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,
sous forme d'espace. Ceci 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 du nombre. Suivant
les points sont affichés sous forme de littéraux. Si vous incluez un séparateur décimal dans le
est toujours affiché, même pour les nombres entiers. Par exemple :
#0.# affiche le chiffre 3 sous la forme "3. ". |
% |
Apparaît comme un littéral, mais provoque également le multiplication des nombres existants
de 100 avant d'être affichées afin d'augmenter
et 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 de 1 000
virgule (par exemple, le format #0.0,, affiche le nombre
12 200 000 est 12.2 ). |
E- |
Affiche le nombre dans un format scientifique, avec le paramètre
mise en forme à gauche de la valeur E utilisée pour la valeur
et le formatage à droite du "E" utilisé pour l'exposant
pour chaque partie. E+ affiche un signe + pour un signe positif
exposants. E- n'affiche un signe que pour les exposants négatifs. Si
La valeur e de sortie 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
fractionnaire. Par exemple, le format numérique 0 #/# affiche
le nombre 23,25
comme 23 1/4 . Le dénominateur
peut également être un entier littéral, auquel cas il applique cet entier
le 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é si le numérateur prend la valeur 0. Le nombre
23.1 avec le format numérique 0 #/3 s'affiche sous la forme
23 (car 0,1 est arrondi à 0/3). / correspond à
non compatible avec le format scientifique ou avec un format décimal
s'y trouvent. |
* |
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 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 valeur
ce qu’elle pourrait avoir. 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é. Non compatible avec les autres caractères spéciaux et ne s'affiche pas pour des 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 ne sont pas modifiées. |
Instructions Meta
En outre, chacune des sections de format
peut contenir des méta-instructions facultatives,
entre []
caractères qui précèdent le format et fournissent
instructions supplémentaires. Il existe deux types d'instructions Meta
peut utiliser à la fois:
Instruction | Description |
---|---|
[condition] |
Remplace la comparaison positive, négative ou nulle par défaut des valeurs
par une autre expression conditionnelle. Par exemple :
[<100]”Low”;[>1000]”High”;000 affiche le mot.
"Faible" pour les valeurs inférieures à 100, "Élevée" pour les valeurs supérieures à 1 000 et un code à trois chiffres
numérique (avec des zéros au début) pour tout ce qui se trouve entre les deux. Les conditions ne peuvent être
appliqué aux deux premiers sous-formats.
Si un nombre correspond à plus d'un,
il utilise le premier auquel
il correspond. S'il existe un troisième format,
utilisé pour "tout le reste", dans le cas contraire, si un nombre ne correspond à aucun
cela signifie que les "#" remplissent la largeur de la cellule. S'il existe, le
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 la couleur de texte donnée. Les valeurs valides pour Color sont Black, bleu, cyan, vert, magenta, rouge, blanc ou jaune. Valeurs valides pour le signe "#" dans Color# sont 0 à 56 (ce palette de couleurs affiche une liste des couleurs qui correspondent à chaque nombre). Format numérique les couleurs remplacent celles saisies par l'utilisateur dans la cellule, mais ne remplacer les couleurs définies par la mise en forme conditionnelle. |
Exemples de format numérique
Le tableau suivant présente quelques exemples de modèles et les nombre formaté:
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 MyText |
1005 32 527 |
[>1000]"HIGH";[Color43][<=200]"LOW";0000 |
ÉLEVÉ FAIBLE 0527 |