Funções do Project

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Estas funções são usadas em fórmulas para calcular os valores de campos personalizados.

Dica : Para inserir uma fórmula em um campo personalizado para o Project 2007, no menu Ferramentas, aponte para Personalizar e, em seguida, clique em Campos. Na caixa de diálogo Campos Personalizados, clique em Fórmula. No Project 2010, clique na guia Projeto e, no grupo Propriedades, clique em Campos Personalizados. Na caixa de diálogo Campos Personalizados, clique em Fórmula.

Visão geral de funções do Project

Quando você usar o Microsoft Project, talvez seja necessário trabalhar com valores que não residem diretamente nos campos. As fórmulas permitem trabalhar com campos para criar esses novos valores.

Os exemplos a seguir ilustram como você pode usar fórmulas com campos personalizados:

  • Quando adicionada a um campo de número personalizado, a fórmula a seguir retorna um valor numérico que indica o número de dias entre a data atual e a data de término das tarefas em seu cronograma:

DateDiff("d",NOW(),[Finish])

  • Quando adicionada a um campo de texto personalizado, a fórmula a seguir retorna um valor "Sem linha de base", "Orçamento estourado em 20% ou mais" ou "Abaixo do orçamento":

    Switch(Len(CStr([Baseline Finish]))<3, "No baseline", ([Cost]+1)/ ([Baseline Cost]+1)>1.2,"Overbudget by 20% or more", ([Cost]+1)/([Baseline Cost]+1)>1, "Overbudget",True,"Under budget")
    The CStr function in the above formula works only if the [Baseline Finish] field is defined.

Funções de conversão

Cresc

Retorna um Inteiro que representa o código de caractere correspondente à primeira letra de uma cadeia.

Sintaxe

Asc( cadeia )

cadeia  Qualquer expressão de cadeia de caracteres válida.

CBool

Impõe uma expressão para o tipo de dados Booliano.

Sintaxe

CBool( expressão )

expressão  Qualquer expressão de cadeia de caracteres ou numérica válida.

CByte

Impõe uma expressão para o tipo de dados Byte.

Sintaxe

CByte( expressão )

expressão  Qualquer Inteiro de 0 a 255.

CCur

Impõe uma expressão para o tipo de dados Moeda.

Sintaxe

CCur( expressão )

expressão  Qualquer expressão numérica de -922.337.203.685.477,5808 a 922.337.203.685.477,5807.

CDate

Impõe uma expressão para o tipo de dados Data.

Sintaxe

CDate( expressão )

expressão  Qualquer expressão de data válida.

CDbl

Impõe uma expressão para o tipo de dados Duplo.

Sintaxe

CDbl( expressão )

expressão  Qualquer expressão numérica de -1,79769313486232E308 a -4,94065645841247E-324 para valores negativos; de 4,94065645841247E-324 a 1,79769313486232E308 para valores positivos.

CDec

Impõe uma expressão para o tipo de dados Decimal.

Sintaxe

CDec( expressão )

expressão  Qualquer expressão numérica entre +/-79.228.162.514.264.337.593.543.950.335 para números na escala zero, ou seja, números sem casas decimais. Para números com 28 casas decimais, o intervalo fica entre +/-7,9228162514264337593543950335. O menor número diferente de zero possível é 0,0000000000000000000000000001.

Chr

Retorna uma Cadeia que contém o caractere associado ao código do caractere especificado.

Sintaxe

Chr( códcaract )

códcaract  Um Longo que identifica um caractere.

CInt

Impõe uma expressão para o tipo de dados Inteiro.

Sintaxe

CInt( expressão )

expressão  Qualquer expressão numérica de -32.768 a 32.767; as frações são arredondadas.

CLng

Impõe uma expressão para o tipo de dados Longo.

Sintaxe

CLng( expressão )

expressão  Qualquer expressão numérica de -2.147.483.648 a 2.147.483.647; as frações são arredondadas.

CSng

Impõe uma expressão para o tipo de dados Simples.

Sintaxe

CSng( expressão )

expressão  Qualquer expressão numérica de -3,402823E38 a -1,401298E-45 para valores negativos; de 1,401298E-45 as 3.402823E38 para valores positivos.

CStr

Impõe uma expressão para o tipo de dados Cadeia.

Sintaxe

CStr( expressão )

expressão  Qualquer expressão de cadeia de caracteres ou numérica válida.

CVar

Impõe uma expressão para o tipo de dados Variante.

Sintaxe

CVar( expressão )

expressão  Mesmo intervalo de Duplo para numéricos. Mesmo intervalo de Cadeia para não numéricos.

DateSerial

Retorna uma Variante (Data) para um ano, mês e dia especificado.

Sintaxe

DateSerial( ano, mês, dia )

ano  Obrigatório; Inteiro. Número entre 100 e 9999, inclusive, ou uma expressão numérica.

