Funções do Project

As funções seguintes são utilizadas em fórmulas para calcular os valores de campos personalizados.

Sugestão: Para introduzir uma fórmula num campo personalizado do 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 no separador Projeto e, no grupo Propriedades, clique em Campos Personalizados. Na caixa de diálogo Campos Personalizados, clique em Fórmula.

Descrição geral das funções do Project

Quando utiliza o Microsoft Project, pode precisar de trabalhar com valores que não se encontram diretamente nos campos. As fórmulas permitem trabalhar com campos para criar esses valores novos.

Os exemplos seguintes mostram como pode utilizar fórmulas em campos personalizados:

  • Ao adicionar a fórmula seguinte a um campo numérico personalizado, esta devolve um valor numérico que indica o número de dias entre a data atual e a data de conclusão das tarefas na agenda:

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

  • Ao adicionar a fórmula seguinte a um campo de texto personalizado, esta devolve um valor de "Sem Linha de Base," "20% ou mais acima do orçamento," 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

Asc

Devolve um Número Inteiro que representa o código de caráter correspondente à primeira letra numa cadeia.

Sintaxe

Asc( cadeia )

cadeia  Uma expressão de cadeia válida.

CBool

Impõe uma expressão ao tipo de dados Booleano.

Sintaxe

CBool( expressão )

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

CByte

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

Sintaxe

CByte( expressão )

expressão  Um Número Inteiro de 0 a 255.

CCur

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

Sintaxe

CCur( expressão )

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

CData

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

Sintaxe

CDate( expressão )

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

CDbl

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

Sintaxe

CDbl( expressão )

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

CDec

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

Sintaxe

CDec( expressão )

expressão  Uma expressão numérica de +/-79.228.162.514.264.337.593.543.950.335 para números sem casas decimais. Para números com 28 casas decimais, o intervalo é +/-7,9228162514264337593543950335. O número mais pequeno diferente de zero é 0,0000000000000000000000000001.

Chr

Devolve uma Cadeia que contém o caráter associado ao código de caráter especificado.

Sintaxe

Chr( códigodocaráter )

códigodocaráter  Um valorLongo que identifica um caráter.

CInt

Impõe uma expressão ao tipo de dados Número Inteiro.

Sintaxe

CInt( expressão )

expressão  Uma expressão numérica de -32.768 a 32.767. As frações são arredondadas.

CLng

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

Sintaxe

CLng( expressão )

expressão  Uma 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 ao tipo de dados Simples.

Sintaxe

CSng( expressão )

expressão  Uma expressão numérica -3,402823E38 a -1,401298E-45 para valores negativos e de 1,401298E-45 a 3,402823E38 para valores positivos.

CStr

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

Sintaxe

CStr( expressão )

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

CVar

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

Sintaxe

CVar( expressão )

expressão  O mesmo intervalo que Duplo para carateres numéricos. O mesmo intervalo de Cadeia para carateres não numéricos.

DataSerial

Devolve uma Variante (Data) para um ano, mês ou dia especificado.

Sintaxe

DateSerial( ano, mês, dia)

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

mês  Necessário; Número Inteiro. Qualquer expressão numérica.

dia  Necessário; Número Inteiro. Qualquer expressão numérica.

DATA.VALOR

Devolve uma Variante (Data).

Sintaxe

DateValue( data )

data  Necessário; normalmente uma expressão de cadeia que representa uma data desde 1 de janeiro de 100 até 31 de dezembro de 9999. No entanto, a data também pode ser uma expressão que represente uma data, uma hora ou uma data e hora, nesse intervalo.

Dia

Devolve uma Variante (Número Inteiro) especificando um número inteiro entre 1 e 31, inclusive, que representa o dia do mês.

Sintaxe

Dia( data)

data  Necessário; uma Variante, expressão numérica ou expressão de cadeia, ou qualquer combinação que represente uma data. Se data contiver Nulo, será devolvido Nulo.

Hex

Devolve uma Cadeia representando o valor hexadecimal de um número.

Sintaxe

Hex( número )

número  Necessário; uma expressão de cadeia ou numérica válida.

Hora

