A função `Formatar` no VBA (Visual Basic for Applications) é usada para formatar expressões, como datas, números ou cadeias de texto, de acordo com as especificações fornecidas. A função é bastante flexível e pode ser usada para criar saídas em formatos específicos. Aqui está uma visão geral de como usar a função `Formatar`:
Sintaxe
Format(expression, [format], [firstdayofweek], [firstweekofyear])
- expression: Obrigatório. A expressão que você deseja formatar. Pode ser um número, data ou string.
- format: Opcional. Uma string que define o formato que você deseja aplicar à expressão. Se omitido, a expressão será convertida para string sem nenhum formato específico.
- firstdayofweek: Opcional. Uma constante que especifica o primeiro dia da semana.
- firstweekofyear: Opcional. Uma constante que especifica a primeira semana do ano.
Exemplos de Uso
Formatar Datas
Dim myDate As Date
myDate = #10/31/2023#
Dim formattedDate As String
' Formato de data curto
formattedDate = Format(myDate, "dd/mm/yyyy")
' Resulta em: "31/10/2023"
' Formato de data longo
formattedDate = Format(myDate, "dddd, dd mmmm yyyy")
' Resulta em: "terça-feira, 31 outubro 2023"
Formatar Números
Dim myNumber As Double
myNumber = 1234.5678
Dim formattedNumber As String
' Formato de número com duas casas decimais
formattedNumber = Format(myNumber, "0.00")
' Resulta em: "1234.57"
' Formato de moeda
formattedNumber = Format(myNumber, "Currency")
' Resulta em: algo como "$1,234.57", dependendo das configurações regionais
Formatar Strings
Dim myString As String
myString = "1234"
' Formato personalizado para a string
Dim formattedString As String
formattedString = Format(myString, "@@@@-@@")
' Resulta em: "1234-12"
Constantes para Dias e Semanas
- firstdayofweek: Pode usar constantes como `vbSunday`, `vbMonday`, etc.
- firstweekofyear: Pode usar constantes como `vbFirstJan1`, `vbFirstFourDays`, etc.
Notas
- Quando usar formatos predefinidos como “Currency”, “Date”, etc., o resultado pode variar conforme as configurações regionais do sistema onde o VBA está sendo executado.
- Sempre que estiver em dúvida sobre os diferentes códigos de formatação (especialmente para datas e números), consulte a documentação do VBA para obter detalhes adicionais sobre cada opção disponível.
Esses exemplos e diretrizes devem ajudá-lo a começar a usar a função `Formatar` no VBA de maneira eficaz.
Unlock Your Potential
Excel
Access
Power BI
