As funções seguintes são utilizadas em fórmulas para calcular os valores de campos personalizados.
: Para introduzir uma fórmula num campo personalizado, 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 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 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 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 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; qualquer 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; qualquer expressão numérica ou de cadeia 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, 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
Minuto( 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, 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 represente 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 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 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, 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 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, 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 ou qualquer combinação que represente uma data. Se data contiver Nulo, será devolvido Nulo.
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 represente 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 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)
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; qualquer 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.
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, 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 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, 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 represente 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.
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_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( 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 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 represente 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 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, 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 ou qualquer combinação que represente uma data. Se data contiver Nulo, será devolvido Nulo.
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 represente uma data. Se data contiver Nulo, será devolvido Nulo.
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 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; 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; expressão de cadeia a procurar.
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 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, 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 Necessá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.
nomevar Qualquer nome 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 da qual são devolvidos carateres. Se cadeia contiver Nulo, será devolvido Nulo.
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, 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 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, 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.