Devolve uma Variante (Número Inteiro) especificando um número inteiro entre 0 e 23, inclusive, que representa a hora do dia

Sintaxe

Hora( hora )

hora  Necessário; qualquer Variante, expressão numérica ou expressão de cadeia, ou qualquer combinação que represente uma hora. Se a hora contiver Nulo, Nulo é devolvido

Minuto

Devolve uma Variante (Número Inteiro) especificando um número inteiro entre 0 e 59, inclusive, que representa o minuto da hora

Sintaxe

Minuto( hora )

hora  Necessário; qualquer Variante, expressão numérica ou de cadeia, ou qualquer combinação que represente uma hora. Se a hora contiver Nulo, Nulo é devolvido.

Mês

Devolve uma Variante (Número Inteiro) especificando um número inteiro entre 1 e 12, inclusive, que representa o mês do ano.

Sintaxe

Mês( data)

data  Necessário; qualquer Variante, expressão numérica ou de cadeia, ou qualquer combinação que represente uma hora. Se a data contiver Nulo, Nulo é devolvido.

Out

Devolve uma Variante (Cadeia) representando o valor octal de um número.

Sintaxe

Oct( número )

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

ProjDateConv

Converte um valor numa data.

Sintaxe

ProjDateConv( expressão, formatodedata )

expressão  Necessário; Variante. A expressão a converter numa data.

formatodedata  Opcional; Longo. O formato de data predefinido é pjDateDefault, mas pode substituir uma das seguintes constantes pjDateFormat (formato de data aplicado em 25/9/07 às 12:33):

  • pjDateDefault: o formato predefinido. Definido no separador Ver, na caixa de diálogo Opções (menu Ferramentas.)

  • pjDate_dd_M_yy_hh_mm: 25/9/07 12:33

  • pjDate_dd_M_yy: 25/9/07

  • pjDate_dd_M_yyyy: 25/9/2007

  • pjDate_d_de_MMMM_de_yyyy_ hh_mm: 25 de setembro de 2007 12:33

  • pjDate_d_de_MMMM_de_yyyy: 25 de setembro de 2007

  • pjDate_dd_MMM_hh_mm: 25 de set. 12:33

  • pjDate_dd_MMM_yy: 25 set. 07

  • pjDate_dd_MMMM: 25 setembro

  • pjDate_dd_MMM: 25 set.

  • pjDate_ddd_dd_MM_yy_hh_mm: ter. 25/9/07 12:33

  • pjDate_ddd_dd_MM_yy: ter. 25/9/07

  • pjDate_ddd_dd_MMM_yy: ter. 25 de set. 07

  • pjDate_ddd_hh_mm: ter. 12:33

  • pjDate_dd_mm: 25/9

  • pjDate_dd: 25

  • pjDate_hh_mm: 12:33

  • pjDate_ddd_dd_MMM: ter. 25 de set.

  • pjDate_ddd_dd_MM: ter. 25/9

  • pjDate_ddd_dd: ter. 25

  • pjDate_Qqq_dd: Q40/2

  • pjDate_Qqq_dd_yy_hh_mm: Q40/2/07 12:33

ProjDurConv

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

Sintaxe

ProjDurConv( expressão, unidadesdeduração )

expressão  Necessário; Variante. A expressão para converter numa duração.

unidadesdeduração  Opcional; Longo. As unidades utilizadas para expressar a duração. Se unidadesdeduração não for especificado, o valor predefinido é o tipo de unidades especificadas na opção Duração indicada em, no separador Agenda, da caixa de diálogo Opções (menu Ferramentas). As unidadesdeduração podem ser uma das seguintes constantes pjFormatUnit:

  • pjMinutes: pjElapsedMinutes

  • pjHours: pjElapsedHours

  • pjDays: pjElapsedDays

  • pjWeeks: pjElapsedWeeks

  • pjMonths: pjElapsedMonths

  • pjMinutesEstimated: pjElapsedMinutesEstimated

  • pjHoursEstimated: pjElapsedHoursEstimated

  • pjDaysEstimated: pjElapsedDaysEstimated

  • pjWeeksEstimated: pjElapsedWeeksEstimated

  • pjMonthsEstimated: pjElapsedMonthsEstimated

