Função FormatFormat function

Retorna uma Variant (String) contendo uma expressão formatada de acordo com instruções contidas em uma expressão de formato.Returns a Variant (String) containing an expression formatted according to instructions contained in a format expression.

Observação

Interessado em desenvolver soluções que ampliem a experiência do Office em várias plataformas?Interested in developing solutions that extend the Office experience across multiple platforms? Confira o novo modelo de Suplementos do Office.Check out the new Office Add-ins model. Os suplementos do Office têm um pequeno espaço comparado aos suplementos e soluções do VSTO, e você pode criá-los usando quase qualquer tecnologia de programação Web, como HTML5, JavaScript, CSS3 e XML.Office Add-ins have a small footprint compared to VSTO Add-ins and solutions, and you can build them by using almost any web programming technology, such as HTML5, JavaScript, CSS3, and XML.

SintaxeSyntax

Format(Expression, [ Format ], [ FirstDayOfWeek ], [ FirstWeekOfYear ])Format(Expression, [ Format ], [ FirstDayOfWeek ], [ FirstWeekOfYear ])


A sintaxe da função Format tem as seguintes partes.The Format function syntax has these parts.

PartePart DescriçãoDescription
Expressão.Expression Obrigatório.Required. Qualquer expressão válida.Any valid expression.
FormatFormat Opcional.Optional. Uma expressão de formato nomeada ou definida pelo usuário válida.A valid named or user-defined format expression.
FirstDayOfWeekFirstDayOfWeek Opcional.Optional. Uma constante que especifica o primeiro dia da semana.A constant that specifies the first day of the week.
FirstWeekOfYearFirstWeekOfYear Opcional.Optional. Uma constante que especifica a primeira semana do ano.A constant that specifies the first week of the year.

ConfiguraçõesSettings

O argumento_primeirodiadasemana _ tem as seguintes configurações.The firstdayofweek argument has these settings.

ConstantConstant ValorValue DescriçãoDescription
vbUseSystemvbUseSystem 00 Use a configuração de API NLS.Use NLS API setting.
vbSundayvbSunday 11 Domingo (padrão)Sunday (default)
vbMondayvbMonday 22 Segunda-feiraMonday
vbTuesdayvbTuesday 33 Terça-feiraTuesday
vbWednesdayvbWednesday 44 Quarta-feiraWednesday
vbThursdayvbThursday 55 Quinta-feiraThursday
vbFridayvbFriday 66 Sexta-feiraFriday
vbSaturdayvbSaturday 77 SábadoSaturday

O argumento firstweekofyear tem as seguintes configurações.The firstweekofyear argument has these settings.

ConstantConstant ValorValue DescriçãoDescription
vbUseSystemvbUseSystem 00 Use a configuração de API NLS.Use NLS API setting.
vbFirstJan1vbFirstJan1 11 Comece com a semana em que ocorre 1 de janeiro (padrão).Start with week in which January 1 occurs (default).
vbFirstFourDaysvbFirstFourDays 22 Inicia na primeira semana do ano a ter pelo menos quatro dias.Start with the first week that has at least four days in the year.
vbFirstFullWeekvbFirstFullWeek 33 Inicia na primeira semana completa do ano.Start with the first full week of the year.

ComentáriosRemarks

Para formatarTo format Faça istoDo this
NúmerosNumbers Use formatos numéricos nomeados pré-definidos ou crie formatos numéricos definidos pelo usuário.Use predefined named numeric formats or create user-defined numeric formats.
Datas e horasDates and times Use formatos nomeados pré-definidos ou crie formatos data/hora definidos pelo usuário.Use predefined named date/time formats or create user-defined date/time formats.
Números de série de data e horaDate and time serial numbers Use formatos de data e hora ou formatos numéricos.Use date and time formats or numeric formats.
Cadeias de caracteresStrings Crie os seus próprios formatos de cadeia de caracteres definidos pelo usuário.Create your own user-defined string formats.

O Formato trunca o formato para 257 caracteres.Format truncates format to 257 characters.

Se você tentar formatar um número sem especificar formato, Formato proporcionará uma funcionalidade semelhante à função Str, embora esteja ciente internacionalmente.If you try to format a number without specifying format, Format provides functionality similar to the Str function, although it is internationally aware. No entanto, os números positivos formatados como cadeias de caracteres usando formato não incluem um espaço à esquerda reservado para a entrada do valor; aqueles convertidos usando Str mantêm os espaços à esquerda.However, positive numbers formatted as strings using Format don't include a leading space reserved for the sign of the value; those converted using Str retain the leading space.

