Formatação de data, hora, números e outros

Representa o dia do mês como um número de 1 a 31: 27.

Um dia de um dígito é formatado sem um zero à esquerda: 3.

Se usada isoladamente, adicione o prefixo %.

Representa o dia do mês como um número de dois dígitos de 01 a 31: 27.

Um dia de um dígito é formatado com um zero à esquerda: 03.

Representa o mês como um número de 1 a 12: 11.

Um mês de um dígito é formatado sem um zero à esquerda: 5.

Se usada isoladamente, adicione o prefixo %.

Representa o mês como um número de dois dígitos de 01 a 12: 11.

Um mês de um único dígito é formatado com um zero à esquerda: 05.

Representa o ano como um número de um ou dois dígitos: 23.

Se o ano tiver mais de dois dígitos, apenas os dois dígitos de ordem inferior aparecerão no resultado. Por exemplo, para o ano 2023, 23 aparecerá.

Se o primeiro dígito de um ano de dois dígitos começar com um zero (por exemplo, 02), o número será formatado sem um zero à esquerda: 2.

Representa o ano como um número de dois dígitos: 23.

Se o ano tiver mais de dois dígitos, apenas os dois dígitos de ordem inferior aparecerão no resultado. Por exemplo, para o ano 2023, 23 aparecerá.

Se o ano de dois dígitos tiver menos de dois dígitos significativos, o número será preenchido com zeros à esquerda para obter dois dígitos: 02.

Se usada isoladamente, adicione o prefixo %.

Representa o ano com um mínimo três dígitos: 2023.

Se o ano tiver mais de três dígitos significativos, eles serão incluídos na string de resultado. Se o ano tiver menos de três dígitos, o número será preenchido com zeros à esquerda para obter três dígitos.

Nota: Para o calendário budista tailandês, que pode ter anos de cinco dígitos, esse especificador de formato exibe todos os cinco dígitos.

Representa o ano como um número de quatro dígitos: 2023.

Se o ano tiver mais de quatro dígitos, apenas os quatro dígitos de ordem inferior aparecerão no resultado. Se o ano tiver menos de quatro dígitos, o número será preenchido com zeros à esquerda para atingir quatro dígitos.

Nota: Para o calendário budista tailandês, que pode ter anos de cinco dígitos, esse especificador de formato exibe todos os cinco dígitos.

Representa o ano como um número de cinco dígitos.

Se o ano tiver mais de cinco dígitos, apenas os cinco dígitos de ordem inferior aparecerão no resultado. Se o ano tiver menos de cinco dígitos, o número será preenchido com zeros à esquerda para obter cinco dígitos: 02023.

Se houver mais de cinco especificadores y, o número será preenchido com tantos zeros à esquerda forem necessários para atingir o número de especificadores y. Por exemplo, se houver oito especificadores y (ano), a saída será 00002023.

Representa o período ou a era, como a.C. O script ignora este especificador se a data a ser formatada não tiver uma string de período ou era associada.

Uma g única não pode ser usada isoladamente. Caso queira que a saída seja apenas o nome da era ou período, use um duplo gg.

Representa a hora como um número de 1 a 12 em um relógio de 12 horas que conta todas as horas desde a meia-noite ou meio-dia.

Uma determinada hora depois da meia-noite é indistinguível da mesma hora depois do meio-dia. Por exemplo, 1:00 AM é o mesmo que 1:00 PM.

A hora não é arredondada e uma hora de um dígito é formatada sem um zero à esquerda.

Se usada isoladamente, adicione o prefixo %.

Por exemplo, dada a hora 5:43, este especificador de formato personalizado exibe 5.

Representa a hora como um número de dois dígitos de 01 a 12 em um relógio de 12 horas que conta todas as horas desde a meia-noite ou meio-dia.

Uma determinada hora depois da meia-noite é indistinguível da mesma hora depois do meio-dia. Por exemplo, 1:00 AM é o mesmo que 1:00 PM.

A hora não é arredondada e uma hora de um dígito é formatada com um zero à esquerda.

Por exemplo, dada a hora 5:43, este especificador de formato personalizado exibe 05.

Representa a hora como um número de 0 a 23 em um relógio de 24 horas que conta todas as horas desde a meia-noite.

Uma hora de um dígito é formatada sem um zero à esquerda.

