Sintaxe e Tipos de Dados da Função de Mapeamento
Use a Função de Mapeamento para descrever o propósito da função, configure os parâmetros de entrada válidos e a sintaxe e configure o que a função retorna.
As descrições do tópico de função de mapeamento incluem as seguintes:
- Uma breve descrição do propósito da função.
- Parâmetros de entrada válidos. Os parâmetros são listados em ordem, uma vez que
a ordem é significativa para a maioria das funções. A seguinte sintaxe é usada
com os parâmetros:
datatypen – em que n indica uma ordem se vários parâmetros do mesmo tipo forem permitidos
[datatype] – em que [ ] indica que o parâmetro é opcional.
- O que a função retorna.
As funções de mapeamento podem processar os seguintes tipos de dados:
- anysimpletype
- Qualquer tipo de dados é permitido, incluindo números, cadeias, datas ou booleanos.
- boolean
- Um destes: true ou false.
- date
- Uma cadeia que representa uma data no formato AAAA-MM-DD (consulte datetime para as descrições dos componentes).
- datetime
- Uma cadeia que representa uma data e hora no formato:AAAA-MM-DDThh:mm:ss.ssssEm que:
- AAAA = ano
- MM = mês
- DD = dia
- T = caractere separador de data/hora
- hh = hora
- mm = minuto
- ss = segundo
- ssss = milissegundo opcional
- day
- Uma cadeia que representa a parte do dia de uma data no formato: DD
- dt
- Vários tipos de dados de data ou hora diferentes podem ser fornecidos. Consulte a descrição do parâmetro para uma lista dos tipos de dados que são válidos.
- duration
- Uma cadeia que representa um intervalo de tempo no formato [-]PnYnMnDTnHnMnS:
- [-] = um sinal de menos opcional
- P = indicador de período
- nY = o número de anos
- nM = o número de meses
- nD = o número de dias
- T = separador de data/hora
- nH = o número de horas
- nM = o número de minutos
- nS = o número de segundos
- empty string
- Uma cadeia sem conteúdo (por exemplo, ''). Geralmente, isto é retornado para condições de erro quando o resultado é normalmente uma cadeia.
- month
- Uma cadeia que representa a parte do mês de uma data no formato: MM
- monthday
- Uma cadeia que representa a parte do mês e dia de uma data no formato: MM-DD
- nodeset
- Um conjunto de nós no esquema. Os conjuntos de nós são identificados por um caminho específico para um nó ou estrutura no esquema. Os conjuntos de nós são usados em determinadas funções matemáticas. O tipo de dado dos nós no conjunto deve ser number.
- number
- Qualquer número inteiro ou decimal, incluindo:
- zero positivo e negativo
- infinito positivo e negativo
- NaN (Este é um valor que indica que o resultado não é um número.)
- string
- Caracteres de texto na codificação de caractere da mensagem
- time
- Uma cadeia que representa um horário do dia no formato:
hh:mm:ss.sss[-time-zone-indicator]
Consulte data/hora para as descrições dos componentes.
- tm
- Vários tipos de dados de horário diferentes podem ser fornecidos. Consulte a descrição do parâmetro para uma lista dos tipos de dados que são válidos.
- year
- Uma cadeia que representa a parte do ano de uma data no formato: AAAA
- yearmonth
- Uma cadeia que representa a parte do ano e mês de uma data no formato: AAAA-MM