Se você estiver formatando uma cadeia de caracteres numérica não localizada, deverá usar um formato numérico definido pelo usuário para garantir que obtém a aparência desejada.If you are formatting a non-localized numeric string, you should use a user-defined numeric format to ensure that you get the look you want.

Observação

Se a configuração de propriedadecalendário for Gregorian e o_formato_ especificar a data de formatação, a expressão fornecida deve ser Gregorian.If the Calendar property setting is Gregorian and format specifies date formatting, the supplied expression must be Gregorian. Se a configuração de propriedade calendário do Visual Basic for Hijri, a expressão fornecida deve ser Hijri.If the Visual Basic Calendar property setting is Hijri, the supplied expression must be Hijri.

Se o calendário for gregoriano, o significado dos símbolos de expressão de formato é inalterado.If the calendar is Gregorian, the meaning of format expression symbols is unchanged. Se o calendário for Hijri, todos os símbolos de formato de data (por exemplo, dddd, mmmm, aaaa ), têm o mesmo significado mas se aplicam ao calendário islâmico.If the calendar is Hijri, all date format symbols (for example, dddd, mmmm, yyyy ) have the same meaning but apply to the Hijri calendar. Os símbolos de formato permanecerão em inglês; símbolos que resultam na exibição de texto (por exemplo, AM e PM) exibem a cadeia de caracteres (em inglês ou árabe) associada a esse símbolo.Format symbols remain in English; symbols that result in text display (for example, AM and PM) display the string (English or Arabic) associated with that symbol. O intervalo de determinados símbolos muda quando o calendário islâmico é.The range of certain symbols changes when the calendar is Hijri.

Símbolos de dataDate symbols

SímboloSymbol IntervaloRange
dd 1-31 (dia do mês, sem zero à esquerda)1-31 (Day of month, with no leading zero)
dddd 01 a 31 (dia do mês com zero à esquerda)01-31 (Day of month, with a leading zero)
ww 1 a 7 (dia da semana, começando com domingo = 1)1-7 (Day of week, starting with Sunday = 1)
wwww 1-53 (semana do ano, sem zero à esquerda; Início da semana 1 em 1º de janeiro)1-53 (Week of year, with no leading zero; Week 1 starts on Jan 1)
mm 1 a 12 (mês do ano, sem zero à esquerda, começando com janeiro = 1)1-12 (Month of year, with no leading zero, starting with January = 1)
mmmm 01 a 12 (mês do ano, com zero à esquerda, começando com janeiro = 01)01-12 (Month of year, with a leading zero, starting with January = 01)
mmmmmm Exibe nomes de meses abreviados (Nomes de meses Hijri não têm abreviações).Displays abbreviated month names (Hijri month names have no abbreviations)
mmmmmmmm Exibe nomes de meses completosDisplays full month names
yy 1 a 366 (dia do ano)1-366 (Day of year)
yyyy 00 – 99 (dois últimos dígitos do ano)00-99 (Last two digits of year)
yyyyyyyy 100-9999 (três ou quatro dígitos do ano)100-9999 (Three- or Four-digit year)

Símbolos de tempoTime symbols

SímboloSymbol IntervaloRange
hh 0 a 23 (1 a 12 com "AM" ou "PM" acrescentado) (hora do dia sem zero à esquerda)0-23 (1-12 with "AM" or "PM" appended) (Hour of day, with no leading zero)
hhhh 00 a 23 (01 – 12 com "AM" ou "PM" acrescentado) (hora do dia com zero à esquerda)00-23 (01-12 with "AM" or "PM" appended) (Hour of day, with a leading zero)
nn 0 a 59 (minuto da hora sem zero à esquerda)0-59 (Minute of hour, with no leading zero)
nnnn 00 a 59 (minuto da hora, com zero à esquerda)00-59 (Minute of hour, with a leading zero)
mm 0 a 59 (minuto da hora, sem zero à esquerda).0-59 (Minute of hour, with no leading zero). Somente se precedida por h ou hhOnly if preceded by h or hh
mmmm 00 a 59 (minuto da hora com zero à esquerda).00-59 (Minute of hour, with a leading zero). Somente se precedida por h ou hhOnly if preceded by h or hh
ss 0 a 59 (segundo do minuto, sem zero à esquerda)0-59 (Second of minute, with no leading zero)
ssss 00 a 59 (segundo do minuto com zero à esquerda)00-59 (Second of minute, with a leading zero)

ExemploExample