mês  Obrigatório; Inteiro. Qualquer expressão numérica.

dia  Obrigatório; Inteiro. Qualquer expressão numérica.

Data.Valor

Retorna uma Variante (Data).

Sintaxe

DateValue( data )

data  Obrigatório; normalmente, uma expressão de cadeia de caracteres que representa uma data de 1 de janeiro de 100 a 31 de dezembro de 9999. Contudo, data também pode ser qualquer expressão que possa representar uma data, uma hora ou uma data e hora, nesse intervalo.

Dia

Retorna uma Variante (Inteiro) que especifica um número inteiro entre 1 e 31, inclusive, representando o dia do mês.

Sintaxe

Day( data)

data  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma data. Se data contiver Nulo, Nulo será retornado.

Hex

Retorna uma Cadeia que representa o valor hexadecimal de um número.

Sintaxe

Hex( número )

número  Obrigatório; qualquer expressão de cadeia de caracteres ou numérica válida.

Hora

Retorna uma Variante (Inteiro) que especifica um número inteiro entre 0 e 23, inclusive, representando a hora do dia.

Sintaxe

Hour( time )

hora  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma hora. Se hora contiver Nulo, Nulo será retornado.

Minuto

Retorna uma Variante (Inteiro) que especifica um número inteiro entre 0 e 59, inclusive, representando o minuto da hora.

Sintaxe

Minute( hora)

hora  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma hora. Se hora contiver Nulo, Nulo será retornado.

Mês

Retorna uma Variante (Inteiro) que especifica um número inteiro entre 1 e 12, inclusive, representando a o mês do ano.

Sintaxe

Month( data)

data  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma hora. Se data contiver Nulo, Nulo será retornado.

Out

Retorna uma Variante (Cadeia) que representa o valor octal de um número.

Sintaxe

Oct( número )

número  Obrigatório; qualquer expressão de cadeia de caracteres ou numérica válida.

ProjDateConv

Converte um valor em uma data.

Sintaxe

ProjDateConv( expressão, formato_data )

expressão  Obrigatório; Variante. A expressão a ser convertida em uma data.

formato_data  Opcional; Longo. O formato de data padrão é pjDateDefault, mas você pode substituir uma das seguintes constantes de pjDateFormat (formato de data aplicado 9/25/07 at 12:33 P.M.):

  • pjDateDefault: o formato padrão. Defina na guia Exibir da caixa de diálogo Opções (menu Ferramentas).

  • pjDate_mm_dd_yy_hh_mmAM: 9/25/07 12:33 PM

  • pjDate_mm_dd_yy: 9/25/07

  • pjDate_mm_dd_yyyy: 9/25/2007

  • pjDate_mmmm_dd_yyyy_hh_mmAM: September 25, 2007 12:33 PM

  • pjDate_mmmm_dd_yyyy: September 25, 2007

  • pjDate_mmm_dd_hh_mmAM: Sep 25 12:33 PM

  • pjDate_mmm_dd_yyy: Sep 25, '07

  • pjDate_mmmm_dd: September 25

  • pjDate_mmm_dd: Sep 25

  • pjDate_ddd_mm_dd_yy_hh_mmAM: Tue 9/25/07 12:33 PM

  • pjDate_ddd_mm_dd_yy: Tue 9/25/07

  • pjDate_ddd_mmm_dd_yyy: Tue Sep 25, '07

  • pjDate_ddd_hh_mmAM: Tue 12:33 PM

  • pjDate_mm_dd: 9/25

  • pjDate_dd: 25

  • pjDate_hh_mmAM: 12:33 PM

  • pjDate_ddd_mmm_dd: Tue Sep 25

  • pjDate_ddd_mm_dd: Tue 9/25

  • pjDate_ddd_dd: Tue 25

  • pjDate_Www_dd: W40/2

  • pjDate_Www_dd_yy_hh_mmAM: W40/2/07 12:33 PM

ProjDurConv

Converte uma expressão em um valor de duração nas unidades especificadas.

Sintaxe

ProjDurConv( expressão, unidades_duração )

expressão  Obrigatório; Variante. A expressão a ser convertida em uma duração.

unidades_duração  Opcional; Longo. As unidades usadas para expressar a duração. Se unidades_duração não for especificado, o valor padrão será o tipo de unidades especificado na opção A duração é inserida em na guia Agendar da caixa de diálogo Opções (menu Ferramentas). unidades_duração pode ser uma das seguintes constantes de pjFormatUnit:

  • pjMinutes: pjElapsedMinutes

  • pjHours: pjElapsedHours

  • pjDays: pjElapsedDays

  • pjWeeks: pjElapsedWeeks

  • pjMonths: pjElapsedMonths

  • pjMinutesEstimated: pjElapsedMinutesEstimated

  • pjHoursEstimated: pjElapsedHoursEstimated

  • pjDaysEstimated: pjElapsedDaysEstimated

  • pjWeeksEstimated: pjElapsedWeeksEstimated

  • pjMonthsEstimated: pjElapsedMonthsEstimated