Segundo

Devolve uma Variante (Número Inteiro) especificando um número inteiro entre 0 e 59, inclusive, que representa o segundo do minuto.

Sintaxe

Second( hora )

hora  Necessário; qualquer Variante, expressão numérica ou expressão de cadeia, ou qualquer combinação que represente uma hora. Se a hora contiver Nulo, Nulo é devolvido.

Cad

Devolve a representação da Variante (Cadeia) de um número.

Sintaxe

Str( número )

número  Necessário; Longo contendo qualquer expressão numérica válida.

StrConv

Devolve uma Variante (Cadeia) convertida conforme especificado.

Sintaxe

StrConv( cadeia, conversão, LCID )

cadeia  Necessário; expressão de cadeia a ser convertida.

conversão  Necessário; Número Inteiro. A soma de valores que especifica o tipo de conversão a ser efetuada.

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

SerieHora

Devolve uma Variante (Data) que contém a hora de uma hora, minuto ou segundo específicos.

Sintaxe

TimeSerial( hora, minuto, segundo )

hora  Necessário; Variante (Número Inteiro). Número entre 0 (00:00) e 23 (23:00), inclusive, ou uma expressão numérica.

minuto  Necessário; Variante (Número Inteiro). Qualquer expressão numérica.

segundo  Necessário; Variante (Número Inteiro). Qualquer expressão numérica.

VALOR.TEMPO

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

Sintaxe

TimeValue( hora)

hora  Necessário; normalmente uma expressão de cadeia que representa uma hora de 0:00:00 até 23:59:59, inclusive. No entanto, a hora também pode ser qualquer expressão que represente uma hora nesse intervalo. Se a hora contiver Nulo, Nulo é devolvido.

Val

Devolve os números contidos numa cadeia como um valor numérico de um tipo determinado.

Sintaxe

Val( cadeia )

cadeia  Necessário; qualquer cadeia da expressão válida.

Dia da semana

Devolve uma Variante (Número Inteiro) que contém um número inteiro que representa o dia da semana.

Sintaxe

Weekday( data[, primeirodiadasemana] )

data  Necessário; Variante, expressão numérica, cadeia da expressão ou qualquer combinação que pode representar uma data. Se data contiver Nulo, Nulo é devolvido.

primeirodiadasemana  Opcional; uma constante que especifica o primeiro dia da semana. Se não for especificado, domingo é considerado o primeiro dia.

Ano

Devolve uma Variante (Número Inteiro) que contém um número inteiro que representa o ano.

Sintaxe

Year( data )

data  Necessário; qualquer Variante, expressão numérica ou de cadeia, ou qualquer combinação que pode representar uma data. Se data contiver Nulo, Nulo é devolvido.

Funções de Data/Hora

CData

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

Sintaxe

CDate( expressão )

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

Data

Devolve uma Variante (Data) contendo a data do sistema atual.

Sintaxe

Data

SomData

Devolve uma Variante (Data) contendo a data à qual foi adicionado um intervalo de tempo especifico.

Sintaxe

DateAdd( intervalo, número, data

intervalo  Necessário; Expressão de cadeia que corresponde ao intervalo de tempo que pretende adicionar, como "m" ou "d".

number  Necessário; expressão numérica que corresponde ao número de intervalos que pretende adicionar. Pode ser positivo (para obter datas no futuro) ou negativo (para obter datas no passado)

data  Necessário; Variante (Data) ou valor literal representando a data à qual o intervalo é adicionado

DifData

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

Sintaxe

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

intervalo  Necessário; expressão de cadeia que corresponde ao intervalo de tempo utilizado para calcular a diferença entre data1 e data2.

data1, data2  Necessário; Variante (Data). Duas datas que pretende utilizar no cálculo

primeirodiadasemana  Opcional; uma constante que especifica o primeiro dia da semana. Se não for especificado, domingo é considerado o primeiro dia.

primeirasemanadoano  Opcional; uma constante que especifica a primeira semana do ano. Se não for especificado, pressupõe-se que a primeira semana é a semana de 1 de janeiro.

PartData

Devolve uma Variante (Número Inteiro) contendo a parte especificada de uma determinada data.

Sintaxe

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

intervalo  Necessário; expressão de cadeia que corresponde ao intervalo de tempo que pretende devolver.

data  Necessário; Variante (Data) valor que pretende avaliar.

primeirodiadasemana  Opcional; uma constante que especifica o primeiro dia da semana. Se não for especificado, domingo é considerado o primeiro dia.

primeirasemanadoano  Opcional; uma constante que especifica a primeira semana do ano. Se não for especificado, pressupõe-se que a primeira semana é a semana de 1 de janeiro.

DataSerial

Devolve uma Variante (Data) para um ano, mês ou dia especificado.

Sintaxe

DateSerial( ano, mês, dia)

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

mês  Necessário; Número Inteiro. Qualquer expressão numérica.

dia  Necessário; Número Inteiro. Qualquer expressão numérica.

DATA.VALOR

Devolve uma Variante (Data).

Sintaxe

DateValue( data)

adata  Necessário; normalmente uma cadeia de expressão que representa uma data desde 1 de janeiro de 100 até 31 de dezembro de 9999. No entanto, a data também pode ser qualquer expressão que represente uma data, uma hora ou uma data e hora, nesse intervalo.

Dia

Devolve uma Variante (Número Inteiro) especificando um número inteiro entre 1 e 31, inclusive, que representa o dia do mês.

Sintaxe

Dia( data)

data  Necessário; qualquer Variante, expressão numérica ou expressão de cadeia, ou qualquer combinação que pode representar uma data. Se data contiver Nulo, Nulo é devolvido

Hora

Devolve uma Variante (Número Inteiro) especificando um número inteiro entre 0 e 23, inclusive, que representa a hora do dia

Sintaxe

Hora( hora )

hora  Necessário; qualquer Variante, expressão numérica ou expressão de cadeia, ou qualquer combinação que represente uma hora. Se a hora contiver Nulo, Nulo é devolvido

ÉData

Devolve um valor Booleano que indica se uma expressão pode ser convertida em data.

Sintaxe

IsDate( expressão )

expressão  Necessário; qualquer Variante contendo uma expressão de data ou expressão de cadeia reconhecível como data e hora.

Minuto

Devolve uma Variante (Número Inteiro) especificando um número inteiro entre 0 e 59, inclusive, que representa o minuto da hora

Sintaxe

Minute( hora)

hora  Necessário; qualquer Variante, expressão numérica ou expressão de cadeia, ou qualquer combinação que represente uma hora. Se a hora contiver Nulo, Nulo é devolvido.

Mês

Devolve uma Variante (Número Inteiro) especificando um número inteiro entre 1 e 12, inclusive, que representa o mês do ano.

Sintaxe

Mês( data)

data  Necessário; qualquer Variante, expressão numérica ou expressão de cadeia, ou qualquer combinação que possa representar uma hora. Se data contiver Nulo, Nulo é devolvido.

Agora

Devolve uma Variante (Data) especificando a data e hora atuais, de acordo com a data e hora do sistema informático do utilizador.

Sintaxe

Agora

ProjDateAdd

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

Sintaxe

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

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

duração  Necessário; Variante. A duração a adicionar à data.

calendário  Opcional; Cadeia. O calendário a utilizar no cálculo da nova data. Se calendário não for especificado, a predefiniçã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 se não existir calendário da tarefa. O calendário padrão do Project Server será usado independentemente do calendário que seja especificado na cadeia calendário. Quando usa esta função numa fórmula criada no Project Web App e a compara com a mesma fórmula criada no Project Professional, deve testá-la para assegurar que os resultados são os esperados.

Nota: Para subtrair sete dias a uma data especificada, a seguinte fórmula funciona corretamente no Project Professional 2010: ProjDateAdd("24/09/2010", "-7d"). No entanto, se utilizar a mesma fórmula no Project Server 2010, o resultado é 24/09/2010 e não 17/09/2010. Para que as fórmulas funcionem de forma consistente no Project Professional 2010 e no Project Server 2010, deve evitar utilizar parâmetros negativos nas funções de ProjDateAdd e ProjDateSub.

ProjDateConv

Converte um valor numa data.

Sintaxe

ProjDateConv( expressão, formatodedata )

expressão  Necessário; Variante. A expressão a converter numa data.

formatodedata  Opcional; Longo. O formato de data predefinido é pjDateDefault, mas pode substituir uma das seguintes constantes pjDateFormat (formato de data aplicado 25/9/07 às 12:33 ):

  • pjDateDefault: o formato predefinido. Definido no separador Ver, na caixa de diálogo Opções (menu Ferramentas.)

  • pjDate_dd_M_yy_hh_mm: 25/9/07 12:33

  • pjDate_dd_M_yy: 25/9/07

  • pjDate_dd_M_yyyy: 25/9/2007

  • pjDate_d_de_MMMM_de_yyyy_ hh_mm: 25 de setembro de 2007 12:33

  • pjDate_d_de_MMMM_de_yyyy: 25 de setembro de 2007

  • pjDate_dd_MMM_hh_mm: 25 de set. 12:33

  • pjDate_dd_MMM_yy: 25 set. 07

  • pjDate_dd_MMMM: 25 setembro

  • pjDate_dd_MMM: 25 set.

  • pjDate_ddd_dd_mm_yy_hh_mm: ter. 25/9/07 12:33

  • pjDate_ddd_dd_mm_yy: ter. 25/9/03

  • pjDate_ddd_dd_mmm_yyy: ter. 25 set. '07

  • pjDate_ddd_hh_mm: ter. 12:33

  • pjDate_dd_mm: 25/9

  • pjDate_dd: 25

  • pjDate_hh_mm: 12:33

  • pjDate_ddd_dd_MMM: ter. 25 de set.

  • pjDate_ddd_dd_MM: ter. 25/9

  • pjDate_ddd_dd: ter. 25

  • pjDate_Qqq_dd: Q40/2

  • pjDate_Qqq_dd_yy_hh_mm: Q40/2/07 12:33

ProjDateDiff

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

Sintaxe

ProjDateDiff( data1, data2, calendário )

data1  Necessário; Variante. A data utilizada como o início da duração.

data2  Necessário; Variante. A data utilizada como o fim da duração.

calendário  Opcional; Cadeia. O calendário a utilizar no calculo da duração. Se calendário não for especificado, a predefiniçã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, se não existir calendário da tarefa). No Project Server, será utilizado o calendário padrão mesmo que o especificado na cadeia calendário seja outro. Quando utiliza esta função numa fórmula criada no Project Web App e a compara com a mesma fórmula criada no Project Professional, deve efetuar um teste para assegurar que os resultados são os esperados.