Este exemplo mostra usos da função Formato para formatar valores usando formatos nomeados e formatos definidos pelo usuário.This example shows various uses of the Format function to format values using both named formats and user-defined formats. Para o separador de data (/), separador de hora (:) e AM / PM literal, a saída formatada real exibida ao seu sistema depende das configurações de localidade no qual o código está em execução.For the date separator (/), time separator (:), and AM/ PM literal, the actual formatted output displayed by your system depends on the locale settings on which the code is running. Quando horários e datas são exibidos no ambiente de desenvolvimento, o formato de hora abreviada e o formato de data abreviada da localidade código são usados.When times and dates are displayed in the development environment, the short time format and short date format of the code locale are used. Quando exibidos executando o código, o formato de hora abreviada e o formato de data abreviada da localidade do sistema são usados, e podem ser diferentes do local do código.When displayed by running code, the short time format and short date format of the system locale are used, which may differ from the code locale. Por exemplo, English/U.S. será considerado.For this example, English/U.S. is assumed. MyTime e MyDate são exibidos no ambiente de desenvolvimento usando a configuração atual de data abreviada e configuração de hora abreviada.MyTime and MyDate are displayed in the development environment using current system short time setting and short date setting.

Dim MyTime, MyDate, MyStr
MyTime = #17:04:23#
MyDate = #January 27, 1993#

' Returns current system time in the system-defined long time format.
MyStr = Format(Time, "Long Time")

' Returns current system date in the system-defined long date format.
MyStr = Format(Date, "Long Date")

MyStr = Format(MyTime, "h:m:s")    ' Returns "17:4:23".
MyStr = Format(MyTime, "hh:mm:ss am/pm")    ' Returns "05:04:23 pm".
MyStr = Format(MyTime, "hh:mm:ss AM/PM")    ' Returns "05:04:23 PM".
MyStr = Format(MyDate, "dddd, mmm d yyyy")    ' Returns "Wednesday, Jan 27 1993".
' If format is not supplied, a string is returned.
MyStr = Format(23)    ' Returns "23".

' User-defined formats.
MyStr = Format(5459.4, "##,##0.00")    ' Returns "5,459.40".
MyStr = Format(334.9, "###0.00")    ' Returns "334.90".
MyStr = Format(5, "0.00%")    ' Returns "500.00%".
MyStr = Format("HELLO", "<")    ' Returns "hello".
MyStr = Format("This is it", ">")    ' Returns "THIS IS IT".

Formatos diferentes para valores numéricos diferentes.Different formats for different numeric values

Um formato definido pelo usuário expressão para os números podem ter de uma a quatro seções separadas por ponto e vírgula.A user-defined format expression for numbers can have from one to four sections separated by semicolons. Se o formato argumento contém um dos formatos numéricos nomeados, apenas uma seção é permitida.If the format argument contains one of the named numeric formats, only one section is allowed.

Se você usarIf you use O resultado éThe result is
Somente uma seçãoOne section only A expressão de formato se aplica a todos os valores.The format expression applies to all values.
Duas seçõesTwo sections A primeira seção se aplica a valores positivos e zeros, a segunda a valores negativos.The first section applies to positive values and zeros, the second to negative values.
Três seçõesThree sections A primeira seção se aplica a valores positivos, a segunda a valores negativos e a terceira a zeros.The first section applies to positive values, the second to negative values, and the third to zeros.
Quatro seçõesFour sections A primeira seção se aplica a valores positivos, a segunda a valores negativos, a terceira a zeros e a quarta a valores Nulo.The first section applies to positive values, the second to negative values, the third to zeros, and the fourth to Null values.
"$#,##0;($#,##0)"

Se você incluir pontos e vírgulas com nada entre eles, a seção em falta será impressa usando o formato do valor positivo.If you include semicolons with nothing between them, the missing section is printed using the format of the positive value. Por exemplo, o seguinte formato exibe os valores positivos e negativos usando a formatação da primeira seção e exibe "Zero" se o valor é zero.For example, the following format displays positive and negative values using the format in the first section and displays "Zero" if the value is zero.

"$#,##0;;\Z\e\r\o"

Formatos diferentes para valores de cadeia de caracteres diferentes Different formats for different string values

Uma expressão de formato para cadeias de caracteres pode conter uma seção ou duas seções separadas por um ponto e vírgula (;).A format expression for strings can have one section or two sections separated by a semicolon (;).

Se você usarIf you use O resultado éThe result is
Somente uma seçãoOne section only O formato se aplica a todos os dados de cadeia de caracteres.The format applies to all string data.
Duas seçõesTwo sections A primeira seção se aplica a dados de cadeia de caracteres, a segunda a valores Nulo e cadeias de caracteres de comprimento nulo ("").The first section applies to string data, the second to Null values and zero-length strings ("").

Formatos de data/horaNamed date/time formats

A tabela a seguir identifica os nomes de formato de data e hora pré-definidos.The following table identifies the predefined date and time format names.

Nome do formatoFormat name DescriçãoDescription
General DateGeneral Date Exibir uma data / hora, por exemplo, 3/4/93 05:34PM.Display a date and/or time, for example, 4/3/93 05:34 PM. Se não houver nenhuma parte fracionária, apenas a data é exibida, por exemplo, 3/4/93.If there is no fractional part, display only a date, for example, 4/3/93. Se não houver nenhuma parte inteira, apenas a hora é exibida, por exemplo, 05:34PM.If there is no integer part, display time only, for example, 05:34 PM. A exibição da data é determinada pela seus ajustes.Date display is determined by your system settings.
Long DateLong Date Exibe uma data de acordo com o formato de data longo do seu sistema.Display a date according to your system's long date format.
Medium DateMedium Date Exibe uma data usando o formato de data média apropriado para a versão de aplicativo host.Display a date using the medium date format appropriate for the language version of the host application.
Short DateShort Date Exibe uma data usando o formato de data curto do seu sistema.Display a date using your system's short date format.
Long TimeLong Time Exibe uma hora usando o formato de hora longo do seu sistema; inclui horas, minutos e segundos.Display a time using your system's long time format; includes hours, minutes, seconds.
Medium TimeMedium Time Exibe a hora no formato de 12 horas usando horas e minutos e o designador AM/PM.Display time in 12-hour format using hours and minutes and the AM/PM designator.
Short TimeShort Time Exibe uma hora usando o formato de 24 horas, por exemplo, 17:45.Display a time using the 24-hour format, for example, 17:45.

Formatos numéricos definidosNamed numeric formats

A tabela a seguir identifica os nomes de formatos numéricos pré-definidos.The following table identifies the predefined numeric format names.

Nome do formatoFormat name DescriçãoDescription
General NumberGeneral Number Exibe o número sem o separador de milhar.Display number with no thousand separator.
CurrencyCurrency Exibe o número com o separador de milhar, se apropriado; exibe dois dígitos à direita do separador decimal..Display number with thousand separator, if appropriate; display two digits to the right of the decimal separator. A saída se baseia no sistema de configurações de localidade.Output is based on system locale settings.
FixedFixed Exibe no mínimo um dígito à esquerda e dois dígitos à direita do separador de decimal.Display at least one digit to the left and two digits to the right of the decimal separator.
StandardStandard Exibe o número com o separador de milhar, no mínimo um dígito à esquerda e dois dígitos à direita do separador decimal.Display number with thousand separator, at least one digit to the left and two digits to the right of the decimal separator.
PercentPercent Exibe número multiplicado por 100 com um símbolo de percentual (%) à direita; sempre exibe dois dígitos à direita do separador decimal.Display number multiplied by 100 with a percent sign (%) appended to the right; always display two digits to the right of the decimal separator.
ScientificScientific Usa a notação científica padrão.Use standard scientific notation.
Yes/NoYes/No Exibe Não se o número for 0; caso contrário, exibe Sim.Display No if number is 0; otherwise, display Yes.
True/FalseTrue/False Exibe False se o número for 0; caso contrário, exibe True.Display False if number is 0; otherwise, display True.
On/OffOn/Off Exibe Desligado se o número for 0; caso contrário, exibe Ligado.Display Off if number is 0; otherwise, display On.

Formatos definidos pelo usuárioUser-defined string formats

Você pode usar qualquer um dos seguintes caracteres para criar uma expressão de formato para cadeias de caracteres.You can use any of the following characters to create a format expression for strings.

CaractereCharacter DescriçãoDescription
@ Espaço reservado para o caractere.Character placeholder. Exibe um espaço ou um caractere.Display a character or a space. Se a cadeia de caracteres tiver um caractere na posição onde o símbolo (@) aparece na cadeia de caracteres formato exiba-o, caso contrário, exiba um espaço nessa posição.If the string has a character in the position where the at symbol (@) appears in the format string, display it; otherwise, display a space in that position. Espaços reservados são preenchidos da direita para a esquerda, a menos que haja um caractere de ponto de exclamação (!) na cadeia de caracteres de formato.Placeholders are filled from right to left unless there is an exclamation point character (!) in the format string.
& Espaço reservado para o caractere.Character placeholder. Exibe um caractere ou nada.Display a character or nothing. Se a cadeia de caracteres tiver um caractere à posição onde o e comercial (&) for exibido, exiba-a; caso contrário, não exiba nada.If the string has a character in the position where the ampersand (&) appears, display it; otherwise, display nothing. Espaços reservados são preenchidos da direita para a esquerda, a menos que haja um caractere de ponto de exclamação (!) na cadeia de caracteres de formato.Placeholders are filled from right to left unless there is an exclamation point character (!) in the format string.
< Força minúsculas.Force lowercase. Exibe todos os caracteres no formato de minúsculas.Display all characters in lowercase format.
> Forçar letras maiúsculas.Force uppercase. Exibe todos os caracteres no formato de maiúsculas.Display all characters in uppercase format.
! Force da esquerda para direita preenchimento espaços reservados.Force left to right fill of placeholders. O padrão é preencher espaços reservados da direita para a esquerda.The default is to fill placeholders from right to left.

Formatos de data/hora definidos pelo usuárioUser-defined date/time formats

A tabela a seguir identifica caracteres que você pode usar para criar formatos de data/hora definidos pelo usuário.The following table identifies characters you can use to create user-defined date/time formats.