Segundo

Retorna uma Variante (Inteiro) que especifica um número inteiro entre 0 e 59, inclusive, representando o segundo do minuto.

Sintaxe

Second( hora )

hora  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma hora. Se hora contiver Nulo, Nulo será retornado.

str

Retorna uma Variante (Cadeia) que representa um número.

Sintaxe

Str( número )

número  Obrigatório; Longo contém qualquer expressão numérica válida.

StrConv

Retorna uma Variante (Cadeia) convertida conforme especificado.

Sintaxe

StrConv( cadeia, conversão, LCID )

cadeia  Obrigatório; expressão de cadeia de caracteres a ser convertida.

conversão  Obrigatório; Inteiro. A soma de valores que especifica o tipo de conversão que deve ser executada.

LCID  Opcional; LocaleID, se diferente do LocaleID do sistema. (O LocaleID do sistema é o padrão.)

TimeSerial

Retorna uma Variante (Data) que contém o horário de uma determinada hora, minuto e segundo.

Sintaxe

TimeSerial( hora, minuto, segundo)

hora  Obrigatório; Variante (Inteiro). Número entre 0 (0h00) e 23 (23h00), inclusive, ou uma expressão numérica.

minuto  Obrigatório; Variante (Inteiro). Qualquer expressão numérica.

segundo  Obrigatório; Variante (Inteiro). Qualquer expressão numérica.

TimeValue

Retorna uma Variante (Data) que contém a hora.

Sintaxe

TimeValue( hora)

hora  Obrigatório; normalmente, uma expressão de cadeia de caracteres que representa uma hora, de 0:00:00 (0h00m00) a 23:59:59 (23h59m59), inclusive. No entanto, hora também pode ser qualquer expressão que represente uma hora nesse intervalo. Se hora contiver Nulo, Nulo será retornado.

Val

Retorna os números contidos em uma cadeia como um valor numérico do tipo apropriado.

Sintaxe

Val( cadeia )

cadeia  Obrigatório; qualquer expressão de cadeia de caracteres válida.

Dia da semana

Retorna uma Variante (Inteiro) que contém um número inteiro representando o dia da semana.

Sintaxe

Weekday( data[, primeirodiadasemana] )

data  Obrigatório; Variante, expressão numérica, expressão de cadeia de caracteres de qualquer combinação que possa representar uma data. Se data contiver Nulo, Nulo será retornado.

primeirodiadasemana  Opcional; uma constante que especifica o primeiro dia da semana. Se não especificado, será usado o domingo.

Ano

Retorna uma Variante (Inteiro) que contém um número inteiro representando o ano.

Sintaxe

Year( data )

data  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma data. Se data contiver Nulo, Nulo será retornado.

Funções de Data/Hora

CDate

Impõe uma expressão para o tipo de dados Data.

Sintaxe

CDate( expressão )

expressão  Qualquer expressão de data válida.

Data

Retorna uma Variante (Data) que contém a data do sistema atual.

Sintaxe

Data

DateAdd

Retorna uma Variante (Data) que contém a data à qual o intervalo de tempo especificado foi adicionado.

Sintaxe

DateAdd( intervalo, número, data )

intervalo  Obrigatório; expressão de cadeia de caracteres que é o intervalo de tempo que você deseja adicionar, como "m" ou "d" .

número  Obrigatório; expressão numérica que é o número de intervalos que você deseja adicionar. Pode ser positivo (para obter datas no futuro) ou negativo (para obter datas no passado).

data  Obrigatório; Variante (Data) ou literal representando a data à qual o intervalo é adicionado.

DateDiff

Retorna uma Variante (Longo) que especifica o número de intervalos de tempo entre as duas datas especificadas.

Sintaxe

DateDiff( intervalo, data1, data2[, primeirodiadasemana[, primeirasemanadoano]] )

intervalo  Obrigatório; expressão de cadeia de caracteres que é o intervalo de tempo usado para calcular a diferença entre data1 e data2.

data1, data2  Obrigatório; Variante (Data). Duas datas que você deseja usar no cálculo.

primeirodiadasemana  Opcional; uma constante que especifica o primeiro dia da semana. Se não especificado, será usado o domingo.

primeirasemanadoano  Opcional; uma constante que especifica a primeira semana do ano. Se não especificado, será usada a semana em que ocorre 1 de janeiro.

DatePart

Retorna uma Variante (Inteiro) que contém a parte especificada de uma determinada data.

Sintaxe

DatePart( intervalo, data[, primeirodiadasemana[, primeirasemanadoano]] )

intervalo  Obrigatório; expressão de cadeia de caracteres que é o intervalo de tempo que você deseja retornar.

data  Obrigatório; Variante (Data) o valor que você deseja avaliar.

primeirodiadasemana  Opcional; uma constante que especifica o primeiro dia da semana. Se não especificado, será usado o domingo.

primeirasemanadoano  Opcional; uma constante que especifica a primeira semana do ano. Se não especificado, será usada a semana em que ocorre 1 de janeiro.

DateSerial

Retorna uma Variante (Data) para um ano, mês e dia especificado.

Sintaxe

DateSerial( ano, mês, dia )

ano  Obrigatório; Inteiro. Número entre 100 e 9999, inclusive, ou uma expressão numérica.

mês  Obrigatório; Inteiro. Qualquer expressão numérica.

dia  Obrigatório; Inteiro. Qualquer expressão numérica.

Data.Valor

Retorna uma Variante (Data).

Sintaxe

DateValue( data )

data  Obrigatório; normalmente, uma expressão de cadeia de caracteres que representa uma data de 1 de janeiro de 100 a 31 de dezembro de 9999. Contudo, data também pode ser qualquer expressão que possa representar uma data, uma hora ou uma data e hora, nesse intervalo.

Dia

Retorna uma Variante (Inteiro) que especifica um número inteiro entre 1 e 31, inclusive, representando o dia do mês.

Sintaxe

Day( data)

data  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma data. Se data contiver Nulo, Nulo será retornado.

Hora

Retorna uma Variante (Inteiro) que especifica um número inteiro entre 0 e 23, inclusive, representando a hora do dia.

Sintaxe

Hour( time )

hora  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma hora. Se hora contiver Nulo, Nulo será retornado.

IsDate

Retorna um valor Booliano que indica se uma expressão pode ser convertida em uma data.

Sintaxe

IsDate( expressão )

expressão  Obrigatório; qualquer Variante que contém uma expressão de data ou expressão de cadeia de caracteres que possa ser reconhecida como uma data ou hora.

Minuto

Retorna uma Variante (Inteiro) que especifica um número inteiro entre 0 e 59, inclusive, representando o minuto da hora.

Sintaxe

Minute( hora)

hora  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma hora. Se hora contiver Nulo, Nulo será retornado.

Mês

Retorna uma Variante (Inteiro) que especifica um número inteiro entre 1 e 12, inclusive, representando a o mês do ano.

Sintaxe

Month( data)

data  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma hora. Se data contiver Nulo, Nulo será retornado.

Agora

Retorna uma Variante (Data) que especifica a data e a hora atuais de acordo com a data e a hora do sistema do seu computador.

Sintaxe

Agora

ProjDateAdd

Adiciona uma duração a uma data para retornar uma nova data.

Sintaxe

ProjDateAdd( data, duração, calendário )

data  Obrigatório; Variante. A data original à qual a duração é adicionada.

duração  Obrigatório; Variante. A duração a ser adicionada a data.

calendário  Opcional; Cadeia. O calendário que deve ser usado ao calcular a nova data. Se calendário não for especificado, o padrão para o recurso atual será o calendário do recurso ou, para a tarefa atual, o calendário da tarefa ou o calendário padrão, caso não haja um calendário da tarefa. No Project Server, o calendário padrão será usado, independentemente do calendário especificado na cadeia calendário. Quando você usa essa função em uma fórmula criada no Project Web App e a compara com a mesma fórmula criada no Project Professional, faça um teste para garantir que os resultados sejam os esperados.

Observação :  Para subtrair sete dias de uma data especificada, a seguinte fórmula funciona corretamente no Project Professional 2010: ProjDateAdd("9/24/2010", "-7d"). No entanto, quando você executa a mesma fórmula no Project Server 2010, o resultado é 9/24/2010, não 9/17/2010. Para fórmulas que funcionam de maneira consistente no Project Professional 2010 e no Project Server 2010, você deve evitar parâmetros negativos para as funções ProjDateAdd e ProjDateSub.

ProjDateConv

Converte um valor em uma data.

Sintaxe

ProjDateConv( expressão, formato_data )

expressão  Obrigatório; Variante. A expressão a ser convertida em uma data.