ProjDateSub

Devolve a data que precede outra data com uma duração especificada.

Sintaxe

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

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

duração  Necessário; Variante. A duração a subtrair à data.

calendário  Opcional; Cadeia. O calendário a utilizar no cálculo da diferença de data. Se calendário não for especificado, a predefiniçã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 se não existir calendário de tarefa). No Project Server, será utilizado o calendário padrão, mesmo que o especificado na cadeia calendário seja outro. Quando utiliza esta função numa fórmula criada no Project Web App e a compara com a mesma fórmula criada no Project Professional, deve efetuar um teste para assegurar que os resultados são os esperados.

Nota: Para subtrair sete dias a uma data especificada, a seguinte fórmula funciona corretamente no Project Professional 2010: ProjDateAdd("24/09/2010", "-7d"). No entanto, se utilizar a mesma fórmula no Project Server 2010, o resultado é 24/09/2010 e não 17/09/2010. Para que as fórmulas funcionem de forma consistente no Project Professional 2010 e no Project Server 2010, deve evitar utilizar parâmetros negativos nas funções de ProjDateAdd e ProjDateSub.

ProjDateValue

Devolve o valor de data de uma expressão.

Sintaxe

ProjDateValue( expressão )

expressão  Necessário; Variante. A expressão a representar como uma data.

ProjDurConv

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

Sintaxe

