Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

NumberingFormats - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Définit la classe NumberingFormats. Lorsque l'objet est sérialisé en XML, son nom qualifié est x: numFmts.

Espace de noms :  DocumentFormat.OpenXml.Spreadsheet
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

[ChildElementInfoAttribute(typeof(NumberingFormat))]
public class NumberingFormats : OpenXmlCompositeElement

[ISO/IEC 29500-1 1st Edition]

numFmts (Number Formats)

Cet élément définit les formats de nombre dans ce classeur, consistant en une séquence d'enregistrements numFmt, où chaque enregistrement numFmt définit un format de nombre spécifique, en indiquant comment mettre en forme et de rendre la valeur numérique d'une cellule.

[Exemple :

Cette cellule est mise en forme en tant que devise américaine :

Le code XML exprimant ce format révèle que formatId est « 166 » et la formatCode décodée $#, ## 0.00

<numFmts count="1">
  <numFmt numFmtId="166" formatCode="&quot;$&quot;#,##0.00"/>
</numFmts>

Fin de l’exemple]

Number Format Codes

Jusqu'à quatre sections de format peuvent être spécifiés. Les codes de format, séparés par des points-virgules, définissent les formats des nombres positifs, des nombres négatifs, valeurs zéro et le texte, dans cet ordre. Si seulement deux sections sont spécifiées, la première est utilisée pour les nombres positifs et les zéros, et la seconde est utilisée pour les nombres négatifs. Si seule une section est spécifiée, elle est utilisée pour tous les numéros. Pour ignorer une section, le point-virgule de fin de cette section doit être écrites.

La première section, « Format pour les nombres positifs », est le code de format s'applique à la cellule lorsque la valeur de la cellule contient un nombre positif.

La deuxième section, « Format pour les nombres négatifs », est le code de format s'applique à la cellule lorsque la valeur de la cellule contient un nombre négatif.

La troisième section, « Format pour les zéros non significatifs », est le code de format qui s'applique à la cellule lorsque la valeur de la cellule est égale à zéro.

La quatrième et dernière, section, « Format de texte », est le code de format s'applique à la cellule lorsque la valeur de la cellule est texte.

Le & opérateur de texte (&) est utilisé pour joindre ou concaténer deux valeurs.

Le tableau suivant décrit les différents symboles disponibles pour utilisation dans des formats de nombre personnalisés.

Symbole du format

Description et résultat

0

Espace réservé de chiffre. [Exemple: si la valeur 8.9 doit être affiché sous la forme 8.90, utilisez format #.00 exemple de fin]

#

Espace réservé de chiffre. Ce symbole suit les mêmes règles que le symbole 0. Toutefois, l'application s'affiche pas de zéros supplémentaires lorsque le nombre tapé comporte moins de chiffres de chaque côté du séparateur décimal qu'il ne sont symboles # dans le format. [Exemple: si le format personnalisé est #. ## et 8.9 dans la cellule, le nombre 8.9 s'affiche.exemple de fin]

?

Espace réservé de chiffre. Ce symbole suit les mêmes règles que le symbole 0. Toutefois, l'application mettent un espace pour les zéros non significatifs de chaque côté de la virgule décimale afin que les virgules soient alignées dans la colonne. [Exemple: le format personnalisé 0.0? aligne les points décimaux pour les nombres 8.9 et une colonne.exemple de fin]

period

Virgule décimale.

%

Pourcentage. Si la cellule contient un nombre compris entre 0 et 1, et le format personnalisé 0 % est utilisé, l'application doit multiplier le nombre par 100 et ajoutez le symbole de pourcentage dans la cellule.

, (virgule)