CaractereCharacter DescriçãoDescription
(:) Separador de hora.Time separator. Em algumas localidades, outros caracteres podem ser usados para representar o separador de hora.In some locales, other characters may be used to represent the time separator. O separador de hora separa horas, minutos e segundos quando os valores de tempo são formatados.The time separator separates hours, minutes, and seconds when time values are formatted. O caractere usado como separador de hora no formato saída será determinado pelas configurações seu sistema.The actual character used as the time separator in formatted output is determined by your system settings.
(/) Separador de dados.Date separator. Em alguns locais outros caracteres podem ser usados para representar o separador de data.In some locales, other characters may be used to represent the date separator. O separador de data separa o dia, mês e ano quando os valores de data são formatados.The date separator separates the day, month, and year when date values are formatted. O caractere usado como o separador de data no formato de saída será determinado pelas configurações seu sistema.The actual character used as the date separator in formatted output is determined by your system settings.
cc Exibe a data ddddd e exibe a hora como ttttt, nessa ordem.Display the date as ddddd and display the time as ttttt, in that order. Somente exibe as informações de data se não houver parte fracionada no número de série de data; exibe somente informações de hora se não houver porção de inteiro.Display only date information if there is no fractional part to the date serial number; display only time information if there is no integer portion.
dd Exibe o dia como um número sem um zero à esquerda (1 – 31).Display the day as a number without a leading zero (1–31).
dddd Exibe o dia como um número com um zero à esquerda (01 – 31).Display the day as a number with a leading zero (01–31).
dddddd Exibe o dia como uma abreviação (Dom – Sáb).Display the day as an abbreviation (Sun–Sat). Localizar.Localized.
dddddddd Exibe o dia como um nome completo (Dom – Sáb).Display the day as a full name (Sunday–Saturday). Localizar.Localized.
dddddddddd Exibe a data como data completa (incluindo dia, mês e ano), formatada de acordo com a configuração de formato de data curta do seu sistema.Display the date as a complete date (including day, month, and year), formatted according to your system's short date format setting. O formato de data abreviada padrão é m/d/yy.The default short date format is m/d/yy.
dddddddddddd Exibe um número de série de data como uma data completa (incluindo dia, mês e ano) formatada de acordo com a configuração de formato de data longa reconhecida pelo seu sistema. Display a date serial number as a complete date (including day, month, and year) formatted according to the long date setting recognized by your system. O formato de data por extenso padrão é mmmm dd, yyyy.The default long date format is mmmm dd, yyyy.
ww Exibe o dia da semana como um número (1 para Domingo até 7 para Sábado).Display the day of the week as a number (1 for Sunday through 7 for Saturday).
ssww Exibe o dia do ano como um número (1– 54).Display the week of the year as a number (1–54).
mm Exibe o mês como um número sem um zero à esquerda (1 – 12).Display the month as a number without a leading zero (1–12). Se m segue imediatamente h ou hh, o minuto em vez do mês é exibido.If m immediately follows h or hh, the minute rather than the month is displayed.
mmmm Exibe o dia como um número com um zero à esquerda (01 – 12).Display the month as a number with a leading zero (01–12). Se m segue imediatamente h ou hh, o minuto em vez do mês é exibido.If m immediately follows h or hh, the minute rather than the month is displayed.
mmmmmm Exibe o mês como uma abreviação (Jan – Dez).Display the month as an abbreviation (Jan–Dec). Localizar.Localized.
mmmmmmmm Exibe o mês como um nome de mês completo (Janeiro – Dezembro).Display the month as a full month name (January–December). Localizar.Localized.
qq Exibe o trimestre do ano como um número (1– 4).Display the quarter of the year as a number (1–4).
yy Exibe o dia do ano como um número (1– 366).Display the day of the year as a number (1–366).
yyyy Exibe o ano como um número de 2 dígitos (00 – 99).Display the year as a 2-digit number (00–99).
yyyyyyyy Exibe o ano como um número de 4 dígitos (100 – 9999).Display the year as a 4-digit number (100–9999).
hh Exibe a hora como um número sem zero à esquerda (0 – 23).Display the hour as a number without a leading zero (0–23).
hhhh Exibe a hora como um número com zero à esquerda (00 – 23).Display the hour as a number with a leading zero (00–23).
nn Exibe o minuto como um número sem zero à esquerda (0 – 59).Display the minute as a number without a leading zero (0–59).
nnnn Exibe o minuto como um número com zero à esquerda (00 – 59).Display the minute as a number with a leading zero (00–59).
ss Exibe o segundo como um número sem zero à esquerda (0 – 59).Display the second as a number without a leading zero (0–59).
ssss Exibe o segundo como um número com zero à esquerda (00 – 59).Display the second as a number with a leading zero (00–59).
tttttttttt Exibe o tempo como tempo completo (incluindo hora, minuto e segundo), formatados com base em um separador de hora definido pelo formato de hora reconhecido pelo seu sistema.Display a time as a complete time (including hour, minute, and second), formatted using the time separator defined by the time format recognized by your system. Zero à esquerda é exibido se a opção zero à esquerda está selecionada e a hora for anterior às 10:00A leading zero is displayed if the leading zero option is selected and the time is before 10:00 A.M. ou P.M.or P.M. O formato de hora padrão é h:mm:ss.The default time format is h:mm:ss.
AM/PMAM/PM Usa o relógio de 12 horas e exibe um AM em maiúsculas em qualquer hora antes do meio-dia; exibe um PM em maiúsculas em qualquer hora entre o meio-dia e 11:59 P.M.Use the 12-hour clock and display an uppercase AM with any hour before noon; display an uppercase PM with any hour between noon and 11:59 P.M.
am/pmam/pm Usa o relógio de 12 horas e exibe um AM em minúsculas em qualquer hora antes do meio-dia; exibe um PM em minúsculas em qualquer hora entre o meio-dia e 11:59 P.M.Use the 12-hour clock and display a lowercase AM with any hour before noon; display a lowercase PM with any hour between noon and 11:59 P.M.
A/PA/P Usa o relógio de 12 horas e exibe um A em maiúsculas em qualquer hora antes do meio-dia; exibe um P em maiúsculas em qualquer hora entre o meio-dia e 11:59 P.M.Use the 12-hour clock and display an uppercase A with any hour before noon; display an uppercase P with any hour between noon and 11:59 P.M.
a/pa/p Usa o relógio de 12 horas e exibe um A em minúsculas em qualquer hora antes do meio-dia; exibe um P em minúsculas em qualquer hora entre o meio-dia e 11:59 P.M..Use the 12-hour clock and display a lowercase A with any hour before noon; display a lowercase P with any hour between noon and 11:59 P.M.
AMPMAMPM Use relógio de 12 horas e exiba a cadeia de caracteres literal AM conforme definido pelo sistema, com qualquer hora antes do meio-dia; exiba o literal da cadeia de caracteres PM, conforme definido pelo seu sistema, com qualquer hora entre o meio-dia e 11:59 P.M.Use the 12-hour clock and display the AM string literal as defined by your system with any hour before noon; display the PM string literal as defined by your system with any hour between noon and 11:59 P.M. AMPM pode ser maiúscula ou minúscula, mas no caso da cadeia de caracteres exibida corresponder à cadeia de caracteres definida pelas configurações do sistema.AMPM can be either uppercase or lowercase, but the case of the string displayed matches the string as defined by your system settings. O formato padrão é AM/PM.The default format is AM/PM. Se o sistema está definido para um relógio de 24 horas, a cadeia de caracteres será configurada como uma cadeia de caracteres de comprimento zero.If your system is set to 24-hour clock, the string is typical set to a zero-length string.

Formatos numéricos definidos pelo usuárioUser-defined numeric formats

A tabela a seguir identifica caracteres que você pode usar para criar formatos de número definidos pelo usuário.The following table identifies characters you can use to create user-defined number formats.

CaractereCharacter DescriçãoDescription
NenhumNone Exibe o número sem formatação.Display the number with no formatting.
(0)(0) Espaço reservado para dígito.Digit placeholder. Exibe um dígito ou zero.Display a digit or a zero. Se a expressão tem um dígito à posição onde o 0 é exibido na cadeia de caracteres formato exiba-a; caso contrário, exiba um zero nessa posição. Se o número tiver menos dígitos do que zeros (em ambos os lados do decimal) na expressão de formato, exiba zeros à esquerda ou à direita.If the expression has a digit in the position where the 0 appears in the format string, display it; otherwise, display a zero in that position.If the number has fewer digits than there are zeros (on either side of the decimal) in the format expression, display leading or trailing zeros. Se o número tiver mais dígitos à direita do separador decimal do que zeros à direita do separador decimal na expressão de formato, arredonde o número para tantas casas decimais quantas forem zeros.If the number has more digits to the right of the decimal separator than there are zeros to the right of the decimal separator in the format expression, round the number to as many decimal places as there are zeros. Se o número tiver mais dígitos à esquerda do separador decimal do que os zeros à esquerda do separador decimal na expressão de formato, exiba os dígitos extras sem modificação.If the number has more digits to the left of the decimal separator than there are zeros to the left of the decimal separator in the format expression, display the extra digits without modification.
(#) Espaço reservado para dígito.Digit placeholder. Exibe um dígito ou nada.Display a digit or nothing. Se a expressão tiver um dígito na posição onde o # aparece na cadeia de caracteres de formato, exibe-o; caso contrário, não exibe nada nessa posição.If the expression has a digit in the position where the # appears in the format string, display it; otherwise, display nothing in that position. Este símbolo funciona como o espaço reservado de dígito 0, com a exceção de que os zeros à esquerda e à direita não são exibidos se o número tiver tantos ou menos dígitos que caracteres # em cada lado do separador decimal na expressão de formato.This symbol works like the 0 digit placeholder, except that leading and trailing zeros aren't displayed if the number has the same or fewer digits than there are # characters on either side of the decimal separator in the format expression.
(.) Espaço reservado para casas decimais.Decimal placeholder. Em algumas localidades, a vírgula é utilizada como separador decimal.In some locales, a comma is used as the decimal separator. O espaço reservado decimal determina o número de dígitos que é exibido à esquerda e à direita do separador decimal.The decimal placeholder determines how many digits are displayed to the left and right of the decimal separator. Se a expressão de formato contiver somente sinais numéricos à esquerda deste símbolo, os números menores que 1 começam com um separador decimal.If the format expression contains only number signs to the left of this symbol, numbers smaller than 1 begin with a decimal separator. Para exibir um zero à esquerda exibido com números fracionados, use 0, como o primeiro espaço reservado de dígitos à esquerda do separador decimal.To display a leading zero displayed with fractional numbers, use 0 as the first digit placeholder to the left of the decimal separator. O caractere usado como um espaço reservado decimal na saída formatada depende do formato de número reconhecido pelo sistema.The actual character used as a decimal placeholder in the formatted output depends on the Number Format recognized by your system.
(%) Espaço reservado para porcentagem.Percentage placeholder. A expressão é multiplicada por 100.The expression is multiplied by 100. O símbolo de porcentagem (%) é inserido na posição onde ele aparece na cadeia de caracteres de formato.The percent character (%) is inserted in the position where it appears in the format string.
(,) Separador de milhar.Thousand separator. Em alguns locais, um ponto é utilizado como separador de milhar.In some locales, a period is used as a thousand separator. O separador de milhar separa milhares de centenas de um número que tem quatro ou mais locais à esquerda do separador decimal.The thousand separator separates thousands from hundreds within a number that has four or more places to the left of the decimal separator. O uso padrão do separador de milhar é especificado se o formato contiver um separador de milhar delimitado por espaços reservados de dígitos (0 ou ** # **).Standard use of the thousand separator is specified if the format contains a thousand separator surrounded by digit placeholders (0 or #). Dois separadores de milhar adjacentes ou um separador de milhar imediatamente à esquerda do separador decimal (quer um decimal seja especificado ou não) significa "dimensionar o número dividindo-o por 1.000, arredondando conforme necessário".Two adjacent thousand separators or a thousand separator immediately to the left of the decimal separator (whether or not a decimal is specified) means "scale the number by dividing it by 1000, rounding as needed." Por exemplo, você pode usar a cadeia de caracteres de formato "# # 0", para representar 100 milhão como 100.For example, you can use the format string "##0,," to represent 100 million as 100. Números menores que 1 milhão são exibidos como 0.Numbers smaller than 1 million are displayed as 0. Dois separadores de milhar adjacentes em qualquer posição que não seja imediatamente à esquerda do separador decimal são tratados simplesmente como especificando o uso de um separador de milhar.Two adjacent thousand separators in any position other than immediately to the left of the decimal separator are treated simply as specifying the use of a thousand separator. O caractere usado como o separador de milhar na saída formatada depende do formato de número reconhecido pelo sistema.The actual character used as the thousand separator in the formatted output depends on the Number Format recognized by your system.
(:) Separador de hora.Time separator. Em alguns locais, outros caracteres podem ser usados para representar o separador de tempo.In some locales, other characters may be used to represent the time separator. O separador de hora separa horas, minutos e segundos quando os valores de tempo são formatados.The time separator separates hours, minutes, and seconds when time values are formatted. O caractere usado como separador de hora no formato saída será determinado pelas configurações seu sistema.The actual character used as the time separator in formatted output is determined by your system settings.
(/) Separador de dados.Date separator. Em alguns locais outros caracteres podem ser usados para representar o separador de data.In some locales, other characters may be used to represent the date separator. O separador de data separa o dia, mês e ano quando os valores de data são formatados.The date separator separates the day, month, and year when date values are formatted. O caractere usado como o separador de data no formato de saída será determinado pelas configurações seu sistema.The actual character used as the date separator in formatted output is determined by your system settings.
(E- E+ e- e+)(E- E+ e- e+) Formato científico.Scientific format. Se a expressão de formato contiver pelo menos um espaço reservado de dígito (0 ou ** # **) à direita de E-, E +, e ou e +, o número será exibido no formato científico e E ou e será inserido entre o expoente e número.If the format expression contains at least one digit placeholder (0 or #) to the right of E-, E+, e-, or e+, the number is displayed in scientific format and E or e is inserted between the number and its exponent. O número de espaços reservados de dígitos à direita determina o número de dígitos no expoente.The number of digit placeholders to the right determines the number of digits in the exponent. Use E ou e para colocar um sinal de menos próximo em expoentes negativos.Use E- or e- to place a minus sign next to negative exponents. Use + E ou e + para colocar um sinal de menos próximo de expoentes negativos e um sinal de adição ao lado de expoentes positivos.Use E+ or e+ to place a minus sign next to negative exponents and a plus sign next to positive exponents.
- + $ ( )- + $ ( ) Exibe um caractere literal.Display a literal character. Para exibir outro caractere além dos listados, preceda-o de uma barra invertida (\) ou delimite-o entre aspas (" ").To display a character other than one of those listed, precede it with a backslash (\) or enclose it in double quotation marks (" ").
(\) Exibe o próximo caractere na cadeia de caracteres de formato.Display the next character in the format string. Para exibir um caractere que tem um significado especial como caractere literal, preceda-o com uma barra invertida (\).To display a character that has special meaning as a literal character, precede it with a backslash (\). Uma barra invertida em si não é exibida.The backslash itself isn't displayed. Usar uma barra invertida é o mesmo que colocar o próximo caractere entre aspas duplas.Using a backslash is the same as enclosing the next character in double quotation marks. Para exibir uma barra invertida, use duas barras invertidas (\\).To display a backslash, use two backslashes (\\). Exemplos de caracteres que não podem ser exibidos como caracteres literais são os caracteres de formatação de data e de formatação de hora (a, c, d, h, m, n, p, q, s, t, w, y, /, e :), os caracteres de formatação numérica (#, 0, %, E, e, vírgula e ponto) e os caracteres de formatação de cadeia de caracteres (@, &, <, >, e !).Examples of characters that can't be displayed as literal characters are the date-formatting and time-formatting characters (a, c, d, h, m, n, p, q, s, t, w, y, /, and :), the numeric-formatting characters (#, 0, %, E, e, comma, and period), and the string-formatting characters (@, &, <, >, and !).
("ABC")("ABC") Exiba a cadeia de caracteres entre aspas duplas ("").Display the string inside the double quotation marks (" "). Para incluir uma string no formato a partir do código, você deverá usar Chr(34) para delimitar o texto (34 é o código de caractere para uma aspa (")).To include a string in format from within code, you must use Chr(34) to enclose the text (34 is the character code for a quotation mark (")).

Confira tambémSee also

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.