formato_data  Opcional; Longo. O formato de data padrão é pjDateDefault, mas você pode substituir uma das seguintes constantes de pjDateFormat (formato de data aplicado 9/25/07 at 12:33 P.M.):

  • pjDateDefault: o formato padrão. Defina na guia Exibir da caixa de diálogo Opções (menu Ferramentas).

  • pjDate_mm_dd_yy_hh_mmAM: 9/25/07 12:33 PM

  • pjDate_mm_dd_yy: 9/25/07

  • pjDate_mm_dd_yyyy: 9/25/2007

  • pjDate_mmmm_dd_yyyy_hh_mmAM: September 25, 2007 12:33 PM

  • pjDate_mmmm_dd_yyyy: September 25, 2007

  • pjDate_mmm_dd_hh_mmAM: Sep 25 12:33 PM

  • pjDate_mmm_dd_yyy: Sep 25, '07

  • pjDate_mmmm_dd: September 25

  • pjDate_mmm_dd: Sep 25

  • pjDate_ddd_mm_dd_yy_hh_mmAM: Tue 9/25/07 12:33 PM

  • pjDate_ddd_mm_dd_yy: Tue 9/25/03

  • pjDate_ddd_mmm_dd_yyy: Tue Sep 25, '07

  • pjDate_ddd_hh_mmAM: Tue 12:33 PM

  • pjDate_mm_dd: 9/25

  • pjDate_dd: 25

  • pjDate_hh_mmAM: 12:33 PM

  • pjDate_ddd_mmm_dd: Tue Sep 25

  • pjDate_ddd_mm_dd: Tue 9/25

  • pjDate_ddd_dd: Tue 25

  • pjDate_Www_dd: W40/2

  • pjDate_Www_dd_yy_hh_mmAM: W40/2/07 12:33 PM

ProjDateDiff

Retorna a duração entre duas datas em minutos.

Sintaxe

ProjDateDiff( data1, data2, calendário )

data1  Obrigatório; Variante. A data usada como início da duração.

data2  Obrigatório; Variante. A data usada como final da duração.

calendário  Opcional; Cadeia. O calendário que deve ser usado ao calcular a duração. Se calendário não for especificado, o padrão para o recurso atual será o calendário do recurso ou, para a tarefa atual, o calendário da tarefa ou o calendário padrão, caso não haja um calendário da tarefa. No Project Server, o calendário padrão será usado, independentemente do calendário especificado na cadeia calendário. Quando você usa essa função em uma fórmula criada no Project Web App e a compara com a mesma fórmula criada no Project Professional, faça um teste para garantir que os resultados sejam os esperados.

ProjDateSub

Retorna a data que precede outra data por uma duração especificada.

Sintaxe

ProjDateSub( data, duração, calendário )

data  Obrigatório; Variante. A data original da qual a duração é subtraída.

duração  Obrigatório; Variante. A duração a ser subtraída da data.

calendário  Opcional; Cadeia. O calendário que deve ser usado ao calcular a diferença de data. Se calendário não for especificado, o padrão para o recurso atual será o calendário do recurso ou, para a tarefa atual, o calendário da tarefa (ou o calendário padrão, caso não haja um calendário da tarefa). No Project Server, o calendário padrão será usado, independentemente do calendário especificado na cadeia calendário. Quando você usa essa função em uma fórmula criada no Project Web App e a compara com a mesma fórmula criada no Project Professional, faça um teste para garantir que os resultados sejam os esperados.

Observação :  Para subtrair sete dias de uma data especificada, a seguinte fórmula funciona corretamente no Project Professional 2010: ProjDateAdd("9/24/2010", "-7d"). No entanto, quando você executa a mesma fórmula no Project Server 2010, o resultado é 9/24/2010, não 9/17/2010. Para fórmulas que funcionam de maneira consistente no Project Professional 2010 e no Project Server 2010, você deve evitar parâmetros negativos para as funções ProjDateAdd e ProjDateSub.

ProjDateValue

Retorna o valor de data de uma expressão.

Sintaxe

ProjDateValue( expressão )

expressão  Obrigatório; Variante. A expressão a ser representada como uma data.

ProjDurConv

Converte uma expressão em um valor de duração nas unidades especificadas.

Sintaxe

ProjDurConv( expressão, unidades_duração )

expressão  Obrigatório; Variante. A expressão a ser convertida em uma duração.

unidades_duração  Opcional; Longo. As unidades usadas para expressar a duração. Se unidades_duração não for especificado, o valor padrão será o tipo de unidades especificado na opção A duração é inserida em na guia Agendar da caixa de diálogo Opções (menu Ferramentas). unidades_duração pode ser uma das seguintes constantes de pjFormatUnit:

  • pjMinutes: pjElapsedMinutes

  • pjHours: pjElapsedHours

  • pjDays: pjElapsedDays

  • pjWeeks: pjElapsedWeeks

  • pjMonths: pjElapsedMonths

  • pjMinutesEstimated: pjElapsedMinutesEstimated

  • pjHoursEstimated: pjElapsedHoursEstimated

  • pjDaysEstimated: pjElapsedDaysEstimated

  • pjWeeksEstimated: pjElapsedWeeksEstimated

  • pjMonthsEstimated: pjElapsedMonthsEstimated

ProjDurValue

Retorna o número de minutos em uma duração.

Sintaxe

ProjDurValue( duração )

duração  Obrigatório; Variante. A duração a ser expressa em minutos.

Segundo

Retorna uma Variante (Inteiro) que especifica um número inteiro entre 0 e 59, inclusive, representando o segundo do minuto.

Sintaxe

Second( hora )

hora  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma hora. Se hora contiver Nulo, Nulo será retornado.

Hora

Retorna uma Variante (Data) que indica a hora do sistema atual.

Sintaxe

Horário

Timer

Retorna um Simples que representa o número de segundos decorridos desde meia-noite.

Sintaxe

Timer

TimeSerial

Retorna uma Variante (Data) que contém o horário de uma determinada hora, minuto e segundo.

Sintaxe

TimeSerial( hora, minuto, segundo)

hora  Obrigatório; Variante (Inteiro). Número entre 0 (0h00) e 23 (23h00), inclusive, ou uma expressão numérica.

minuto  Obrigatório; Variante (Inteiro). Qualquer expressão numérica.

segundo  Obrigatório; Variante (Inteiro). Qualquer expressão numérica.

TimeValue

Retorna uma Variante (Data) que contém a hora.

Sintaxe

TimeValue( hora)

hora  Obrigatório; normalmente, uma expressão de cadeia de caracteres que representa uma hora, de 0:00:00 (0h00m00) a 23:59:59 (23h59m59), inclusive. No entanto, hora também pode ser qualquer expressão que represente uma hora nesse intervalo. Se hora contiver Nulo, Nulo será retornado.

Dia da semana

Retorna uma Variante (Inteiro) que contém um número inteiro representando o dia da semana.

Sintaxe

Weekday( data[, primeirodiadasemana] )

data  Obrigatório; Variante, expressão numérica, expressão de cadeia de caracteres de qualquer combinação que possa representar uma data. Se data contiver Nulo, Nulo será retornado.

primeirodiadasemana  Opcional; uma constante que especifica o primeiro dia da semana. Se não especificado, será usado o domingo.

Ano

Retorna uma Variante (Inteiro) que contém um número inteiro representando o ano.

Sintaxe

Year( data )

data  Obrigatório; qualquer Variante, expressão numérica ou expressão de cadeia de caracteres, ou qualquer combinação, que possa representar uma data. Se data contiver Nulo, Nulo será retornado.

Funções gerais

Escolher

Seleciona e retorna um valor de uma lista de argumentos.

Sintaxe

Choose( índice, opção-1[, opção-2, ... [, opção-n]])

índice  Obrigatório; expressão ou campo numérico que resulta em um valor entre 1 e o número de opções disponíveis.

opção  Obrigatório; Variante expressão que contém uma das opções possíveis.

IIf

Retorna uma de duas partes, dependendo da avaliação de uma expressão.

Sintaxe

IIf( expr, parteverdadeira, partefalsa )

expr  Obrigatório; Variante expressão que você deseja avaliar.

parteverdadeira  Obrigatório; valor ou expressão que deverá ser retornada se a expressão correspondente for Verdadeiro.

falsepart  Obrigatório; valor ou expressão que deverá ser retornada se a expressão correspondente for False.

IsNumeric

Retorna um valor Booliano que indica se uma expressão pode ser avaliada como um número.

Sintaxe

IsNumeric( expressão)

expressão  Obrigatório; Variante que contém uma expressão numérica ou uma expressão de cadeia de caracteres.

IsNull

Retorna um valor Booliano que indica se uma expressão não contém dados válidos (Nulo).

Sintaxe

IsNull( expressão )

expressão  Obrigatório; Variante que contém uma expressão numérica ou uma expressão de cadeia de caracteres.

Switch

Avalia uma lista de expressões e retorna um valor ou uma expressão Variante associada com a primeira expressão da lista que é Verdadeiro.

Sintaxe

Switch( expr-1, valor-1[, expr-2, valor-2, ... [, expr-n,valor-n]] )

Funções matemáticas

ABS

Retorna um valor do mesmo tipo que é passado para ele especificando o valor absoluto de um número.

Sintaxe

Abs( número )

número  Obrigatório; qualquer expressão numérica válida. Se Obrigatório contiver Nulo, Nulo será retornado; se for uma variável que não pode ser inicializada, zero será retornado.

Atn

Retorna um Duplo que especifica o arco tangente de um número.

Sintaxe

Atn( número )

número  Obrigatório; Duplo ou qualquer expressão numérica válida.

Cos

Retorna um Duplo que especifica o cosseno de um ângulo.

Sintaxe

Cos( número )

número  Obrigatório; Duplo ou qualquer expressão numérica válida que expresse um ângulo em radianos.

Exp

Retorna um Duplo que especifica e (a base de logaritmos naturais) elevado a uma potência.

Sintaxe

Exp( número )