Des milliers séparateur. L'application doit séparer les milliers par des virgules si le format contient une virgule qui est encadrée par des signes dièse (#) ou des zéros. Une virgule qui suit un espace réservé met à l'échelle le nombre par mille. [Exemple: si le format est #. 0,, et que la valeur de la cellule est 12.200.000 le nombre 12.2 s'affiche.exemple de fin]

E- E+ e- e+

Format scientifique. L'application doit afficher un nombre à droite du symbole « E » qui correspond au nombre d'endroits que la virgule a été déplacée. [Exemple: si le format est 0.00E + 00 et que la valeur 12.200.000 est dans la cellule, le nombre 1.22E + 07 s'affiche. Si le format est # 0.0E + 0, le nombre 12.2E + 6 s'affiche.exemple de fin]

$-+ / (): espace

Affiche le symbole. S'il est nécessaire pour afficher un caractère différente de ces symboles, faites précéder le caractère d'une barre oblique inverse (\). Ou bien, mettez le caractère entre guillemets. [Exemple: si le format de nombre est (000), et la valeur 12 dans la cellule, le nombre (012) s'affiche.exemple de fin]

\

Affiche le caractère suivant au format. L'application ne doit pas afficher la barre oblique inverse. [Exemple: si le format de nombre est 0\!, et la valeur 3 dans la cellule, la valeur 3! s'affiche.exemple de fin]

*

Répète le caractère suivant au format suffisamment de fois pour remplir la colonne dans sa largeur actuelle. Il ne peut être plus d'un astérisque dans une section du format. Si plus d'un astérisque apparaît dans une section du format, tous à l'exception du dernier astérisque doivent être ignoré. [Exemple: si le format de nombre est 0 * x et la valeur 3 est dans la cellule, la valeur 3xxxxxx s'affiche. Le nombre de caractères qui s'affichent dans la cellule x varie en fonction de la largeur de la colonne.exemple de fin]

_ (souligné)

Ignore la largeur du caractère suivant. Cela est utile pour aligner des valeurs négatives et positives dans différentes cellules de la même colonne. [Exemple: le numéro _(0.0_);(0.0) format aligne les numéros 2.3 et la colonne même si le nombre négatif est entre parenthèses.exemple de fin]

"text"

Affiche le texte placé entre guillemets. [Exemple: les format 0,00 "dollars" affiche 1,23 dollars lorsque la valeur 1.23 dans la cellule.exemple de fin]

@

Espace réservé au texte. Si le texte est tapé dans la cellule, le texte de la cellule est placé dans le format où le symbole arobase (@) apparaît. [Exemple: si le format de nombre est "Bob" @"Smith" (y compris les guillemets), et la valeur « Jean » se trouve dans la cellule, la valeur Bob John Smith s'affiche.exemple de fin]

Text and spacing

Afficher du texte et des nombres

Pour afficher du texte et des nombres dans une cellule, mettez le texte entre guillemets doubles ("") ou faites-le précéder d'un caractère unique avec une barre oblique inverse (\). Il ne doit pas servir entre des guillemets simples pour indiquer du texte. Caractères à l'intérieur des guillemets, ou immédiatement après une barre oblique inverse ne sont jamais interprétés comme partie du lexique de code de format ; au lieu de cela ils sont toujours considérés comme des chaînes littérales. N'oubliez pas d'inclure les caractères dans la section appropriée des codes de format. [Exemple: utilisez le format $0.00" excédent"; 0,00$ "insuffisante" pour afficher un montant positif sous la forme « 125,74 f » et un montant négatif sous la forme «-125,74. » exemple de fin]

Les caractères suivants sont affichés sans utiliser de guillemets.

$

Symbole dollar

-

Signe moins

+

Signe plus

/

Marque de barre oblique

(

Parenthèse gauche

)

Parenthèse droite

:

Deux points

!

Point d'exclamation

^

Accent circonflexe (signe insertion)

&

esperluette

'

Apostrophe

~

tilde

{

Accolade gauche

}

Accolade droite

<

Signe inférieur à

>

Signe supérieur à

=

Signe égal

Espace

Inclure une section pour la saisie de texte

Si inclus, une section de texte doit être la dernière section dans le format de nombre. Un signe « at » (@) dans la section, avec précision où la valeur de cellule texte doit être affichée. Si le @ caractère est omis dans la section de texte, le texte tapé dans la cellule ne s'affichera pas. Pour afficher systématiquement des caractères spécifiques avec le texte tapé, entourez le texte supplémentaire de guillemets anglais doubles (""). [Exemple: si "juin" est tapée dans la cellule et que le format texte est "reçus bruts de" @, la cellule affichera « recettes brutes pour juin ». exemple de fin]

Si le format ne comprend pas une section de texte, le texte entré dans une cellule n'est pas affecté par le code de format.

Ajouter des espaces

Pour créer un espace qui correspond à la largeur d'un caractère dans un format de nombre, insérez un trait de soulignement suivi du caractère. [Exemple: lorsqu'un trait de soulignement est suivie d'une parenthèse fermante, par exemple _) positif de chiffres alignés correctement par des nombres négatifs qui sont entre parenthèses, car les nombres positifs apparaissent avec un espace d'espace après les exactement la largeur de la parenthèse droite. exemple de fin]

Répéter les caractères

Pour répéter le caractère suivant dans le format jusqu'à remplir toute la largeur de colonne, insérez un astérisque (*) dans le format de nombre. [Exemple: utilisez 0 * - pour inclure suffisamment de tirets après un nombre pour remplir la cellule, ou utilisez * 0 avant n'importe quel format d'inclure les zéros non significatifs. exemple de fin]

Decimal places, spaces, colors, and conditions

Inclure les décimales et chiffres significatifs

Pour formater des fractions ou des nombres comportant des décimales, insérez les espaces réservés numériques suivants dans une section. Si un nombre comporte plus de chiffres à droite du séparateur décimal qu'il sont a des espaces réservés dans le format, le nombre est arrondi à autant de décimales qu'il est des espaces réservés. S'il existe plus de chiffres à gauche du séparateur décimal qu'il sont a des espaces réservés, les chiffres supplémentaires sont affichés. Si le format contient uniquement des signes dièse (#) à gauche de la virgule décimale, les nombres inférieurs à 1 commencent par un séparateur décimal.

# (signe dièse) affiche uniquement les chiffres significatifs et n'affiche pas de zéros non significatifs.

0 (zéro) affiche les zéros non significatifs si un nombre comporte moins de chiffres qu'il y a de zéros dans le format.

? (point d'interrogation) ajoute des espaces pour les zéros non significatifs de chaque côté de la virgule décimale afin d'aligner les séparateurs décimaux lorsqu'ils sont mis en forme avec une police à largeur fixe, comme Courier New. ? peut également être utilisé pour les fractions ayant un nombre variable de chiffres.

Pour afficher

En tant que

Utilisez ce code

1234.59

1234.6

####.#

8.9

8.900

#.000

.631

0.6

0.#

121234.568

12.01234.57

#.0#

44.398102.652.8

44.398102.65 2.8 (en alignant les décimales)

???.???

5.255.3

5 1/45 3/10(with aligned fractions)

# ???/???

Afficher un milliers séparateur

Pour afficher une virgule comme des milliers séparateur ou un nombre à un multiple de 1 000, insérez une virgule dans le format de nombre.

Pour afficher

En tant que

Utilisez ce code

12000

12,000

#,###

12000

12

#,

12200000

12.2

0.0,,

Spécifier les couleurs

Pour définir la couleur du texte d'une section du format, utilisez le nom de l'une des huit couleurs suivantes entre crochets dans la section. Le code de couleur doit être le premier élément de la section.

[Noir]

[Bleu]

[Cyan]

[Vert]

[Magenta]

[Rouge]

[Blanc]

[Jaune]

Au lieu d'utiliser le nom de la couleur, la couleur index peut être utilisé, comme ce [Color3] pour le rouge. Index numériques de couleur sont restircted à la plage de 1 à 56, qui font référence à un index dans la palette de couleurs existantes.

[Remarque: les valeurs de palette de couleur hérités par défaut sont répertoriés dans §18.8.27. Dans les codes de format, [Color1] fait référence à la couleur associée indexé = « 8 », ou noir (par défaut), [Color2] fait référence à la couleur associée indexé = 9, ou blanc (par défaut) et donc à [Color56] faisant référence à la couleur associé indexé = "63". Si la palette de couleurs a été personnalisée à partir des valeurs par défaut, les couleurs associées à ces index reflète ces personnalisations.

Spécifier des conditions

Pour définir des formats de nombre qui ne sont appliquées seulement si un nombre répond à une condition spécifiée, placez la condition en question entre crochets droits. Elle se compose d'un opérateur de comparaison et une valeur. Les opérateurs de comparaison sont: = égal à ; > Supérieur ; < Moins ; > = supérieur ou égal à, < = inférieur ou égal à et <> non égal à. [Exemple: le format suivant affiche les numéros qui sont inférieures ou égales à une police rouge et qui sont supérieures à une police bleue.

[Red][<=100];[Blue][>100]

Fin de l’exemple]

Si la valeur de la cellule ne remplit pas les critères, le signe dièse (« # ») s'affichent sur toute la largeur de la cellule.

Currency, percentages, and scientific notation

Inclure des symboles de devise

Pour inclure des symboles de devise, placez le symbole monétaire dans l'emplacement qu'il convient lorsqu'il est affiché.

Afficher les pourcentages

Pour afficher les nombres sous la forme d'un pourcentage de 100 — [exemple: pour afficher les.08 8 % ou 2.8 sous la forme 280 % exemple fin]: inclure le signe de pourcentage (%) dans le format de nombre.

Afficher les notations scientifiques

Pour afficher les nombres au format scientifique, utilisez les codes d'exposant dans une section: [exemple: E-, E +, e- ou e +. exemple de fin]

Si un format contient un zéro (0) ou un signe dièse (#) à droite du code de l'exposant, l'application affiche le nombre au format scientifique et insère un « E » ou un « e ». Le nombre de zéros ou de signes de nombre à la droite du code détermine le nombre de chiffres dans l'exposant. « E-» ou « e-» insère un signe de moins par les exposants négatifs. « E + » ou « e + place un signe moins exposants négatifs et un signe plus par des exposants positifs.

Dates and times

Afficher les jours, les mois et les années

Pour afficher

En tant que

Utilisez ce code

Mois

1 – 12

m

Mois

01 – 12

mm

Mois

Jan – déc

mmm

Mois

Janvier – décembre

mmmm

Mois

– D J

Mmmmm

Jours

1 – 31

j

Jours

01 – 31

dd

Jours

Sun-Sat

ddd

Jours

Dimanche – samedi

dddd

Années

00 – 99

yy

Années

valeur minimale de date de base de –9999

yyyy

Voir §18.17.4.1 pour des détails sur les bases de date possible.

Mois et les minutes

Si le code « m » ou « mm » est utilisé immédiatement après le code « h » ou « hh » (pour les heures) ou immédiatement avant le code « ss » (par secondes), l'application doit afficher les minutes au lieu du mois.

Afficher les heures, les minutes et les secondes

Pour afficher

En tant que

Utilisez ce code

Heures

0 – 23

h

Heures

00 – 23

hh

Minutes.

0 – 59

m

Minutes.

00 – 59

mm

Secondes

0 – 59

s

Secondes

00 – 59

ss

Temps

h AM/PM

Temps

h: mm AM/PM

Temps

4:36:03 P

ss A / P

Temps

4:36:03.75

h:mm:ss.00

Temps écoulé (heures et minutes)

1:02

[h]: mm

Temps écoulé (minutes et secondes)

62:16

[mm]: ss

Temps écoulé (secondes et centièmes)

3735.80

[ss].00

Minutes et les mois

Le code « m » ou « mm » doit apparaître immédiatement après le code « h » ou « hh » ou immédiatement avant le code « ss » ; dans le cas contraire, il affiche le mois au lieu des minutes.

AM et PM

Si le format contient AM ou PM, l'heure est basée sur l'horloge de 12 heures, où « AM » ou « A » représente les heures comprises jusqu'au et « PM » ou « P » indique les heures de minuit. Dans le cas contraire, l'heure est basée sur l'horloge de 24 heures.

Les valeurs illégal date et heure

Cellules mises en forme avec une date de format d'heure et qui contiennent la date ou les valeurs de temps qui ne répondent pas aux exigences spécifiées comportent le signe dièse (« # ») sur toute la largeur de la cellule.

International Considerations

Code de format

Description

r

ja-jp/zh-tw uniquement.

Lors du chargement dans les paramètres régionaux ja-jp, code devient « ee ».

Lors du chargement dans les paramètres régionaux de zh-tw, code devient « e ».

enregistrement de ressource

ja-jp/zh-tw uniquement.

Lors du chargement dans les paramètres régionaux ja-jp, code devient « gggee ».

Lors du chargement dans les paramètres régionaux de zh-tw, code devient « e ».

g

Lors du chargement des paramètres régionaux ja-jp: règne de l'Empereur romain seul caractère

Lors du chargement des paramètres régionaux zh-tw (Taïwan uniquement): traiter comme « gg ».

GG

Lors du chargement des paramètres régionaux ja-jp: règne de l'Empereur caractère Kanji simples

Lors du chargement des paramètres régionaux zh-tw : nom court era (depuis 1911)

GGG

Lors du chargement des paramètres régionaux ja-jp: règne de l'Empereur caractère Kanji de traction

Lors du chargement des paramètres régionaux zh-tw : dernière ère nom long (depuis 1911)

e

Lors du chargement des paramètres régionaux ja-jp: année ère

Lorsque le chargement dans les paramètres régionaux de zh-tw (Taïwan uniquement): année d'ère depuis 1912. Précédé de « g », « gg », ou « ggg » année de 1912, puis sur l'ans avant 1912 sont spéciales, sinon les années avant 1912 sont grégorien.

Les autres paramètres régionaux : devient « yyyy »

ee

Lors du chargement des paramètres régionaux ja-jp: année ère avec zéro non significatif

Lors du chargement des paramètres régionaux zh-tw (Taïwan uniquement): année d'ère depuis 1911

Les autres paramètres régionaux : devient « yy »

b2

Calendrier islamique (Hijri)

b1

Calendrier grégorien

[USD-409]

Spécifie les informations de système de système/numéro régionaux de date et de devise.

La syntaxe est [$< chaîne monétaire >-< info langue >]. Chaîne monétaire est une chaîne à utiliser comme symbole monétaire. Informations sur le langage sont une valeur 32 bits entrée au format hexadécimal.

Format des informations de langue (octets 3 est octet le plus significatif) :

0,1 octets: ID de langue de 16 bits (identificateur LID).

Octet 2: Type de calendrier. Bit élevé indique que les entrées sont analysée à l'aide du calendrier spécifié.

Octet 3: type de système de numération. Bit élevé indique qu'entrée est analysée à l'aide de système spécifié.

Valeurs d'informations spéciales de langue :

0xf800 : format de date longue de système

0xf400 : format de l'heure système

Éléments parents

feuille de style (§18.8.39)

Élements enfants

Sous-clause

numFmt (numéro de Format)

§18.8.30

Attributs

Description

Count (nombre de Format de nombre)

Nombre d'éléments de format numériques.

Les valeurs possibles de cet attribut sont définies par le type de données unsignedInt du schéma XML du W3C.

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_NumFmts) se trouve dans §A.2. fin de la Remarque]

© ISO/IEC29500: 2008.

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: