Formatos de data e número

Com os formatos de data e hora e de número, você controla como seus dados aparecem em uma planilha. O app Planilhas Google oferece alguns formatos comuns, mas você também pode definir os seus.

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

Esta página descreve como definir novos padrões de formato de data e número, que podem ser incluídos na solicitação da API. O exemplo Definir um formato decimal ou de data e hora personalizado para um intervalo mostra como definir um padrão de formato usando a API. A renderização real do formato depende do locale da planilha. Este guia pressupõe que locale seja en_US. É possível determinar o locale de uma planilha lendo o SpreadsheetProperties com uma solicitação spreadsheets.get.

Sobre os valores de data e hora

O Planilhas, como a maioria dos outros aplicativos de planilhas, trata valores de data e hora como valores decimais. Isso permite que você realize operações aritméticas neles em fórmulas, para que você possa incrementar dias ou semanas, adicionar ou subtrair duas datas e horários e realizar outras operações semelhantes.

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

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

Padrões de formato de data e hora

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

Tokens de formato de data e hora

A tabela a seguir define as substrings de token que podem ser usadas em um padrão de formato de data e hora. Um caractere + indica que o caractere anterior pode aparecer uma ou mais vezes e ainda corresponder ao padrão. Os caracteres não listados na tabela abaixo são tratados como literais e são exibidos sem alterações.

Exemplos de formato de data e hora

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

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ídas pelas representações numéricas correspondentes. Um padrão de formato de número pode ter até quatro seções, separadas por ponto e vírgula, que definem os formatos separados usados para números positivos, negativos, zero e texto (nessa ordem):

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

Não é necessário incluir as quatro seções em um formato. Se você incluir apenas uma seção, esse formato será usado para todos os valores. O uso de duas seções faz com que o primeiro formato seja aplicado a números positivos e zero, e o segundo formato a números negativos. O uso de três seções define formatos separados para números positivos, negativos 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 última for um formato de texto, ela será tratada como o formato de texto, e as outras se comportarão como se houvesse uma seção a menos. Assim, ao incluir um formato de texto final, é possível 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 outras análises. Portanto, é possível incluir um formato de data ou hora como uma das seções, embora isso seja de 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 dessa seção.

Metainstruções

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

Exemplos de formato de número

A tabela a seguir mostra alguns exemplos de padrões e a renderização de números formatados correspondentes: