Esta página foi traduzida pela API Cloud Translation.

Formatos de data e número

Com os formatos de data e hora e números, você controla como seus dados aparecem em uma planilha. As Planilhas Google oferecem alguns formatos comuns para escolher, mas você também pode e definir seus próprios formatos.

Na interface do Planilhas, você aplica formatos de número e data às células usando a função Formato > Menu Número. Na Sheets API, você define esses formatos usando uma spreadsheets.batchUpdate chamada de método para enviar uma UpdateCellsRequest ou RepeatCellRequest.

Esta página descreve como definir novos padrões de formato de data e número, que você podem incluir na sua solicitação de API. A amostra Definir um formato personalizado de data/hora ou decimal para um intervalo mostra como definir um padrão de formatação usando a API. A renderização real do formato depende do locale da planilha. Este guia pressupõe que locale é en_US. Você pode determinar o locale de uma planilha lendo as SpreadsheetProperties com um spreadsheets.get solicitação.

Sobre data e valores de tempo

O Planilhas, como a maioria dos outros aplicativos de planilha, trata os valores de data e hora como decimais. Isso permite realizar aritméticas neles em fórmulas, incrementar dias ou semanas, adicionar ou subtrair duas datas e horas e realizar outras operações semelhantes.

O Planilhas usa uma forma de data de época que normalmente é usado em planilhas. A parte de número inteiro do valor (à esquerda do decimal) conta os dias desde 30 de dezembro de 1899. A expressão (à direita do decimal) conta a hora como uma fração de um dia. Para exemplo, 1o de janeiro de 1900 ao meio-dia é 2.5, 2 porque é dois dias depois 30 de dezembro de 1899 e 0.5 porque meio-dia é metade de um dia. 1o de fevereiro de 1900 às 15h é 33.625.

O Planilhas trata o ano 1900 como um ano comum, não um ano bissexto.

Data e padrões de formato de hora

Um padrão de formato de data e hora é uma string de substrings de token que, quando analisadas, são substituídos pelos elementos de data e hora correspondentes (como o mês ou por hora).

Data e tokens de formato de hora

A tabela a seguir define as substrings de token que podem ser usadas em um intervalo de data-hora padrão de formatação. O caractere + indica que o caractere anterior pode aparecer uma ou mais vezes e ainda correspondem ao padrão. Caracteres não listados na abaixo são tratados como literais e são gerados sem alterações.

Token	Descrição
`h`	Hora do dia. Alterna entre o formato de 12 e 24 horas, dependendo do se há um indicador AM ou PM na string.
`hh+`	Igual ao anterior, mas com um 0 na frente de 1-9.
`m`	Se o token não literal anterior for horas ou se o seguinte for segundos, ele representa os minutos na hora (sem um 0 na frente). Caso contrário, representa o mês do ano como um número (sem 0 na frente).
`M`	O mês do ano sem um 0 na frente. Use esse token para indicar expressamente um mês, em vez de um minuto, no seu padrão.
`mm`	Igual a `m`, mas com um 0 na frente dos dois casos.
`MM`	O mês do ano com um 0 na frente. Use esse token para indicar expressamente um mês, em vez de um minuto, no seu padrão.
`mmm`	Abreviação de mês com três letras (por exemplo, "Fev").
`mmmm`	Nome completo do mês. `mmmmmm+` também corresponde a isso.
`mmmmm`	Primeira letra do mês (por exemplo, "J" para junho).
`s`	Segundos no minuto sem um 0 na frente.
`ss`	Segundos no minuto com um 0 na frente.
`[h+]`	Número de horas decorridas em um período. Número de letras indica o número mínimo de dígitos (adiciona 0s à esquerda).
`[m+]`	Número de minutos decorridos em um intervalo de tempo. Número de letras indica o número mínimo de dígitos (adiciona 0s à esquerda).
`[s+]`	Número de segundos decorridos em um intervalo de tempo. Número de letras indica o número mínimo de dígitos (adiciona 0s à esquerda).
`d`	Dia do mês, sem um 0 na frente para números inferiores a 10.
`dd`	Dia do mês, com 0 na frente para números inferiores a 10.
`ddd`	Dia da semana, abreviação de três letras (por exemplo, "Seg").
`dddd+`	Dia da semana, nome completo.
`y`	Ano com 2 dígitos.
`yy`	Ano com 2 dígitos.
`yyy`	Ano com 4 dígitos.
`yyyy+`	Ano com 4 dígitos.
`a/p`	Exibe "a" para AM e "p" para PM. Também altera o horário de funcionamento para Formato de 12 horas. Se a letra do token for maiúscula, a saída será: também.
`am/pm`	Como acima, mas exibe "AM" ou "PM" em vez disso e é sempre em letras maiúsculas.
`0`	Décimos de segundos. Você pode aumentar a precisão para dois dígitos com `00` ou três dígitos (milissegundos) com `000`.
`\`	Trata o próximo caractere como um valor literal e não um caractere especial o que pode ter.
`"text"`	Mostra o texto entre aspas como literal.

Data e exemplos de formato de hora

Considerando a data e a hora Tuesday, April 5, 2016, 4:08:53.528 PM, o a tabela a seguir mostra alguns exemplos de padrões e as respectivas datas e horas renderização. A segunda seção da tabela mostra exemplos de tempo decorrido formatos para um tempo decorrido de 3 hours, 13 minutes, 41.255 seconds:

Padrões de data e hora	`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 de abril [terça-feira]
`h PM, ddd mmm dd`	16h, terça-feira, 5 de abril
`dddd, m/d/yy at h:mm`	Terça-feira, 5/4/16 às 16h08
Padrões de tempo decorrido	`3 hours, 13 minutes, 41.255 seconds`
`[hh]:[mm]:[ss].000`	03:13:41.255
`[mmmm]:[ss].000`	0193:41.255

Padrões de formato de número

Um padrão de formato de número é uma string de substrings de token que, quando analisadas, são substituídos pelas representações numéricas correspondentes. Um padrão de formato numérico podem consistir em até quatro seções, separadas por ponto e vírgula, que definem o formatos separados usados para números positivos, números negativos, zero e texto (em nessa ordem):

[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]

Você não precisa incluir todas as quatro seções em um formato. Se você incluir apenas um , esse formato é usado para todos os valores. O uso de duas seções faz com que a primeira a ser aplicado a zero e números positivos e ao segundo formato a números negativos. Usar três seções define formatos separados para positivo, negativo e zero. Exemplo:

[NUMBER FORMAT]
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT]
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]

No entanto, se houver duas ou mais seções e a seção final for um texto formato, essa seção é tratada como o formato de texto e as outras se comportam como se há uma seção a menos. Assim, ao incluir um formato final de texto, é possível para definir formatos como:

[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT]
[NUMBER FORMAT];[TEXT FORMAT]

A análise de um formato em seções ocorre antes de outra análise, portanto é possível incluir um formato de data ou hora como uma das seções (embora isso tem utilidade limitada).

Tokens de formato de número

A tabela a seguir define as substrings de token que podem ser usadas em uma seção de formato para definir como representar os valores da seção.

Token	Descrição
`0`	Representa um dígito no número. Se o dígito for um 0 insignificante, ele será renderizado como 0. Por exemplo, o formato de número `00.0` renderiza o número 3 como "`03.0`".
`#`	Representa um dígito no número. Se o dígito for um 0 insignificante, mesmo que ela não seja renderizada. Por exemplo, o formato de número `##0` renderiza o número 12 como "`12`".
`?`	Representa um dígito no número. Se o dígito for um 0 insignificante, ele é renderizado como um espaço. Isso é frequentemente usado para alinhar o ponto decimal em uma coluna ao usar fontes de largura fixa. Por exemplo, o formato de número `???.???` renderiza o número 12.4 como: ” `12.4`".
`.`	O primeiro ponto representa o separador decimal do número. Depois e pontos são renderizados como literais. Se você incluir um ponto decimal no formato, ele é sempre renderizado, mesmo para números inteiros. Por exemplo: `#0.#` renderiza o número 3 como "`3.`".
`%`	Aparece como um literal, mas também faz com que os números existentes sejam multiplicados por 100 antes de serem renderizados para aumentar as porcentagens legível. Por exemplo, o formato de número `#%` renderiza o número 0,25 como "`25%`".
`,`	Se aparecer entre caracteres de dois dígitos (`0`, `#` ou `?`), ele renderiza o número inteiro usando separadores de agrupamento (por milhares). Se seguir os dígitos, ele dimensiona os dígitos em mil por vírgula (por exemplo, o formato `#0.0,,` renderiza o número 12.200.000 como `12.2`).
`E-`	Renderiza o número em formato científico, com o a formatação à esquerda do `E` usado para o valor não expoente e a formatação à direita do E usado para o expoente parte `E+` mostra um sinal de `+` para positivo expoentes. `E-` mostra apenas um sinal para expoentes negativos. Se é usado em letras minúsculas, a saída `e` também estará em letras minúsculas. Por exemplo, o formato de número `##0.00#E+##` renderiza o número 0,0000001 como "`100.00E-9`".
`E+`
`e-`
`e+`
`/`	Se aparecer entre caracteres de dois dígitos (`0`, `#` ou `?`), ele trata esses grupos de dígitos como um formato fracionário. Por exemplo, o formato de número `0 #/#` é renderizado o número 23,25 como `23 1/4`. O denominador também pode ser um número inteiro literal. Nesse caso, ele impõe esse número inteiro como o denominador. O formato de número `0 #/8` exibe o número 23,25 como `23 2/8`. A parte da fração não é renderizado se o numerador se tornar 0. O número 23.1 com o formato de número `0 #/3` é renderizado como `23` (porque 0,1 é arredondado para 0/3). `/` é não é compatível com o formato científico ou um formato com ponto decimal nele.
`*`	Isso é incluído para compatibilidade com formatos numéricos do Microsoft Excel. Atualmente, ela é ignorada.
`_`	O token de sublinhado pula o próximo caractere e renderiza um espaço. Isso é usado para alinhar formatos numéricos em que o valor negativo é colocado entre parênteses.
`\`	Trata o próximo caractere como um valor literal e não um caractere especial o que pode ter. Por exemplo, o formato de número `\#0` renderiza o número 10 como "`#10`".
`"text"`	Mostra o texto entre aspas como literal.
`@`	Se a célula tiver entrada de texto, o texto bruto será inserido. Não compatível com qualquer um dos outros caracteres especiais e não é exibido para valores numéricos (que são exibidos como formato geral).
`$ - + ( ) : space`	O app Planilhas trata esses caracteres como literais e os mostra sem alterações.