Por exemplo, dada a hora 5:43 PM, este especificador de formato personalizado exibe 17.

Se usada isoladamente, adicione o prefixo %.

Representa a hora como um número de dois dígitos de 00 a 23 em um relógio de 24 horas que conta todas as horas desde a meia-noite.

Uma hora de um dígito é formatada com um zero à esquerda.

Por exemplo, dada a hora 5:43 PM, este especificador de formato personalizado exibe 17.

Representa o minuto como um número de 0 a 59.

O minuto representa minutos inteiros que se passaram desde a última hora. Um minuto de um dígito é formatado sem um zero à esquerda.

Por exemplo, dada a hora 5:43:34, este especificador de formato personalizado exibe 43.

Se usada isoladamente, adicione o prefixo %.

Representa o minuto como um número dois dígitos de 00 a 59.

O minuto representa minutos inteiros que se passaram desde a última hora. Um minuto de um dígito é formatado com um zero à esquerda.

Por exemplo, dada a hora 5:03:34, este especificador de formato personalizado exibe 03.

Representa os segundos como um número de 0 a 59.

O resultado representa segundos inteiros que se passaram desde o último minuto. Um segundo de um dígito é formatado sem um zero à esquerda.

Por exemplo, dada a hora 5:43:04, este especificador de formato personalizado exibe 4.

Se usado isoladamente, adicione o prefixo %.

Representa os segundos como um número de dois dígitos de 00 a 59.

O resultado representa segundos inteiros que se passaram desde o último minuto. Um segundo de um dígito é formatado com um zero à esquerda.

Por exemplo, dada a hora 5:43:04, este especificador de formato personalizado exibe 04.

Representa um número de dígitos de fração de segundos. Especificadores f em letra minúscula incluem os zeros à esquerda. Especificadores F em letra maiúscula omitem zeros à esquerda.

Este especificador funciona somente com datas/horas de automação OLE Uma maneira de escrever datas como um inteiro de ponto flutuante. Indica o número de dias desde 30 de dezembro de 1899..

O número de f ou F que os caracteres incluem determinam quantos dígitos significantes a fração de segundo deve incluir:

• F: Décimos de segundo, ou o dígito mais significante. Se o dígito for um zero, nada será exibido.
• ff ou FF: Centésimos de segundo, ou dois dígitos significantes.
• fff ou FFF: Milésimos de segundo, ou três dígitos significantes. Estes também são chamados de milissegundos.
• ffff ou FFFF: Dezenas de milésimos de segundo, ou quatro dígitos significantes.
• fffff ou FFFFF: Centenas de milésimos de segundo, ou cinco dígitos significantes.
• ffffff ou FFFFFF: Milionésimos de segundo, ou seis dígitos significantes.
• FFFFFFF: Dezenas de milionésimos de segundo, ou sete dígitos significantes.

Quanto maior a precisão que especificar, menos confiável ou significante ela vai ser. A precisão dos valores de tempo depende da resolução do relógio de sistema do computador.

Representa o primeiro caractere do designador AM/PM. O designador AM é usado se a hora no horário que está sendo formatado for menor que 12. Caso contrário, o designador PM é usado.

Para idiomas que usam o designador AM/PM onde o primeiro caractere é o mesmo e o segundo muda, use o especificador tt.

Se usada isoladamente, adicione o prefixo %.

Representa o designador AM/PM. O designador AM é usado se a hora no horário que está sendo formatado for menor que 12. Caso contrário, o designador PM é usado.

Use o especificador tt para idiomas como o japonês, que usam o designador AM/PM onde o primeiro caractere é o mesmo e o segundo muda.

Representa a dedução assinada do fuso horário do sistema operacional local do Tempo Universal Coordenado (UTC). O número de caracteres z determinam quanto da dedução exibir:

• z, zz: Medem a dedução em horas.
• zzz: Medem a dedução em horas e minutos.

O deslocamento é sempre exibido com um sinal à esquerda. Um sinal de mais (+) indica horas à frente e um sinal de menos (-) indica horas atrás do UTC. O deslocamento varia de –12 a +13. Um deslocamento de um dígito é formatado com um zero à esquerda.

Se usada isoladamente, adicione o prefixo %.

O número é convertido em uma string que representa um valor monetário. Inclua um número com o especificador de formato para indicar o número de casas decimais que você quer que o número tenha. Letras maiúsculas ou minúsculas no especificador de formato não afetam os resultados.