ProjDurConv( expressão, unidadesdeduração )

expressão  Necessário; Variante. A expressão para converter numa duração.

unidadesdeduração  Opcional; Longo. As unidades utilizadas para expressar a duração. Se unidadesdeduração não for especificado, o valor predefinido é o tipo de unidades especificadas na opção Duração indicada em, no separador Agenda, da caixa de diálogo Opções (menu Ferramentas). As unidadesdeduração podem ser uma das seguintes constantes pjFormatUnit:

  • pjMinutes: pjElapsedMinutes

  • pjHours: pjElapsedHours

  • pjDays: pjElapsedDays

  • pjWeeks: pjElapsedWeeks

  • pjMonths: pjElapsedMonths

  • pjMinutesEstimated: pjElapsedMinutesEstimated

  • pjHoursEstimated: pjElapsedHoursEstimated

  • pjDaysEstimated: pjElapsedDaysEstimated

  • pjWeeksEstimated: pjElapsedWeeksEstimated

  • pjMonthsEstimated: pjElapsedMonthsEstimated

ProjDurValue

Devolve o número de minutos numa duração.

Sintaxe

ProjDurValue( duração )

duração  Necessário; Variante. A duração a expressar em minutos.

Segundo

Devolve uma Variante (Número Inteiro) especificando um número inteiro entre 0 e 59, inclusive, que representa o segundo do minuto.

Sintaxe

Second( hora )

hora  Necessário; qualquer Variante, expressão numérica ou expressão de cadeia, ou qualquer combinação que represente uma hora. Se a hora contiver Nulo, Nulo é devolvido.

Hora

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

Sintaxe

Hora

Temporizador

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

Sintaxe

Temporizador

SerieHora

Devolve uma Variante (Data) que contém a hora de uma hora, minuto ou segundo específicos.

Sintaxe

TimeSerial( hora, minuto, segundo)

hora  Necessário; Variante (Número Inteiro). Número entre 0 (00:00) e 23 (23:00), inclusive, ou uma expressão numérica.

minuto  Necessário; Variante (Número Inteiro). Qualquer expressão numérica.

segundo  Necessário; Variante (Número Inteiro). Qualquer expressão numérica.

VALOR.TEMPO

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

Sintaxe

TimeValue( hora)

hora  Necessário; normalmente uma expressão de cadeia que representa uma hora de 0:00:00 até 23:59:59, inclusive. No entanto, a hora também pode ser qualquer expressão que represente uma hora nesse intervalo. Se a hora contiver Nulo, Nulo é devolvido.

Dia da semana

Devolve uma Variante (Número Inteiro) que contém um número inteiro que representa o dia da semana.

Sintaxe

Weekday( data[, primeirodiadasemana] )

data  Necessário; Variante, expressão numérica, cadeia da expressão ou qualquer combinação que pode representar uma data. Se data contiver Nulo, Nulo é devolvido.

primeirodiadasemana  Opcional; uma constante que especifica o primeiro dia da semana. Se não for especificado, domingo é considerado o primeiro dia.

Ano

Devolve uma Variante (Número Inteiro) que contém um número inteiro que representa o ano.

Sintaxe

Year( data)

data  Necessário; qualquer Variante, expressão numérica ou expressão de cadeia, ou qualquer combinação que pode representar uma data. Se data contiver Nulo, Nulo é devolvido

Funções Gerais

Selecionar

Seleciona e devolve um valor de uma lista de argumentos.

Sintaxe

Choose( índice, escolha-1[, escolha-2, ... [, escolha-n]])

índice  Necessário; expressão numérica ou campo que resulta num valor entre 1 e o número de escolhas disponíveis.

escolha  Necessário; Variante expressão que contém uma das escolhas possíveis.

IIf

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

Sintaxe

IIf( expr, parteverdadeira, partefalsa )

expr  Necessário; Variante expressão que pretende avaliar.

parteverdadeira  Necessário; valor ou expressão a devolver se a expressão correspondente for Verdadeiro.

partefalsa  Necessário; valor ou expressão a devolver se a expressão correspondente for Falso.

ÉNum

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

