Funções do Project para campos personalizados no Project para ambiente de trabalho

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

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 Qualquer expressão de cadeia válida.

CBool

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

Sintaxe

CBool( expressão )

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

CByte

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

Sintaxe

CByte( expressão )

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

CCur

Impõe uma expressão ao 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.

CData

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

Sintaxe

CDate( expressão )

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

CDbl

Impõe uma expressão ao 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; 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 Qualquer expressão numérica de +/-79.228.162.514.264.337.593.543.950.335 para números de escala zero, ou seja, 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ódigo de carateres Um Valor Longo que identifica um caráter.

CInt

Impõe uma expressão ao tipo de dados Número 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 ao 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 ao tipo de dados Simples.

Sintaxe

CSng( expressão )

expressão Qualquer expressão numérica -3,402823E38 a -1,401298E-45 para valores negativos; 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 Qualquer cadeia válida ou expressão numérica.

CVar

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

Sintaxe

CVar( expressão )

expressão O mesmo intervalo que Duplo para 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 de 1 de janeiro de 100 a 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; qualquer Variante, expressão numérica, expressão de cadeia ou qualquer combinação que possa representar 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; qualquer cadeia válida ou expressão numérica.

Hora

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

Sintaxe

Hour( hora )

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

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 possa representar uma hora. Se a hora contiver Nulo, será devolvido Nulo.

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 a data contiver Nulo, será devolvido Nulo.

Out

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

Sintaxe

Oct( número )

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

ProjDateConv

Converte um valor numa data.

Sintaxe

ProjDateConv( expressão, formatodedata )

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

formatação de data 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/07
• pjDate_ddd_dd_mmm_yy: 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

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 possa representar uma hora. Se a hora contiver Nulo, será devolvido Nulo.

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 converter.

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

LCID Opcional; 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 entre as 0:00:00 (12:00:00) e as 23:59:59 (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, será devolvido Nulo.

Val

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

Sintaxe

Val( cadeia )

cadeia Necessário; qualquer expressão de cadeia 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, expressão de cadeia de qualquer combinação, que pode representar uma data. Se data contiver Nulo, será devolvido Nulo.

firstdayofweek 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, expressão de cadeia ou qualquer combinação que possa representar uma data. Se data contiver Nulo, será devolvido Nulo.

Funções de Data/Hora

CData

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

Sintaxe

CDate( expressão )

expressão Qualquer 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".

número 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 literal que representa 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 é o intervalo de tempo que utiliza para calcular a diferença entre date1 e date2.

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

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

firstweekofyear 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( interval, date[, firstdayofweek[, firstweekofyear]] )

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

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

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

firstweekofyear 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)

data Necessário; normalmente, uma expressão de cadeia que representa uma data de 1 de janeiro de 100 a 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; qualquer Variante, expressão numérica, expressão de cadeia ou qualquer combinação que possa representar uma data. Se data contiver Nulo, será devolvido Nulo.

Hora

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

Sintaxe

Hour( hora )

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

É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 que contenha uma expressão de data ou expressão de cadeia reconhecível como uma data ou 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 possa representar uma hora. Se a hora contiver Nulo, será devolvido Nulo.

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 a data contiver Nulo, será devolvido Nulo.

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 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.

ProjDateConv

Converte um valor numa data.

Sintaxe

ProjDateConv( expressão, formatodedata )

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

formatação de data 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_yy: 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( date1, date2, calendar )

date1 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 ao calcular a duração. Se o calendário não for especificado, a predefinição para o recurso atual é o calendário de recursos ou, para a tarefa atual, o calendário da tarefa (ou o calendário padrão se não existir um calendário de tarefas para o Project Server, será utilizado o calendário padrão, independentemente do calendário especificado na cadeia de calendário . 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.

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 possa representar uma hora. Se a hora contiver Nulo, será devolvido Nulo.

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 entre as 0:00:00 (12:00:00) e as 23:59:59 (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, será devolvido Nulo.

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, expressão de cadeia de qualquer combinação, que pode representar uma data. Se data contiver Nulo, será devolvido Nulo.

firstdayofweek 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, expressão de cadeia ou qualquer combinação que possa representar uma data. Se data contiver Nulo, será devolvido Nulo.

Funções Gerais

Escolha

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 opções disponíveis.

escolha Necessário; Expressão de variante que contém uma das opções possíveis.

IIf

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

Sintaxe

IIf( expr, parteverdadeira, partefalsa )

expr Necessário; Expressão de variante que pretende avaliar.

parte true 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 que contém 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, será devolvido Nulo; se for uma variável não inicializada, será 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, será devolvido Nulo.

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, será devolvido Nulo.

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; Expressão numérica única ou 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 superior a 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ódigo de carateres Um Valor Longo 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 ou definida pelo utilizador válida.

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

firstweekofyear 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] )

iniciar Opcional; expressão numérica que define a posição inicial para cada pesquisa. 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; expressão de cadeia a ser pesquisada.

cadeia2 Necessário; expressão de cadeia 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 Comparação de opções 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, será devolvido Nulo.

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 Obrigatório. Expressão de cadeia da qual são devolvidos os carateres mais à esquerda. Se cadeia contiver Nulo, será devolvido Nulo.

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, será devolvido Nulo.

varname Qualquer nome de variável válido. Se nomevar contiver Nulo, será devolvido Nulo. 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, será devolvido Nulo.

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 a partir da qual os carateres são devolvidos. Se cadeia contiver Nulo, será devolvido Nulo.

iniciar 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 a partir da qual são devolvidos os carateres mais à direita. Se cadeia contiver Nulo, será devolvido Nulo.

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, será devolvido Nulo.

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 converter.

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

LCID Opcional; 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, será devolvido Nulo.

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, será devolvido Nulo.

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, será devolvido Nulo.

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, será devolvido Nulo.