NumberingFormats Classe

Definição

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.NumberingFormat))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "numFmts")]
public class NumberingFormats : DocumentFormat.OpenXml.OpenXmlCompositeElement

public class NumberingFormats : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.SchemaAttr(22, "numFmts")]
public class NumberingFormats : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.SchemaAttr("x:numFmts")]
public class NumberingFormats : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.SchemaAttr("x:numFmts")]
public class NumberingFormats : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.NumberingFormat))]
public class NumberingFormats : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.NumberingFormat))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class NumberingFormats : DocumentFormat.OpenXml.OpenXmlCompositeElement

[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.NumberingFormat))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "numFmts")>]
type NumberingFormats = class
    inherit OpenXmlCompositeElement

type NumberingFormats = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.SchemaAttr(22, "numFmts")>]
type NumberingFormats = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.SchemaAttr("x:numFmts")>]
type NumberingFormats = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.SchemaAttr("x:numFmts")>]
type NumberingFormats = class
    inherit TypedOpenXmlCompositeElement

[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.NumberingFormat))>]
type NumberingFormats = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.NumberingFormat))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type NumberingFormats = class
    inherit OpenXmlCompositeElement

Public Class NumberingFormats
Inherits OpenXmlCompositeElement

Public Class NumberingFormats
Inherits TypedOpenXmlCompositeElement

Herança

Object

OpenXmlElement

OpenXmlCompositeElement

NumberingFormats

Herança

Object

OpenXmlElement

OpenXmlCompositeElement

TypedOpenXmlCompositeElement

NumberingFormats

Atributos

ChildElementInfoAttribute OfficeAvailabilityAttribute SchemaAttrAttribute

Comentários

[ISO/IEC 29500-1 1st Edition]

numFmts (Number Formats)

Esse elemento define os formatos de número nesta pasta de trabalho, consistindo em uma sequência de registros numFmt, em que cada registro numFmt define um formato de número específico, indicando como formatar e renderizar o valor numérico de uma célula.

[Exemplo:

Esta célula está sendo formatada como moeda dos EUA:

7fc8d8ee-f580-4e43-98d0-91cf9abd8243

O XML que expressa esse formato mostra que o formatId é "166" e o formatCode decodificado é $#,##0.00

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

exemplo de término]

Number Format Codes

Até quatro seções de códigos de formato podem ser especificadas. Os códigos de formato, separados por ponto-e-vírgula, definem os formatos para números positivos, números negativos, valores zero e texto, nessa ordem. Se apenas duas seções forem especificadas, a primeira será usada para números positivos e zeros, e a segunda será usada para números negativos. Se apenas uma seção for especificada, ela será usada para todos os números. Para pular uma seção, o ponto e vírgula final dessa seção deve ser escrito.

9e00b419-894b-4a01-aba5-c8c92db922a6

A primeira seção, "Formato para números positivos", é o código de formato que se aplica à célula quando o valor da célula contém um número positivo.

A segunda seção, "Formato para números negativos", é o código de formato que se aplica à célula quando o valor da célula contém um número negativo.

A terceira seção, "Formato para zeros", é o código de formato que se aplica à célula quando o valor da célula é zero.

A quarta e última seção, "Formato para texto", é o código de formato que se aplica à célula quando o valor da célula é texto.

O operador de texto & (e comercial) é usado para unir ou concatenar dois valores.

A tabela a seguir descreve os diferentes símbolos que estão disponíveis para uso em formatos de número personalizados.

Símbolo de formato

Descrição e resultado

0