Sintaxe

IsNumeric( expressão)

expressão  Necessário; Variante contendo uma expressão numérica ou expressão de cadeia.

ÉNulo

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

Sintaxe

IsNull( expressão )

expressão  Necessário; Variante que contém uma expressão numérica ou expressão de cadeia.

Parâmetro

Avalia uma lista de expressões e devolve um valor de Variante ou uma expressão associada à primeira expressão da lista que é Verdadeira.

Sintaxe

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

Funções Matemáticas

ABS

Devolve um valor do mesmo tipo que lhe é transmitido especificando o valor absoluto de um número.

Sintaxe

Abs( número )

número  Necessário; Qualquer expressão numérica válida. Se número contiver Nulo, Nulo é devolvido; se for uma variável não inicializada, é devolvido o valor zero.

Atg

Devolve um valor Duplo especificando o arco tangente de um número.

Sintaxe

Atn( número )

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

COS

Devolve um valor Duplo especificando o co-seno de um ângulo.

Sintaxe

Cos( número )

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

Exp

Devolve um valor Duplo especificando e (a base dos algoritmos naturais) elevados a uma potência.

Sintaxe

Exp( número )

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

Corrigir

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

Sintaxe

Fix( número )

número  Necessário; Duplo ou qualquer expressão numérica válida. Se número contiver Nulo, Nulo é devolvido.

Int

Devolve a parte inteira de um número. Se o número for negativo devolve o primeiro número inteiro negativo menor ou igual a número.

Sintaxe

Int( número )

número  Necessário; Duplo ou qualquer expressão numérica válida. Se número contiver Nulo, Nulo é devolvido.

Log

Devolve um valor Duplo especificando o algoritmo natural de um número.

Sintaxe

Log( número )

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

Rnd

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

Sintaxe

Rnd( número )

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

Sgn

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

Sintaxe

Sgn( número )

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

Devolve valores da seguinte forma:

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

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

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

Sen

Devolve um valor Duplo especificando o seno de um ângulo.

Sintaxe

Sin( número )

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

Sqr

Devolve um valor Duplo especificando a raiz quadrada de um número.

Sintaxe

Sqr( número )

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

Tan

Devolve um valor Duplo especificando a tangente de um ângulo

Sintaxe

Tan( número )

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

Funções de texto.

Asc

Devolve um Número Inteiro que representa o código de caráter correspondente à primeira letra numa cadeia.

Sintaxe

Asc( cadeia )

Cadeia  Qualquer expressão de cadeia válida.

Chr

Devolve uma Cadeia que contém o caráter associado ao código de caráter especificado.

Sintaxe

Chr( códigodocaráter )

códigodocaráter  Um valorLongo que identifica um caráter.

Formato

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

Sintaxe

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

expressão  Necessário; qualquer expressão válida.

formato  Opcional; uma expressão de formato com nome válido ou definida pelo utilizador.

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

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

InStr

Devolve uma Variante (Longo) especificando a posição da primeira ocorrência de uma cadeia dentro de outra.

Sintaxe

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

início  Opcional; expressão numérica que define a posição inicial para cada procura. Se for omitida, a procura começa na posição do primeiro caráter. Se início contiver Nulo, ocorre um erro. O argumento início é necessário se comparar for especificado.

cadeia1  Necessário; cadeia da expressão a procurar.

cadeia2  Necessário; cadeia da expressão procurada.

comparar  Opcional; especifica o tipo de comparação de cadeias. Se comparar for Nulo, ocorre um erro. Se comparar for omitido, a definição compararOpção determina o tipo de comparação.

LCase

Devolve uma Cadeia que foi convertida em minúscula.

Sintaxe

LCase( cadeia )

cadeia   Necessário; qualquer expressão de cadeia válida. Se cadeia contiver Nulo, Nulo é devolvido.

Esquerda

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

Sintaxe

Left( cadeia, comprimento )

cadeia  Necessário. Expressão de cadeia da qual são devolvidos os carateres mais à esquerda. Se cadeia contiver Nulo, Nulo é devolvido.

comprimento  Necessário; Variante (Longo). Expressão numérica que indica o número de carateres a devolver. Se for 0, será devolvida uma cadeia de comprimento zero (""). Se for maior ou igual ao numero de carateres na cadeia, é devolvida toda a cadeia.

NÚM.CARACT

Devolve um valor Longo que contém o número de carateres numa cadeia ou o número de bytes necessários para armazenar uma variável.

Sintaxe

Len( cadeia, nomevar )

cadeia  Qualquer expressão de cadeia válida. Se cadeia contiver Nulo, Nulo é devolvido.

nomevar  Qualquer nome variável válido. Se nomevar contiver Nulo, Nulo é devolvido. Se nomevar for uma Variante, Len irá tratá-lo como uma Cadeia e devolverá sempre o número de carateres que contiver.

LTrim

Devolve uma Variante (Cadeia) que contém uma cópia de uma cadeia especificada sem espaços de início.

Sintaxe

LTrim( cadeia )

cadeia  Necessário; qualquer expressão de cadeia válida. Se cadeia contiver Nulo, Nulo é devolvido.

SEG.TEXTO

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

Sintaxe

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

cadeia  Necessário; expressão de cadeia da qual são devolvidos carateres. Se cadeia contiver Nulo, Nulo é devolvido.

início  Necessário; Longo. Posição do caráter na cadeia na qual começa a parte a retirar. Se início for maior que o número de carateres na cadeia, Mid devolve uma cadeia de comprimento zero ("").

comprimento  Opcional; Variante (Longo). Número de carateres a devolver. Se for omitido ou se existirem carateres com comprimento menor do que no texto (incluindo o caráter do início), todos os carateres da posição início até ao final da cadeia serão devolvidos.

Direita

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

Sintaxe

Right( cadeia, comprimento )

cadeia  Necessário; expressão de cadeia da qual são devolvidos os carateres mais à direita. Se cadeia contiver Nulo, Nulo é devolvido.

comprimento  Necessário; Variante (Longo). Expressão numérica que indica o número de carateres a devolver. Se for 0, é devolvida uma cadeia de comprimento zero (""). Se for igual ou maior que o número de carateres na cadeia, é devolvida toda a cadeia.

SuprDir

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

Sintaxe

RTrim( cadeia )

cadeia  Necessário; qualquer expressão de cadeia válida. Se cadeia contiver Nulo, Nulo é devolvido.

Espaço

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

Sintaxe

Space( número )

número  Necessário; número de espaços que pretende na cadeia.

StrComp

Devolve uma Variante (Número Inteiro) que indica o resultado de uma comparação de cadeias.

Sintaxe

StrComp( cadeia1, cadeia2[, comparar] )

cadeia1  Necessário; qualquer expressão de cadeia válida.

cadeia2  Necessário; qualquer expressão de cadeia válida.

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

StrConv

Devolve uma Variante (Cadeia) convertida conforme especificado.

Sintaxe

StrConv( cadeia, conversão, LCID )

cadeia  Necessário; expressão de cadeia a ser convertida.

conversão  Necessário; Número Inteiro. A soma de valores que especifica o tipo de conversão a ser efetuada.

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

Cadeia

Devolve uma Variante (Cadeia) que contém uma cadeia de caráter repetido do comprimento especificado.

Sintaxe

String( número, caráter )

número  Necessário; Longo. Comprimento da cadeia devolvida. Se número contiver Nulo, Nulo é devolvido.

caráter  Necessário; Variante. Código do caráter que especifica o caráter ou expressão de cadeia cujo primeiro caráter é usado para formar a cadeia a devolver. Se caráter contiver Nulo, Nulo é devolvido.

Cortar

Devolve uma Variante (Cadeia) que contém uma cópia de uma cadeia especificada sem espaços de início ou de fim.

Sintaxe

Trim( cadeia )

cadeia  Necessário; qualquer expressão de cadeia válida. Se cadeia contiver Nulo, Nulo é devolvido.

UCase

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

Sintaxe

UCase( cadeia )

cadeia  Necessário; qualquer expressão de cadeia válida. Se cadeia contiver Nulo, Nulo é devolvido.

Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×