número  Obrigatório; Duplo ou qualquer expressão numérica válida.

Fix

Retorna a parte inteira de um número. Se o número for negativo, retornará o primeiro inteiro negativo igual a ou maior que o número.

Sintaxe

Fix( número )

número  Obrigatório; Duplo ou qualquer expressão numérica válida. Se número contiver Nulo, Nulo será retornado.

Int

Retorna a parte inteira de um número. Se o número for negativo, retornará o primeiro inteiro negativo menor que ou igual ao número.

Sintaxe

Int( número )

número  Obrigatório; Duplo ou qualquer expressão numérica válida. Se número contiver Nulo, Nulo será retornado.

Log

Retorna um Duplo que especifica o logaritmo natural de um número.

Sintaxe

Log( número )

número  Obrigatório; Duplo ou qualquer expressão numérica válida maior que zero.

Rnd

Retorna um Simples que contém um número aleatório.

Sintaxe

Rnd( número )

número  Obrigatório; Simples ou qualquer expressão numérica válida.

Sgn

Retorna uma Variante (Inteiro) que indica o sinal de um número.

Sintaxe

Sgn( número )

número  Obrigatório; qualquer expressão numérica válida.

Os valores de retorno são os seguintes:

  • Se o número for maior que zero, Sgn retornará 1.

  • Se o número for igual a zero, Sgn retornará 0.

  • Se o número for menor que zero, Sgn retornará -1.

Sin

Retorna um Duplo que especifica o seno de um ângulo.

Sintaxe

Sin( número )

número  Obrigatório; Duplo ou qualquer expressão numérica válida que expresse um ângulo em radianos.

Sqr

Retorna um Duplo que especifica a raiz quadrada de um número.

Sintaxe

Sqr( número )

número  Obrigatório; Duplo ou qualquer expressão numérica válida igual a ou maior que zero.

Tan

Retorna um Duplo que especifica a tangente de um ângulo.

Sintaxe

Tan( número )

número  Obrigatório; Duplo ou qualquer expressão numérica válida que expresse um ângulo em radianos.

Funções de texto

Cresc

Retorna um Inteiro que representa o código de caractere correspondente à primeira letra de uma cadeia.

Sintaxe

Asc( cadeia )

cadeia  Qualquer expressão de cadeia de caracteres válida.

Chr

Retorna uma Cadeia que contém o caractere associado ao código do caractere especificado.

Sintaxe

Chr( códcaract )

códcaract  Um Longo que identifica um caractere.

Formatar

Retorna uma Variante (Cadeia) que contém uma expressão formatada de acordo com as instruções contidas em uma expressão de formato.

Sintaxe

Format( expressão[, formato[, primeirodiadasemana[, primeirasemanadoano]]] )

expressão  Obrigatório; qualquer expressão válida.

formato  Opcional; uma expressão de formato nomeada ou definida pelo usuário válida.

primeirodiadasemana  Opcional; uma Constante que especifica o primeiro dia da semana.

primeirasemanadoano  Opcional; uma Constante que especifica a primeira semana do ano.

Instr

Retorna uma Variante (Longo) que especifica a posição da primeira ocorrência de uma cadeia em outra.

Sintaxe

Instr( [início, ]cadeia1, cadeia2[, comparar] )

início  Opcional; expressão numérica que define a posição inicial de cada pesquisa. Se omitido, a pesquisa começará na posição do primeiro caractere. Se início contiver Nulo, ocorrerá um erro. O argumento inícioserá necessário se comparar for especificado.

cadeia1  Obrigatório; expressão de cadeia de caracteres que está sendo pesquisada.

cadeia2  Obrigatório; expressão de cadeia de caracteres procurada.

comparar  Opcional; especifica o tipo de comparação de cadeias. Se comparar for Nulo, ocorrerá um erro. Se comparar for omitido, a configuração de Opçãocomparar determinará o tipo de comparação.

LCase

Retorna uma Cadeia que foi convertida em minúsculas.

Sintaxe

LCase( cadeia )

cadeia   Obrigatório; qualquer expressão de cadeia de caracteres válida. Se cadeia contiver Nulo, Nulo será retornado.

Para a Esquerda

Retorna uma Variante (Cadeia) que contém um número especificado de caracteres do lado esquerdo de uma cadeia.

Sintaxe

Left( cadeia, comprimento )

cadeia  Obrigatório. Expressão de cadeia de caracteres cujos caracteres à esquerda são retornados. Se cadeia contiver Nulo, Nulo será retornado.

comprimento  Obrigatório; Variante (Longo). Expressão numérica que indica quantos caracteres devem ser retornados. Se 0, uma cadeia de comprimento zero ("") será retornada. Se maior que ou igual ao número de caracteres na cadeia, a cadeia inteira será retornada.

Len

Retorna um Longo que contém o número de caracteres em uma cadeia ou o número de bytes necessários para armazenar uma variável.

Sintaxe

Len( cadeia, nomedavariável )

cadeia  Qualquer expressão de cadeia de caracteres válida. Se cadeia contiver Nulo, Nulo será retornado.

nomedavariável  Qualquer nome de variável válido. Se nomedavariável contiver Nulo, Nulo será retornado. Se nomedavariável for uma Variante, Len a tratará da mesma forma que uma Cadeia e sempre retornará o número de caracteres que ela contém.

LTrim

Retorna uma Variante (Cadeia) que contém uma cópia de uma cadeia especificada sem espaços à esquerda.

Sintaxe

LTrim( cadeia )

cadeia  Obrigatório; qualquer expressão de cadeia de caracteres válida. Se cadeia contiver Nulo, Nulo será retornado.

Mid

Retorna uma Variante (Cadeia) que contém um número especificado de caracteres de uma cadeia.

Sintaxe

Mid( cadeia, início[, comprimento] )

cadeia  Obrigatório; expressão de cadeia de caracteres cujos caracteres são retornados. Se cadeia contiver Nulo, Nulo será retornado.

início  Obrigatório; Longo. Posição do caractere na cadeia na qual a parte a ser obtida começa. Se início for maior que o número de caracteres na cadeia, Mid retornará uma cadeia de comprimento zero ("").

comprimento  Opcional; Variante (Longo). Número de caracteres que devem ser retornados. Se omitido ou se houver menos caracteres que o comprimento no texto (incluindo o caractere no início), todos os caracteres da posição de início até o final da cadeia serão retornados.

Para a Direita

Retorna uma Variante (Cadeia) que contém um número especificado de caracteres do lado direito de uma cadeia.

Sintaxe

Right( cadeia, comprimento )

cadeia  Obrigatório; expressão de cadeia de caracteres cujos caracteres à direita são retornados. Se cadeia contiver Nulo, Nulo será retornado.

comprimento  Obrigatório; Variante (Longo). Expressão numérica que indica quantos caracteres devem ser retornados. Se 0, uma cadeia de comprimento zero ("") será retornada. Se igual a ou maior que o número de caracteres na cadeia, a cadeia inteira será retornada.

RTrim

Retorna uma Variante (Cadeia) que contém uma cópia de uma cadeia especificada sem espaços à direita.

Sintaxe

RTrim( cadeia )

cadeia  Obrigatório; qualquer expressão de cadeia de caracteres válida. Se cadeia contiver Nulo, Nulo será retornado.

Espaço

Retorna uma Variante (Cadeia) que consiste no número especificado de espaços.

Sintaxe

Space( número )

número  Obrigatório; número de espaços que você deseja na cadeia.

StrComp

Retorna uma Variante (Inteiro) que indica o resultado de uma comparação de cadeias.

Sintaxe

StrComp( cadeia1, cadeia2[, comparar] )

cadeia1  Obrigatório; qualquer expressão de cadeia de caracteres válida.

cadeia2  Obrigatório; qualquer expressão de cadeia de caracteres válida.

comparar  Opcional; especifica o tipo de comparação de cadeias. Se argumento comparar for Nulo, ocorrerá um erro.

StrConv

Retorna uma Variante (Cadeia) convertida conforme especificado.

Sintaxe

StrConv( cadeia, conversão, LCID )

cadeia  Obrigatório; expressão de cadeia de caracteres a ser convertida.

conversão  Obrigatório; Inteiro. A soma de valores que especifica o tipo de conversão que deve ser executada.

LCID  Opcional; LocaleID, se diferente do LocaleID do sistema. (O LocaleID do sistema é o padrão.)

Cadeia de caracteres

Retorna uma Variante (Cadeia) que contém uma cadeia de caracteres repetida com o comprimento especificado.

Sintaxe

String( número, caractere )

número  Obrigatório; Longo. Comprimento da cadeia retornada. Se número contiver Nulo, Nulo será retornado.

caractere  Obrigatório; Variante. Código de caractere que especifica a expressão de caractere ou cadeia de caracteres cujo primeiro caractere é usado para criar a cadeia de retorno. Se caractere contiver Nulo, Nulo será retornado.

Cortar

Retorna uma Variante (Cadeia) que contém uma cópia de uma cadeia especificada sem espaços à esquerda ou à direita.

Sintaxe

Trim( cadeia )

cadeia  Obrigatório; qualquer expressão de cadeia de caracteres válida. Se cadeia contiver Nulo, Nulo será retornado.

UCase

Retorna uma Variante (Cadeia) que contém a cadeia especificada, convertida em maiúsculas.

Sintaxe

UCase( cadeia )

cadeia  Obrigatório; qualquer expressão de cadeia de caracteres válida. Se cadeia contiver Nulo, Nulo será retornado.

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×