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 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 ou 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 qu'un , 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 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