Olá galera o/

Hoje iremos falar sobre a função FORMAT. Como podemos utiliza-lá, seus parâmetros e mostrar exemplos.

A função FORMAT () formata um valor com o formato especificado (mascara) e uma cultura opcional. Esta função formata valores de data / hora e valores numéricos.

A mesma pode receber até 3 parâmetros.  O primeiro parâmetro é o valor a ser formatado, o segundo parâmetro é a mascara que o valor será formatado e o terceiro parâmetro é opcional, sendo a cultura do valor que será formatado.

Obs.: Esta função foi implementada a partir da versão 2012 do SQL Server.

SINTAXE:

FORMAT(parametro1, parametro2, parametro3)

Iremos executar 3 exemplos para mostrar a utilização do FORMAT() de forma intuitiva.

Ex1: Declaramos uma variável do tipo BIGTINT, essa variável recebe um valor inteiro. O primeiro parâmetro é o valor da variável, no segundo parâmetro foi adicionado o tipo de mascara que você desejamos retorna, sendo a mascara +00 (00) 0 0000-0000.

DECLARE @VALUE BIGINT
SET @VALUE = 5581912345678

SELECT FORMAT(@VALUE, ‘+## (##)# ####-####’) AS EXAMPLE1

Exemplo FORMAT 1
Exemplo FORMAT 1

Ex2: Declaramos uma variável do tipo DATETIME, essa variável recebe o valor do GETDATE(). Utilizamos várias formatações para a mesma data, além disso, utilizamos o parâmetro opcional para informar a cultura que desejamos.

DECLARE @DATE DATETIME
SET @DATE = GETDATE()

SELECT @DATE DATE_SYSTEM
,FORMAT (@DATE, ‘yyyyMMdd’) EXAMPLE1
,FORMAT (@DATE, ‘yyyyMMddHHmm’) EXAMPLE2
,FORMAT (@DATE, ‘HH:MM ddMMyyyy’) EXAMPLE3
,FORMAT (@DATE, ‘D’, ‘PT-BR’) EXAMPLE4
,FORMAT (@DATE, ‘d’, ‘EN-US’) EXAMPLE5

Exemplo FORMAT 2
Exemplo FORMAT 2

Ex3: Declaramos uma variável do tipo MONEY, essa variável recebe o valor do 99.5. O valor da variável foi formatado para exibir a mascara do Real Brasileiro, Dollar Americano e o Euro Alemão, baseado na cultura da moeda.

DECLARE @VALUE MONEY
SET @VALUE = 99.5

SELECT FORMAT(@VALUE, ‘c’, ‘PT-BR’) AS EXAMPLE1
,FORMAT(@VALUE, ‘c’, ‘EN-US’) AS EXAMPLE2
,FORMAT(@VALUE, ‘c’, ‘DE-DE’) AS EXAMPLE3

Exemplo FORMAT 3
Exemplo FORMAT 3

 

Baixo segue links sobre os formatos aceitos e culturas que podem ser utilizadas.

Lista de Cadeias de caracteres de formato numérico padrão: https://docs.microsoft.com/pt-br/dotnet/standard/base-types/standard-numeric-format-strings?redirectedfrom=MSDN

Lista de Cadeias de caracteres de formato numérico personalizado: https://docs.microsoft.com/pt-br/dotnet/standard/base-types/custom-numeric-format-strings?redirectedfrom=MSDN

Espero que tenham gostado da postagem.

Quem quiser mandar comentários, sugestões, criticas e complementos, fiquem a vontade, pois feedbacks positivos ou negativos engradecem meu conhecimento para que possa melhorar as postagem para vocês.

Até a próxima o/

Divulguem nossas Redes Sociais:

Nos sigam no Instagram: consultabd

Nos sigam no Twitter

Deixem um like nos vídeos e se inscrevam no nosso canal do Youtube

Publicidade