Instruções meta

Além disso, cada uma das seções de formato pode ter instruções meta opcionais, entre [] caracteres, que precedem o formato e fornecem instruções adicionais. Há dois tipos de instrução meta e um certo pode usar:

Instrução Descrição

[condition] Substitui a comparação padrão positiva, negativa ou zero da por outra expressão condicional. Por exemplo: [<100]”Low”;[>1000]”High”;000 renderiza a palavra "Baixo" para valores abaixo de 100, "Alto" para valores acima de 1.000 e um (com zeros à esquerda) para qualquer item intermediário. As condições só podem ser aplicado aos dois primeiros subformatos e, se um número corresponder a mais de um, ele usa o primeiro que corresponde. Se houver um terceiro formato, usado para "todo o resto", caso contrário, se um número não corresponder ele será renderizado como todos os "#" preenchendo a largura da célula. Se existir, o o quarto formato é sempre usado para texto.

[Color] or [Color#] Faz com que qualquer valor renderizado por esse subformato apareça com o cor de texto específica. Os valores válidos para Color são: preto, Azul, ciano, verde, magenta, vermelho, branco ou amarelo. Valores válidos para "#" em Color# são 0&ndash1;56 (esta paleta de cores mostra uma lista das cores que correspondem a cada número). Formato de número as cores substituem as cores inseridas pelo usuário na célula, mas não substituir as cores definidas pela formatação condicional.

Instrução	Descrição
`[condition]`	Substitui a comparação padrão positiva, negativa ou zero da por outra expressão condicional. Por exemplo: `[<100]”Low”;[>1000]”High”;000` renderiza a palavra "Baixo" para valores abaixo de 100, "Alto" para valores acima de 1.000 e um (com zeros à esquerda) para qualquer item intermediário. As condições só podem ser aplicado aos dois primeiros subformatos e, se um número corresponder a mais de um, ele usa o primeiro que corresponde. Se houver um terceiro formato, usado para "todo o resto", caso contrário, se um número não corresponder ele será renderizado como todos os "#" preenchendo a largura da célula. Se existir, o o quarto formato é sempre usado para texto.
`[Color] or [Color#]`	Faz com que qualquer valor renderizado por esse subformato apareça com o cor de texto específica. Os valores válidos para `Color` são: preto, Azul, ciano, verde, magenta, vermelho, branco ou amarelo. Valores válidos para "#" em `Color#` são 0&ndash1;56 (esta paleta de cores mostra uma lista das cores que correspondem a cada número). Formato de número as cores substituem as cores inseridas pelo usuário na célula, mas não substituir as cores definidas pela formatação condicional.

Exemplos de formato de número

A tabela a seguir mostra alguns exemplos de padrões e as renderização de número formatado:

Número	Padrão	Valor formatado
12345,125	`####.#`	12345,1
12,34	`000.0000`	012,3400
12	`#.0#`	12.0
5,125	`# ???/???`	5 1/8
12000	`#,###`	12.000
1230000	`0.0,,"M"`	1,2 milhão
1234500000	`0.00e+00`	1,23e+09
123114.15115 MeuTexto	`###0.000;"TEXT: "_(@_)`	123114.151 TEXTO: MyText
1234 -1234 0 MyText	`[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_)`	1.234 1.234 0,0 MyText
1.005 32 527	`[>1000]"HIGH";[Color43][<=200]"LOW";0000`	ALTO BAIXO 0527