ASSIGN StringVal = "0013001.93912837"
ASSIGN CurrencyResult = "{StringVal.format('C')}"
ASSIGN CurrencyResult3 = "{StringVal.format('C3')}"

Resultado:

CURRENCYRESULT=$13,001.94

CURRENCYRESULT3=$13,001.939

E0

E-0

e0

e+0

e-0

O número é convertido em uma string na forma -d.ddd…E+ddd ou -d.ddd…e+ddd, onde cada d indica um dígito (0-9). A string começa com um sinal de menos se o número for negativo. Um dígito sempre precede a vírgula decimal.

Inclua um número com o especificador de formato para indicar o número de dígitos que quer depois do ponto decimal. Se não incluir o especificador de precisão, o script usará o padrão de seis casas decimais.

Letras maiúsculas ou minúsculas no especificador de formato indicam se o expoente da saída tem um prefixo E ou um e. O expoente sempre consiste em um sinal de mais ou menos e um mínimo de três dígitos. O expoente é preenchido com zeros para atender a esse mínimo, se necessário.

Se uma das strings E, E+, E-, e, e+ ou e- estiver presente na string de formato e for seguida imediatamente por pelo menos um caractere 0, então o número é formatado usando notação científica com um E ou e inserido entre o número e o expoente.

O número de caracteres 0 após o indicador de notação científica determina o número mínimo de dígitos a serem produzidos para o expoente. Os formatos E+ e e+ indicam que um caractere de sinal (adição ou subtração) deve sempre preceder o expoente. Os formatos E, E-, e ou e- indicam que um caractere de sinal deve preceder apenas os expoentes negativos.

 ASSIGN StringVal = "0013001.93912837"
ASSIGN ScientificResult = "{StringVal.format('e')}"		
ASSIGN ScientificResult = "{StringVal.format('E2')}"	

Resultado:

SCIENTIFICRESULT=1.300194e+004

SCIENTIFICRESULT2=1.300194E+004

O número é convertido em uma string na forma -ddd.ddd…, onde cada d indica um dígito (0-9). A string começa com um sinal de menos se o número for negativo.

Inclua um número com o especificador de formato para indicar quantas casas decimais você quer que o resultado tenha. Sem o indicador de precisão, o script usará o padrão de duas casas decimais.

ASSIGN StringVal = "0013001.93912837"
ASSIGN FixedPointResult = "{StringVal.format('F3')}"
ASSIGN FixedPointResult2 = "{StringVal.format('f')}"

Resultado:

FIXEDPOINTRESULT=13001.939

FIXEDPOINTRESULT2=13001.94

O número é convertido para o mais compacto em notação científica ou ponto fixo, dependendo do tipo do número e se um especificador de precisão está presente. Se o especificador de precisão for omitido ou zero, o tipo do número determina a precisão padrão, conforme indicado pela lista a seguir:

• Byte ou SByte: 3
• Int16 ou UInt16: 5
• Int32 ou UInt32: 10
• Int64 ou UInt64: 19
• Único: 7
• Duplo: 15
• Decimal: 29

A notação de ponto fixo é usada se o expoente que resultaria da expressão do número em notação científica for maior que -5 e menor que o especificador de precisão; caso contrário, a notação científica é usada. O resultado contém um ponto decimal se necessário e os zeros finais são omitidos.

Se o especificador de precisão estiver presente e o número de dígitos significativos no resultado exceder a precisão especificada, os dígitos restantes em excesso serão removidos por arredondamento. A exceção a esta regra é se o número for um decimal e o especificador de precisão for omitido. Nesse caso, a notação de ponto fixo é sempre usada e os zeros à direita são preservados.

Se a notação científica for usada, o expoente no resultado será prefixado com E se o especificador de formato for G, ou com e se o especificador de formato for g.

ASSIGN StringVal = "0013001.93912837"
ASSIGN GeneralResult1 = "{StringVal.format('G')}"
ASSIGN StringVal2 = 6002348902348890234.234432234
ASSIGN GeneralResult2 = "{StringVal2.format('G')}"

Resultado:

GENERALRESULT1=13001.93912837

GENERALRESULT2=6.00234890234889E+18

Este formato é compatível apenas com tipos integrais. O número é convertido em uma string de dígitos hexadecimais. O caso do especificador de formato indica se deve usar caracteres maiúsculos ou minúsculos para os dígitos hexadecimais maiores que 9. Por exemplo, use X para produzir ABCDEF e x para produzir abcdef.

O especificador de precisão indica o número mínimo de dígitos desejados na string resultante. Se necessário, o número é preenchido com zeros à sua esquerda para produzir o número de dígitos fornecido pelo especificador de precisão.

O número é convertido em uma string na forma -d,ddd,ddd.ddd…, onde:

• O sinal de subtração ( - ) indica um símbolo de número negativo, se necessário.
• Cada d representa um dígito (0-9).
• Uma vírgula ( , ) indica um separador de milhar entre grupos de números.
• O ponto ( . ) indica um símbolo de ponto decimal.

Inclua um especificador de precisão para indicar o número de casas decimais que você quer que o resultado tenha. Se nenhum especificador de precisão for incluído, o padrão é de duas casas decimais. Se o número não incluir um ponto decimal, .00 será adicionado ao número de saída.

ASSIGN StringVal = "0013001.93912837"
ASSIGN NumberResult = StringVal.format('N')
ASSIGN NumberResult2 = "{StringVal.format('n2')}"

Resultado:

NUMBERRESULT=13,001.94

NUMBERRESULT2=13,001.9391

O número é convertido em uma string que representa uma porcentagem. O número convertido é multiplicado por 100 para ser apresentado como uma porcentagem.

Inclua um especificador de precisão para indicar o número de casas decimais que você quer que o resultado tenha. Se nenhum especificador de precisão for incluído, o padrão é de duas casas decimais. Se o número não incluir um ponto decimal, .00 será adicionado ao número de saída.

ASSIGN StringVal = "0013001.93912837"
ASSIGN PercentResult = "{StringVal.format('P')}"
ASSIGN PercentResult2 = StringVal.format('P2')	

Resultado:

PERCENTRESULT=1,300,193.91%

PERCENTRESULT2=1,300,193.91%

Este formato é compatível apenas com os tipos Único e Duplo. O especificador de ida e volta garante que um valor numérico convertido em uma string será analisado de volta no mesmo valor numérico. Quando um valor numérico é formatado usando este especificador, ele é primeiro testado usando o formato geral, com 15 espaços de precisão para um Duplo e 7 espaços de precisão para um Único. Se o valor for analisado com êxito de volta para o mesmo valor numérico, ele será formatado usando o especificador de formato geral. No entanto, se o valor não for analisado com êxito de volta para o mesmo valor numérico, o valor será formatado usando 17 dígitos de precisão para um Duplo e 9 dígitos de precisão para um Único.

Embora um especificador de precisão possa estar presente, ele é ignorado. As viagens de ida e volta têm precedência sobre a precisão ao usar este especificador.

ASSIGN StringVal = "0013001.93912837"
ASSIGN RoundTripResult = "{StringVal.format('R')}"	

Resultado:

ROUNDTRIPRESULT=13001.93912837

Use um ou mais marcadores de posição zero para definir o formato para números na saída. Você pode combinar este marcador de posição com outros caracteres de marcadores de posição definidos nesta tabela.

Se o valor que está sendo formatado possuir um número na posição em que um 0 aparece na string de formato, esse número aparecerá na string de saída. Se nenhum número aparecer na posição em que um 0 aparece na string de formato, 0 aparecerá na string de saída. Isto pode ser útil para adicionar zeros a um número que precisa de zeros à esquerda mas não os tem.

A posição do 0 mais à esquerda antes do ponto decimal e do 0 mais à direita depois do ponto decimal determina o número de dígitos que estão sempre presentes na string de saída.

O especificador 00 faz com que o valor seja arredondado para o número inteiro mais próximo.

ASSIGN number = "2343456.2343"
ASSIGN zeroPlaceholders = "number.format(000,000.00)
ASSIGN number = "456.47"
ASSIGN doubleZeroSpecifier = number.format('00')

O(s) resultados do exemplo são

zeroPlaceholders = 2,343,456.23

doubleZeroSpecifier = 456

Use um ou mais marcadores de posição de dígito para definir o formato para números na saída. Você pode combinar este marcador de posição com outros caracteres de marcadores de posição definidos nesta tabela.

Se o valor que está sendo formatado possuir um número na posição em que um # aparece na string de formato, esse número aparecerá na string resultante. Se nenhum número aparecer na posição em que um # aparece na string de formato, o lugar estará vazio na string de saída.

Se o número que está sendo formatado contiver um 0 como um dígito significante, o 0 aparecerá na string de saída. Se o 0 não for um dígito significante, ele não aparecerá na string de saída, mesmo se 0 for o único número na string a ser formatada.

A string de formato ## faz com que o valor seja arredondado para o número inteiro mais próximo.

ASSIGN number = "2343456.2043"
ASSIGN digitPlaceholders = "number.format(###,###.##)
ASSIGN number = "456.47"
ASSIGN doubleDigitSpecifier = number.format('##')

O(s) resultados do exemplo são

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

O primeiro caractere de ponto ( . ) na string de formato determina a localização do separador decimal no valor formatado. Quaisquer outros caracteres de ponto adicionados serão ignorados.

O caractere de vírgula ( , ) funciona tanto quanto um especificador de separador de milhar quanto um especificador de escala numérica.

Especificador de separador de milhar: Se um ou mais caracteres de vírgula ( , ) forem especificados entre marcadores de posição de dois dígitos (0 ou #) que formatam os dígitos inteiros de um número, um caractere separador de grupo será inserido entre cada grupo de número na parte integral da saída. Por exemplo, se a string #, # e a cultura invariável forem usadas para formatar o número 1000, a saída será 1.000.

Especificador de escala numérica: Se um ou mais caracteres de vírgula ( , ) forem especificados imediatamente à esquerda do ponto decimal explícito ou implícito, o número a ser formatado será dividido por 1000 para cada especificador de escala numérica. Por exemplo, se a string 0,, for usada para formatar o número 100 milhões, a saída será 100.

Você pode usar separadores de milhar e especificadores de escala numérica na mesma string de formato. Por exemplo, se a string #,0,, e a cultura invariável forem usadas para formatar o número um bilhão, a saída será 1,000.

Permite que você defina duas ou três opções de formatação possíveis para números. A formatação é aplicada dependendo se o número é positivo, negativo ou zero.

As opções de formatação são definidas em uma única string. Cada opção é separada por um caractere de ponto e vírgula ( ; ). Use os marcadores de posição de zero, dígito, milhares e decimais para definir o formato, conforme mostrado nos exemplos abaixo. Esses marcadores de posição são descritos nesta tabela.

Se houver duas seções na string de formato personalizada:

• A seção à esquerda definirá a formatação de números zero e positivos.
• A seção à direita definirá a formatação de números negativos.

Por exemplo:

ASSIGN number9 = 928374
ASSIGN sectionSeparator4 = number9.format('000,000.##;00.##')

ASSIGN number10 = -998822.25
ASSIGN sectionSeparator5 = number10.format('000,000.##;00.##')

ASSIGN number11 = 0
ASSIGN sectionSeparator6 = number11.format('000,000.##;00.##')	

O(s) resultados do exemplo são

sectionSeparator4 = 928,374

sectionSeparator5 = 998822.25

sectionSeparator6 = 000,000

Se houver três seções:

• A seção à esquerda definirá a formatação de números positivos.
• A seção ao meio definirá a formatação de números negativos.
• A seção à direita definirá a formatação de números zero.

Por exemplo:

ASSIGN number1 = 1789789
ASSIGN sectionSeparator1 = number1.format('000,000.##;00.##;000.0000')

ASSIGN number2 = 0
ASSIGN sectionSeparator2 = number2.format('000,000.##;00.##;000.0000')

ASSIGN number3 = -4321
ASSIGN sectionSeparator3 = number3.format('000,000.##;00.##;000.0000')

O(s) resultados do exemplo são

sectionSeparator1 = 1,789,789

sectionSeparator2 = 000.0000

sectionSeparator3 = 4321

Todos os outros caracteres

Qualquer outro caractere é copiado para a string de resultado e não afeta a formatação.

Use para adicionar um prefixo a uma string que inclui uma sequência de escape. O caractere $ deve estar fora das aspas duplas. Por exemplo:

z = $"Use the \{myVar} variable."

Use para adicionar um prefixo de valor para declará-lo como um tipo de data/hora. O caractere # deve estar fora das aspas duplas. Por exemplo:

ASSIGN var = #"02/09/2023"