Espaço reservado para dígito. [Exemplo: se o valor 8.9 for exibido como 8.90, use o formato #.00 end example]

#

Espaço reservado para dígito. Este símbolo segue as mesmas regras que o símbolo 0. No entanto, o aplicativo não deve exibir zeros extras quando o número digitado tiver menos dígitos em ambos os lados do decimal do que os símbolos # no formato. [Exemplo: se o formato personalizado for #.## e 8.9 estiver na célula, o número 8.9 será exibido. exemplo de término]

?

Espaço reservado para dígito. Este símbolo segue as mesmas regras que o símbolo 0. No entanto, o aplicativo deve colocar um espaço para zeros insignificantes em ambos os lados da vírgula decimal para que os pontos decimais sejam alinhados na coluna. [Exemplo: O formato personalizado 0.0? alinha os pontos decimais para os números 8.9 e uma coluna. exemplo de término]

. (ponto)

Ponto decimal.

%

Porcentagem.. Se a célula contiver um número entre 0 e 1 e o formato personalizado 0% for usado, o aplicativo deverá multiplicar o número por 100 e adicionar o símbolo de porcentagem na célula.

, (vírgula)

Separador de milhar. O aplicativo deverá separar milhares por vírgulas se o formato contiver uma vírgula delimitada por sinais numéricos (#) ou por zeros. Uma vírgula que segue um espaço reservado dimensiona o número em mil. [Exemplo: se o formato for #.0 e o valor da célula for 12,200,000, o número 12,2 será exibido. exemplo de término]

E- E+ e- e+

Formato científico. O aplicativo deve exibir um número à direita do símbolo "E" que corresponde ao número de casas em que o ponto decimal foi movido. [Exemplo: se o formato for 0.00E+00 e o valor 12,200,000 estiver na célula, o número 1.22E+07 será exibido. Se o formato de número for #0.0E+0, o número 12.2E+6 será exibido. exemplo de término]

$-+/():space

Exibe o símbolo. Se for desejado exibir um caractere diferente de um desses símbolos, preceda o caractere com uma barra invertida (\). Como alternativa, coloque o caractere entre aspas. [Exemplo: se o formato de número for (000) e o valor 12 estiver na célula, o número (012) será exibido. exemplo de término]

\

Exibe o próximo caractere no formato. O aplicativo não deve exibir a barra invertida. [Exemplo: se o formato de número for 0\! e o valor 3 estiver na célula, o valor 3! será exibido. exemplo de término]

*

Repete o próximo caractere no formato vezes suficientes para preencher a coluna até sua largura atual. Não deve haver mais de um asterisco em uma seção do formato. Se mais de um asterisco aparecer em uma seção do formato, todos, exceto o último asterisco, devem ser ignorados. [Exemplo: se o formato de número for 0*x e o valor 3 estiver na célula, o valor 3xxxxxx será exibido. O número de x caracteres exibidos na célula varia de acordo com a largura da coluna. exemplo de término]

_ (sublinhado)

Ignora a largura do próximo caractere. Isso é útil para organizar valores negativos e positivos em células diferentes da mesma coluna. [Exemplo: o formato de número _(0.0_); (0.0) alinha os números 2.3 e a coluna, mesmo que o número negativo esteja entre parênteses. exemplo de término]

"text"

Exibe qualquer texto que esteja entre aspas. [Exemplo: o formato 0.00 "dólares" exibe 1.23 dólares quando o valor 1.23 está na célula. exemplo de término]

@

Espaço reservado para texto. Se o texto for digitado na célula, o texto da célula será colocado no formato em que o símbolo arroba (@) aparece. [Exemplo: se o formato de número for "Bob "@" Smith" (incluindo aspas) e o valor "John" estiver na célula, o valor Bob John Smith será exibido. exemplo de término]

Text and spacing

Exibir texto e números

Para exibir texto e números em uma célula, coloque os caracteres de texto entre aspas duplas (" ") ou preceda um único caractere com uma barra invertida (\). Aspas simples não devem ser usadas para indicar texto. Os caracteres entre aspas duplas ou imediatamente após a barra invertida nunca devem ser interpretados como parte do léxico do código de formato; em vez disso, elas sempre serão tratadas como cadeias literais. Lembre-se de incluir os caracteres na seção apropriada dos códigos de formato. [Exemplo: use o formato $0,00" Excedente";$-0,00" Escassez" para exibir um valor positivo como "Excedente de $125,74" e um valor negativo como "Escassez de $-125,74". exemplo de término]

Os caracteres a seguir são exibidos sem o uso de aspas.

$

Cifrão

-

Sinal de subtração

+

Plus sign

/

Barra

(

Parêntese esquerdo

)

Parêntese direito

:

Dois-pontos

!

Ponto de exclamação

^

Acento circunflexo (acento circunflexo)

&

E comercial

'

Apóstrofo

~

Til

{

Colchete encaracolado esquerdo

}

Colchete de chave direita

<

Sinal menor que

Sinal maior que

=

Sinal de igual

Caractere de espaço

Incluir uma seção para entrada de texto

Se incluída, uma seção de texto será a última seção no formato de número. Inclua um sinal de "arroba" (@) na seção, precisamente onde o valor de texto da célula deve ser exibido. Se o caractere @ for omitido da seção de texto, o texto digitado na célula não será exibido. Para sempre exibir caracteres de texto específicos com o texto digitado, coloque o texto adicional entre aspas duplas (" "). [Exemplo: se "junho" for digitado na célula e o formato de texto for "receitas brutas de "@ , a célula exibirá "receitas brutas de junho". exemplo de término]

Se o formato não incluir uma seção de texto, o texto inserido em uma célula não será afetado pelo código de formato.

Adicionar espaços

Para criar um espaço com a largura de um caractere em um formato de número, inclua um sublinhado, seguido do caractere. [Exemplo: quando um sublinhado é seguido com um parêntese direito, como _), os números positivos se alinham corretamente com os números negativos que estão entre parênteses porque os números positivos são exibidos com um espaço em branco depois deles exatamente da largura do caractere de parêntese direito. exemplo de término]

Repetir caracteres

Para repetir o próximo caractere no formato para preencher a largura da coluna, inclua um asterisco (*) no formato de número. [Exemplo: use 0*- para incluir traços suficientes após um número para preencher a célula ou use *0 antes de qualquer formato para incluir zeros à esquerda. exemplo de término]

Decimal places, spaces, colors, and conditions

Incluir casas decimais e dígitos significativos

Para formatar frações ou números com pontos decimais, inclua os seguintes espaços reservados de dígito em uma seção. Se um número tiver mais dígitos à direita do ponto decimal do que espaços reservados no formato, o número será arredondado para tantas casas decimais quanto espaços reservados. Se houver mais dígitos à esquerda do ponto decimal do que espaços reservados, os dígitos extras serão exibidos. Se o formato contiver apenas sinais de número (#) à esquerda da vírgula decimal, números menores que 1 começarão com uma vírgula decimal.

# (sinal de número) exibe apenas dígitos significativos e não exibe zeros insignificantes.

0 (zero) exibirá zeros insignificantes se um número tiver menos dígitos do que zeros no formato.

? (ponto de interrogação) adiciona espaços para zeros insignificantes em ambos os lados da vírgula decimal para que os pontos decimais se alinhem quando são formatados com uma fonte de largura fixa, como Courier New. ? Também pode ser usado para frações com números variados de dígitos.

Para exibir

Como

Usar este código

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 (com decimais alinhados)

???.???

5.255.3

5 1/45 3/10 (com frações alinhadas)

# ???/???

Exibir um separador de milhar

Para exibir uma vírgula como separador de milhar ou dimensionar um número por um múltiplo de 1.000, inclua uma vírgula no formato de número.

Para exibir

Como

Usar este código

12000

12,000

#,###

12000

12

#,

12200000

12.2

0.0,,

Especificar cores

Para definir a cor do texto para uma seção do formato, use o nome de uma das oito cores a seguir entre colchetes na seção. O código de cores deve ser o primeiro item da seção.

[Preto]

[Azul]

[Ciano]

[Verde]

[Magenta]

[Vermelho]

[Branco]

[Amarelo]

Em vez de usar o nome da cor, o índice de cores pode ser usado, como este [Cor3] para Vermelho. Os índices numéricos de cor são especificados no intervalo de 1 a 56, que faz referência por índice à paleta de cores herdada.

[Observação: os valores padrão da paleta de cores herdada estão listados em §18.8.27. Nos códigos de formato, [Cor1] refere-se à cor associada a indexed="8", ou preto (por padrão), [Cor2] refere-se à cor associada a indexed="9", ou branco (por padrão) e assim por diante até [Color56] referindo-se à cor associada a indexed="63". Se a paleta de cores tiver sido personalizada a partir de valores padrão, as cores associadas a esses índices refletirão essas personalizações.

Especificar condições

Para definir formatos de número que serão aplicados somente se um número atender a uma condição especificada, coloque a condição entre colchetes. A condição consiste em um operador de comparação e um valor. Os operadores de comparação incluem: = Igual a; > Maior que; < Menor que; >= Maior ou igual a, <= Menor ou igual a e <> Diferente de. [Exemplo: o formato a seguir exibe números que são menores ou iguais a uma fonte vermelha e números maiores que uma fonte azul.

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

exemplo de término]

Se o valor da célula não satisfizer nenhum dos critérios, então sinais de cerquilha ("#") são apresentados ao longo da largura da célula.

Currency, percentages, and scientific notation

Incluir símbolos de moeda

Para incluir símbolos de moeda, coloque o símbolo de moeda no local em que ele deveria quando exibido.

Exibir porcentagens

Para exibir números como uma porcentagem de 100 — [Exemplo: para exibir 0,08 como 8% ou 2,8 como exemplo final de 280%]— inclua o sinal de porcentagem (%) no formato de número.

Exibir notações científicas

Para exibir números em formato científico, use códigos de expoente em uma seção — [Exemplo: E-, E+, e- ou e+. exemplo de término]

Se um formato contiver um zero (0) ou sinal de número (#) à direita de um código de expoente, o aplicativo exibirá o número em formato científico e inserirá um "E" ou "e". O número de zeros ou sinais de número à direita de um código determina o número de dígitos do expoente. "E-" ou "e-" coloca um sinal de menos ao lado de expoentes negativos. "E+" ou "e+" coloca um sinal de menos por expoentes negativos e um sinal de mais por expoentes positivos.

Dates and times

Exibir dias, meses e anos

Para exibir

Como

Usar este código

Meses

1–12

m

Meses

01–12

mm

Meses

Jan–Dez

mmm

Meses

Janeiro-dezembro

mmmm

Meses

J–D

mmmmm

Dias

1–31

d

Dias

01–31

dd

Dias

Dom–Sáb

ddd

Dias

Domingo a sábado

dddd

Anos

00–99

yy

Anos

valor mínimo base de datas –9999

aaaa

Consulte §18.17.4.1 para obter detalhes sobre possíveis bases de datas.

Mês versus minutos

Se for utilizado o código "m" ou "mm" imediatamente após o código "h" ou "hh" (durante horas) ou imediatamente antes do código "ss" (para segundos), a aplicação deve apresentar os minutos em vez do mês.

Exibir horas, minutos e segundos

Para exibir

Como

Usar este código

Horas

0–23

h

Horas

00–23

hh

Minutos

0–59

m

Minutos

00–59

mm

Segundos

0–59

s

Segundos

00–59

ss

Time

h AM/PM

Time

h:mm AM/PM

Time

16:36:03

h:mm:ss A/P

Time

4:36:03.75

h:mm:ss.00

Tempo decorrido (horas e minutos)

1:02

[h]:mm

Tempo decorrido (minutos e segundos)

62:16

[mm]:ss

Tempo decorrido (segundos e centésimos)

3735.80

[ss].00

Minutos versus mês

O código "m" ou "mm" aparece imediatamente a seguir ao código "h" ou "hh" ou imediatamente antes do código "ss"; Caso contrário, eles serão exibidos como o mês em vez de minutos.

AM e PM

Se o formato contiver AM ou PM, a hora será baseada no relógio de 12 horas, em que "AM" ou "A" indica horas de até e "PM" ou "P" indica horas de até meia-noite. Caso contrário, a hora será baseada no relógio de 24 horas.

Valores de data e hora ilegais

As células formatadas com um formato de data ou hora e que contenham valores de data ou hora que não cumpram os requisitos especificados devem apresentar o sinal de jogo da velha ("#") ao longo da largura da célula.

International Considerations

Código de formato

Descrição

r

Apenas JA-JP/ZH-TW.

Ao carregar na localidade ja-jp, o código se torna "ee".

Ao carregar na localidade zh-tw, o código se torna "e".

RR

Apenas JA-JP/ZH-TW.

Ao carregar na localidade ja-jp, o código se torna "gggee".

Ao carregar na localidade zh-tw, o código se torna "e".

g

Ao carregar na localidade ja-jp: Reinado do imperador de caráter romano único

Ao carregar na localidade zh-tw (somente Taiwan): trate o mesmo que "gg".

gg

Ao carregar na localidade ja-jp: Reinado do imperador do personagem Kanji único

Ao carregar na localidade zh-tw: Nome abreviado da última era (desde 1911)

ggg

Ao carregar na localidade ja-jp: reinado do imperador do personagem Tow Kanji

Ao carregar na localidade zh-tw: Nome longo da última era (desde 1911)

e

Ao carregar na localidade ja-jp: Ano da era

Ao embarcar em zh-tw (somente Taiwan) localidade: Ano da era desde 1912. Se precedido por "g", "gg" ou "ggg", então o ano de 1912 e os anos anteriores a 1912 são especiais, caso contrário, os anos anteriores a 1912 são gregorianos.

OUTRAS localidades: torna-se "aaaa"

EE

Ao carregar na localidade ja-jp: Era year w/ zero à esquerda

Ao carregar em zh-tw (somente Taiwan) localidade: Ano da era desde 1911

OUTRAS localidades: torna-se "aa"

b2

Hijri calander

b1

calendário gregoriano

[$USD-409]

Especifica a moeda e as informações do sistema de sistema/sistema de data/número.

A sintaxe é [$<Conversor de Moedas String-language>< info>]. A cadeia de caracteres do Conversor de Moedas é uma cadeia de caracteres a ser usada como símbolo de moeda. As informações de idioma são um valor de 32 bits inserido no formato hexadecimal.

Formato de informações de idioma (byte 3 é o byte mais significativo):

Bytes 0,1: ID de idioma (LID) de 16 bits.

Byte 2: Tipo de Calendar. O bit alto indica que a entrada é analisada usando o calendário especificado.

Byte 3: Tipo de sistema de números. O bit alto indica que a entrada é analisada usando o sistema numérico especificado.

Valores de informações de idioma especial:

0xf800: Formato de data longo do sistema

0xf400: Formato da hora do sistema

Elementos pai
styleSheet (§18.8.39)

Elementos filho	Subcláusula
numFmt (Formato de Número)	§18.8.30

Atributos	Descrição
count (número, formato, contagem)	Contagem de elementos de formato de número. Os valores possíveis para esse atributo são definidos pelo tipo de dados unsignedInt do esquema XML do W3C.

[Observação: a definição do esquema XML do W3C do modelo de conteúdo desse elemento (CT_NumFmts) está localizada em §A.2. nota final]

ISO/IEC29500: 2008.