Data, hora, número e outras formatações

As informações desta página de ajuda se aplicam tanto a Studio quanto a Desktop Studio.

Esta página descreve as opções de formatação válidas para datas, horas e valores numéricos em Studio. Você pode usar as opções de formatação para definir como deseja que determinadas informações sejam formatadas na saída do seu script. Por exemplo, se sua organização deseja que as datas sejam exibidas de uma determinada maneira, você pode converter as datas de seu formato existente para o formato desejado usando a função datefmt() e os especificadores de formato de data nesta página.

Exemplos de muitos dos especificadores de formato nesta página estão disponíveis no script de exemplo para funções. Você pode baixar e importar o script e, em seguida, abrir as ações datefmt e format Snippet.

Formatos de data e hora

Use caracteres especificadores de formato quando precisar especificar o formato no qual deseja que uma açãoClosed Executa um processo em um script do Studio, como coletar dados de clientes ou reproduzir música. ou função de data/hora, como datefmt(), retorne um valor de data ou hora. Há caracteres especificadores para cada parte de um valor data/hora, como dia, mês, ano, hora, minuto e assim por diante.

Ao combinar caracteres especificadores com caracteres separadores, você pode definir como deseja que os valores de data/hora apareçam. Isto é útil se sua organização possui requisitos para a aparência de valores data/hora. Depois de saber qual formato de data/hora precisa, use os especificadores de formato definidos nesta seção para criar o formato no seu script.

A tabela a seguir mostra alguns exemplos de datas e horas com seus formatos correspondentes. A coluna Formato com especificadores mostra como você usaria os caracteres de especificadores de formato para construir cada exemplo de data/hora na coluna Estilo de data. Os caracteres especificadores, como M, d, h, s, entre outros, representam uma parte do valor de data/hora, como mês, dia, hora, e assim por diante.

Estilo de data Formatar com especificadores
04/04/2022 04:29:12 AM MM/dd/yyyy hh:mm:ss tt

29/6/2022 3:15:45 PM

M/d/yy h :m:s tt

Sáb 22 Abr 2023 ddd MMM dd yyyy
Quinta-feira, 15 de Junho de 2023 dddd, MMMM dd yyyy

O Studio suporta o formato de 24 horas, e não o de 12 horas. Leve isso em consideração ao trabalhar com horários em Scripts.

Automação OLE

Uma Data de Automação OLE Icon of a square with an arrow point from the center through the top right corner. é uma data escrita como um número de ponto flutuante. O lado esquerdo do ponto decimal é o número de dias desde a meia-noite de 30 de Dezembro de 1899. O lado direito do ponto decimal é o tempo naquele dia dividido por 24. Por exemplo, 6:00 da manhã de 31 de Dezembro de 1899 é 1,25.

Os tipos de data e hora de Automação OLE são usados em vários lugares nos Scripts do Studio. Algumas funções que lidam com datas e horas usam esse formato como entrada ou saída. Muitos dos formatos de data e hora descritos nesta página de ajuda usam tipos de data e hora de Automação OLE.

Formatação de Data e hora: Especificadores

Ao usar especificadores de formatação de data e hora, os seguintes detalhes são importantes:

  • Maiúsculas e minúsculas: a caixa do especificador altera a saída. Por exemplo, um f minúsculo resulta em um número de milissegundos que inclui um zero à direita, se aplicável. Um F maiúsculo remove os zeros à direita. Em outro exemplo, um m minúsculo produz os minutos, mas um M maiúsculo produz o mês.
  • O número de cada caractere que você incluir: Incluir um, dois ou mais caracteres de um especificador de formatação altera a saída. Por exemplo, usar um único h para a hora resulta em todas as horas de um único dígito sem zero à esquerda. Dois caracteres hh resultam em horas de um único dígito com zeros à esquerda.
  • Combinando caracteres ou usando sozinho: Para usar um único caractere especificador sozinho, sem outros especificadores, você deve prefixá-lo com um sinal de percentual %. Por exemplo, para gerar apenas os minutos, você usaria %m. Se não incluir o sinal de percentual, a formatação não funcionará. Se você usar um único especificador em combinação com outros especificadores, não é necessário incluir o sinal de percentual. Por exemplo, se o seu formato incluir as horas e um único m, como em hh:m, não é necessário o sinal de percentual.

Todos os caracteres não especificadores incluídos na especificação de formato de data/hora são passados para a saída e não afetam o valor de data/hora. Você pode usar isso para separar as partes do valor data/hora. Os dois pontos (:) e a barra para frente (/) são tradicionalmente usadas para separar partes de um valor data/hora. Você pode usar qualquer separador que quiser nos formatos que especificar, incluiindo caracteres não tradicionais como um traço (-).

Por exemplo, se você quisesse separar a data e a hora com um caractere de barra vertical, você poderia incluí-lo no formato e ele seria adicionado à saída. Os dois pontos e a barra para frente podem ser necessários dependendo da função que você usa. Por exemplo, a função asdatetime() requer esses caracteres.

A ser representado Especificador de Formatação Detalhes
Dia d

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 %.

dd

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.

ddd Representa o nome abreviado do dia da semana: qui.
dddd Representa o nome completo do dia da semana: Quinta-feira.
Mês M

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 utilizado isoladamente, insira o prefixo %.

MM

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.

MMM Representa o nome abreviado do mês: Out.
MMMM Representa o nome completo do mês: Outubro.
Ano y

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

Se o ano tiver mais que dois dígitos, somente os dois dígitos de ordem inferior aparecem 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.

yy

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

Se o ano tiver mais que dois dígitos, somente 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 usado isoladamente, adicione o prefixo %.

yyy

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

Se o ano tiver mais de três dígitos significativos, eles sã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.

yyyy

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

Se o ano tiver mais que quatro dígitos, somente os quatro dígitos de ordem inferior aparecem 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.

yyyyy

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

Se o ano tiver mais de cinco dígitos, somente os cinco dígitos de ordem inferior aparecem 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 é preenchido com quantos zeros à esquerda forem necessários para atingir o número de especificadores y. Por exemplo, se houver oito especificadores y, a saída será 00002023.

Período ou Era g, gg (mais qualquer número de especificadores g adicionais)

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.

Um único g não pode ser usado isoladamente. Se você quiser gerar a saída apenas do nome da era ou período, use um gg duplo.

Hora (relógio de 12 horas) h

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 usado isoladamente, prefixe com %.

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

hh

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 único dígito é formatada com um zero à esquerda.

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

Hora (relógio de 24 horas) H

Representa a hora como um número de 0 a 23 em um relógio de 24 horas que conta 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 usado isoladamente, prefixe com %.

HH

Representa a hora como um número de dois dígitos de 00 a 23 em um relógio de 24 horas que conta 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.

Minuto m

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 usado isoladamente, adicione o prefixo com %.

mm

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.

Segundo s

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 usar sozinho, prefixe com %.

ss

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.

Segundos fracionais ff, F

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

Este especificador funciona somente com datas/horas de automação OLEClosed Uma forma de gravar 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 caracteres inclui determina quantos dígitos significativos da segunda fração incluir:

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

Quanto mais precisão você especificar, menos confiável ou significativa ela poderá ser. A precisão do valor de hora depende da resolução do relógio do sistema do computador.

AM/PM t

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 uma designação AM/PM em que o primeiro caractere é o mesmo e o segundo caractere muda, use o especificador tt.

Se usado isoladamente, adicione o prefixo %.

tt

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.

Deslocamento local em relação à UTC z

Representa o deslocamento com sinal do fuso horário do sistema operacional local em relação ao tempo Universal Coordenado (UTC). O número de caracteres z define quanto do deslocamento será exibido:

  • z, zz: Mede o deslocamento em horas.
  • zzz: Mede o deslocamento 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 único dígito é formatado com um zero à esquerda.

Se usado isoladamente, prefixe com %.

Formatos numéricos

Use estes caracteres especificadores de formato quando precisar definir o formato que deseja que uma açãoClosed Executa um processo em um script do Studio, como coletar dados de clientes ou reproduzir música. ou função, como format(), retorne em um valor numérico. Existem caracteres especificadores para muitos usos, como moeda, porcentagens, números de ponto fixo e muito mais.

Especificador de precisão

Muitos dos especificadores de formato descritos nesta seção aceitam um especificador de precisão. O especificador de precisão permite definir o número de dígitos após o ponto decimal a serem incluídos na saída.

Um especificador de precisão é um número que você inclui após o especificador de formato. No exemplo a seguir, C é o especificador de formato e 3 é o especificador de precisão.Isso indica que a saída terá três dígitos após o ponto decimal.

ASSIGN CurrencyResultBigC = "{StringVal.format('C3')}"

Dado um número inicial de 0013001.93912837, a saída deste exemplo é $13,001.939.

Especificadores numéricos

Tipo de número Especificador de Formatação Detalhes Descrição
Moeda C ou c

O número é convertido em uma cadeia de caracteres que representa um valor em moeda. 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

Notação exponencial (científica) E or e

E0

E-0

e0

e+0

e-0

O número é convertido em uma string no formato -d.ddd…E+ddd ou -d.ddd…e+ddd, em que 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 o ponto decimal.

Inclua um número com o especificador de formato para indicar a quantidade de dígitos que você deseja após o ponto decimal. Se não incluir o especificador de precisão, o script usará o padrão de seis casas decimais.

O tipo de letra (maiúscula ou minúscula) do especificador de formato indica se o expoente na saída tem o prefixo um E ou um e. O expoente sempre consiste em um sinal de mais ou de 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 qualquer 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, o número será formatado usando notação científica com um E ou e inserido entre o número e o expoente.

O número de caracteres de 0 que seguem o indicador de notação científica determina o número mínimo de dígitos a serem gerados 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

Ponto fixo F ou f

O número é convertido em uma cadeia de caracteres na forma -ddd.ddd…, em que 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

Geral G ou g

O número é convertido para a notação em ponto fixo ou científica mais compacta, dependendo do tipo do número e de um especificador de precisão estar incluído. Se o especificador de precisão for omitido ou for 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
  • Dobro: 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 à direita 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 à direita excedentes 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 é 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

Hexadecimal X ou x

Este formato é suportado somente para tipos integrais. A quantidade é convertida em uma cadeia 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.

Número N ou n

O número é convertido em uma cadeia de caracteres no formato -d,ddd,ddd.ddd…, em que:

  • O sinal de menos ( - ) 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 é 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

Percentual P ou p

O número é convertido em uma cadeia de caracteres que representa um percentual. 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 é 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%

Round-Trip R ou r

Este formato é suportado somente para os tipos Single e Double. O especificador round-trip garante que um valor numérico convertido em uma cadeia de caracteres seja analisado novamente no mesmo valor numérico. Quando um valor numérico é formatado usando esse especificador, ele é primeiro testado usando o formato geral, com 15 posições de precisão para um Double e 7 posições de precisão para um Single. Se o valor for analisado novamente com sucesso no mesmo valor numérico, ele será formatado usando o especificador de formato geral. No entanto, se o valor não for analisado novamente com sucesso no mesmo valor numérico, então o valor será formatado usando 17 dígitos de precisão para um Double e 9 dígitos de precisão para um Single.

Embora um especificador de precisão possa estar presente, ele é ignorado. Os trajetos de ida e volta têm precedência sobre a precisão quando esse especificador é usado.

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

Resultado:

ROUNDTRIPRESULT=13001.93912837

Zero Placeholder 0

Use um ou mais placeholders zero para definir o formato dos 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 tiver um número na posição em que aparece um 0 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 cadeia de formato, 0 aparece na cadeia de saída em vez disso.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')

Os resultados do exemplo são:

zeroPlaceholders = 2,343,456.23

doubleZeroSpecifier = 456

Marcador de posição de dígito #

Use um ou mais espaços reservados de dígitos para definir o formato dos 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 tiver um número na posição em que um # aparece na cadeia de formato, esse número aparecerá no resultado de saída. Se nenhum número aparecer na posição em que um # aparece na cadeia de formato, esse local ficará vazio na cadeia de saída.

Se o número que está sendo formatado contiver um 0 como dígito significativo, o 0 aparecerá na cadeia de saída. Se o 0 não for um dígito significativo, ele não aparecerá na cadeia de saída, mesmo que 0 seja o único número na cadeia 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('##')

Os resultados deste exemplo são:

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

Ponto decimal .

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

Separador de milhares e escala de número ,

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

Especificador de separador de milhar: Se um ou mais caracteres de vírgula ( , ) forem especificados entre dois marcadores de posição de dígito (0 ou #) que formatam os dígitos integrais de um número, um caractere separador de grupo é inserido entre cada grupo de números na parte integral da saída. Por exemplo, se a cadeia de caracteres #,# 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 é dividido por 1000 para cada especificador de escala numérica. Por exemplo, se a cadeia 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.

Separador de seção ;

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 pelo caractere 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.##')	

Os resultados deste 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 do meio define 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')

Os resultados do exemplo são:

sectionSeparator1 = 1,789,789

sectionSeparator2 = 000.0000

sectionSeparator3 = 4321

Todos os outros Caracteres Outro

Todos os outros caracteres

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

Sequências de escape

Studio suporta sequências de escape dentro de constantes de string. sequências de escape permitem que você inclua determinados caracteres especiais em uma cadeia de Caracteres. caracteres como aspas duplas ou uma chave de abertura são reconhecidos como código. Quando são incluídos em uma string, o compilador os interpreta com o significado do código não literal, em vez de seu valor literal. As sequências de escape permitem incluir esses caracteres em strings.Se você incluir esses caracteres em strings sem uma sequência de escape, a saída não será o que você espera, e um erro poderá ocorrer.

Não é preciso adicionar sequências de escape a strings que contêm XML ou JSON convertido. sequências de escape são automaticamente adicionadas para caracteres que precisam delas.

Prefix any string where you use an escape sequence with a dollar sign ($): $"...". Within the double quotes, you can use any of the following escape sequences:

Sequência Detalhes
\" Incorpore uma citação dupla.
\' Incorpore uma única citação.
\ t Incorpore uma tab (ASCII 9).
\ r Incorpore um retorno de carro (ASCII 13).
\ n Incorpore um avanço de linha (ASCII 10).
\ b Incorpore um backspace (ASCII 8).
\{ Incorpore uma chave aberta. Você só precisa escapar a chave de fechamento se não houver uma chave aberta escapada no texto antes dela. Se você precisar escapar uma chave de fechamento, ela ficará assim: \}
\ 0 Incorpore um nulo (0 é um zero).

O exemplo a seguir usa a sequência de escape \n para adicionar um avanço de linha à string. Isso move o cursor para a próxima linha sem retornar ao início da linha.

x = $"A phrase\nAnd a new line" 

Quando a string é impressa, a saída tem esta aparência:

Uma frase

E uma nova line ]

No exemplo anterior, o colchete quadrado de fechamento representa o cursor.

O exemplo a seguir usa a sequência de escape \" para incluir aspas duplas na string:

y = $"Embedding \"double quotes\" in a string."

Quando a string é imprimida, ela tem este aspecto: Incorporando "aspas duplas" em uma string. Sem a sequência de escape, o script reconheceria a string somente até o símbolo de aspas duplas antes da palavra double.

O exemplo a seguir usa a sequência de escape \{ para incluir chaves literais na string:

z = $"Using \{curly} braces."

Quando a string é imprimida, ela tem este aspecto: Usando chaves {curly}. Sem a sequência de escape, o script teria interpretado {curly} como uma variável. Quando nenhum valor for encontrado para a variável curly, o script a substituiria por nada, portanto o valor da variável seria Usando chaves.

Outros Caracteres

Caractere Descrição
" Representa uma string entre aspas (aspas). Exibe o valor literal de qualquer string entre duas aspas ("). Use o caractere de escape (\) em qualquer lugar do seu script onde você precisar exibir uma marca de aspas literal.
' Representa uma string entre aspas (apóstrofo). Exibe o valor literal de qualquer string entre dois caracteres apóstrofos ('). Use o caractere de escape (\) em qualquer lugar do seu script onde você precisar exibir um caractere de apóstrofo literal.
$

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 prefixar um valor para declará-lo como tipo de data/hora. O caractere # deve estar fora das aspas duplas. Por exemplo:

ASSIGN var = #"02/09/2023"

% Use com especificadores de formato data/hora quando usar um especificador único isoladamente. O caractere % é colocado diretamente antes do caractere de especificador de formato. Por exemplo, para gerar a saída apenas dos minutos, use %m.