DataStage Funções usadas em pipelines Expression Builder

Use essas funções do ` DataStage ` em editores de código do ` Orchestration Pipelines `, por exemplo, para definir uma variável de usuário ou criar uma condição avançada.

Sintaxe para funções do Expression Builder

Na sintaxe para argumentos, parênteses indicam que um argumento é opcional.

Um parâmetro pode aceitar dados de qualquer tipo. É possível inserir um argumento de cadeia de tipos, int, float, null e outros tipos. Por exemplo, a função IsNull(input (any)) aceita os tipos de parâmetros a seguir, mas não é exclusivo para os tipos a seguir:

ds.IsNull(1)
ds.IsNull("try null")
ds.IsNull(1.78)
ds.IsNull(null)

O Construtor de Expressões utiliza estas categorias para funções de codificação:

Funções de conversão
Funções de data e hora
OPERATOR FUNCTIONS
Funções lógicas
Funções Matemáticas
Funções de número
Funções brutas
Funções de sequência de caracteres
Funções de Utilitário
Funções de manipulação nula
Funções de Macros

Usando scripts utilitários em expressões

Esse recurso permite invocar scripts DataStage de utilitário em qualquer lugar onde você possa inserir expressões. Esses scripts são implementados como scripts bash e executados por meio de DataStage funções.

Configuração

Caminho padrão do script: /mnts/ds-storage/utilityScripts
Para usar um caminho personalizado, especifique o script_path parâmetro na chamada da função: ds.script.foo("script_path=/custom/path", a, b, c)
Os scripts devem ser armazenados em um volume vinculado ao projeto por meio de uma conexão.
Requisito de tempo de execução: O nó RBS deve ser executado em tempo de execução compartilhado.

Exemplo

Exemplo de script utilitário (UtilityMessageToLog.sh):

#!/bin/bash

if command -v logInfo >/dev/null 2>&1; then
  logInfo $@
else
  echo $(date -u) "[INFO]" $@
fi

Funções de conversão

Converte um formato de elemento de dados único em outro.

Ascii

Converte os valores de caracteres em uma string do EBCDIC para o formato ASCII.

Sintaxe

ds.Ascii(input (string))

retorna: a sequência EDBCDI convertida em uma sequência ASCII resultante de string de formato.

Exemplo

O código a seguir retorna "65 66 67":

ds.Ascii("193 194 195")

Carac

Retorna um caractere ASCII do valor do código numérico.

Sintaxe

ds.Char(code (uint8))

retorna: o caractere correspondente de formato char.

Exemplo

O exemplo a seguir emite o código ASCII 65 como o caractere A.

ds.Char(65)

Soma de Verificação

Retorna um valor de código de redundância cíclica para uma string.

Sintaxe

ds.Checksum(input (string))

retorna: o valor de soma de verificação de uma sequência de formatação que é o código cíclico de redundância

Exemplo

O código a seguir retorna 57158:

ds.Checksum("This is any arbitrary string value")

CRC32

Utiliza a função CRC32 para retornar um código de redundância cíclica de 16-bit bits.

Sintaxe

ds.CRC32(input (string))

retorna: o resultado do formato decimal.

Exemplo

O código a seguir retorna 57158:

ds.CRC32("This is any arbitrary string value")

DateToString

Retorna a representação em sequência da data A sequência de caracteres de formato padrão para datas é "%yyyyy%mm%dd", assim, por exemplo, a data 2009-08-25 é armazenada como o número decimal 20090825. Entretanto, há a opção de especificar uma sequência de formatação que define como a data é armazenada no número decimal. As sequências de formatações devem especificar um formato que contenha apenas números Por exemplo, não é possível especificar uma sequência de caracteres de formato como "%yyyy-%mm-%dd", pois o caractere hífen (-) não pode ser armazenado em um valor decimal compactado. Os tokens a seguir são válidos para conversões em ou de valores decimais:

%yyyy (four-digit year)

%yy (two-digit year)

%NNNNyy (two-digit year with cutoff)

%mm (two-digit month)

%dd (two-digit day of month)

%ddd (three-digit day of year)

Os dígitos literais de 0 a 9 também são válidos.

Sintaxe

ds.DateToString(date (date), [format (string)])

retorna: a data em formato de sequência.

Exemplo

Se mylink.mydate contiver a data 18 de agosto de 2009, o código a seguir retornará a string "2009-08-18":

ds.DateToString(mylink.mydate)

O exemplo a seguir exibe a data que está contida na coluna mylink.mydate para uma cadeia com o formato dd:mm:yyyy Se mylink.mydate contiver a data 18 de agosto de 2009, o código a seguir retornará a string "18:08:2009":

ds.DateToString(mylink.mydate, "%dd:%mm:%yyyy")

DateToDecimal

Retorna a data fornecida como um valor decimal compactado. A sequência de caracteres de formato padrão para datas é "%yyyyy%mm%dd", assim, por exemplo, a data 2009-08-25 é armazenada como o número decimal 20090825. Entretanto, há a opção de especificar uma sequência de formatação que define como a data é armazenada no número decimal. As sequências de formatações devem especificar um formato que contenha apenas números Por exemplo, não é possível especificar uma sequência de caracteres de formato como "%yyyy-%mm-%dd", pois o caractere hífen (-) não pode ser armazenado em um valor decimal compactado. Os tokens a seguir são válidos para conversões em ou de valores decimais:

%yyyy (four-digit year)

%yy (two-digit year)

%NNNNyy (two-digit year with cutoff)

%mm (two-digit month)

%dd (two-digit day of month)

%ddd (three-digit day of year)

Os dígitos literais de 0 a 9 também são válidos.

Sintaxe

ds.DateToDecimal(basedate (date), [format (string)])

retorna: a data em formato numérico decimal.

Exemplo

Se mylink.basedate contém a data 2012-08-18, então a função a seguir armazena a data como o número decimal 18082012:

ds.DateToDecimal(mylink.basedate, "%dd%mm%yyyy")

Se mylink.basedate contém a data 2012-08-18, então a função a seguir armazena a data como o número decimal 20120818:

ds.DateToDecimal(mylink.basedate)

DecimalToDate

Retorna o decimal compactado fornecido como uma data. Tanto o sinal quanto a escala do número decimal são ignorados quando convertidos em uma data. A sequência de caracteres de formato padrão é "%yyyyy%mm%dd", assim, por exemplo, a data 2009-08-25 é armazenada como o número decimal 20090825. Entretanto, há a opção de especificar uma sequência de formatação que define como a data é armazenada no número decimal. As sequências de formatações devem especificar apenas um formato que contenha números Por exemplo, não é possível especificar uma sequência de caracteres de formato como "%yyyy-%mm-%dd", pois o caractere hífen (-) não pode ser armazenado em um valor decimal compactado. Os tokens a seguir são válidos para conversões em ou de valores decimais:

%yyyy (four-digit year)

%yy (two-digit year)

%NNNNyy (two-digit year with cutoff)

%mm (two-digit month)

%dd (two-digit day of month)

%ddd (three-digit day of year)

Os dígitos literais de 0 a 9 também são válidos.

Sintaxe

ds.DecimalToDate(basedec (decimal), [format (string)])

retorna: o número decimal em um formato de data.

Exemplo

Se mylink.mydecdata contém o valor 18082012, então a função a seguir retorna a data 2012-08-18:

ds.DecimalToDate(mylink.basedate, "%dd%mm%yyyy")

Se mylink.mydecdata contém o valor -201208,18, então a função a seguir retorna a data 2012-08-18:

ds.DecimalToDate(mylink.basedate)

DecimalToDecimal

Retorna o dado decimal em representação decimal. O argumento rtype especifica opcionalmente um tipo de arredondamento, e é configurado para um dos valores a seguir:

ceil: Arredonda o campo de origem em direção ao infinito positivo. Por exemplo, 1,4-> 2, -1,6-> -1.

floor: Arredonda o campo de origem em direção ao infinito negativo. Por exemplo, 1,6-> 1, -1,4-> -2.

round_inf: Arredonda ou trunca o campo de origem em direção ao valor representável mais próximo, desempatando por arredondamento de valores positivos em direção ao infinito positivo e valores negativos em direção ao infinito negativo. Por exemplo, 1,4 -> 1, 1,5 -> 2, -1,4 -> -1, -1,5 -> -2.

trunc_zero: Descarte qualquer algarismo fracionado à direita do dígito fracionário mais à direita suportado no destino, independentemente de sinal. Por exemplo, se o destino for um número inteiro, todos os dígitos fracionados serão truncados. Se o destino for outro decimal com uma escala menor, ele arredonda ou trunca para o tamanho da escala do decimal de destino. Por exemplo, 1,6 -> 1, -1,6 -> -1.

Sintaxe

ds.DecimalToDecimal(decimal (decimal), [rtype (string)])

retorna: o número decimal resultante.

Exemplo

Se mylink.mydec contiver o número decimal 2.5345, a seguinte função retornará o número decimal 2.54:

ds.DecimalToDecimal(mylink.mydec,"ceil")

Se mylink.mydec contiver o número decimal 2.5345, a função a seguir retornará o número decimal 2.53.

ds.DecimalToDecimal(mylink.mydec,"floor")

Se mylink.mydec contiver o número decimal 2.5345, a função a seguir retornará o número decimal 2.53.

ds.DecimalToDecimal(mylink.mydec,"trunc_zero")

Se mylink.mydec contiver o número decimal 2.5345, a função a seguir retornará o número decimal 2.53.

ds.DecimalToDecimal(mylink.mydec,"round_inf")

DecimalToDFloat

Retorna o dado decimal em dfloat representação. O argumento opcional fix_zero especifica que todos os valores decimais zero são considerados válidos (por padrão, os números decimais que contêm todos os zeros são tratados como inválidos).

Sintaxe

ds.DecimalToDFloat(decimal (decimal), ["fix_zero"])

retorna: o número decimal no formato dfloat.

Exemplos

Se mylink.mydec contiver o número decimal 00000004.00, a função a seguir retornará o número dfloat 4.

ds.DecimalToDFloat(mylink.mydec,"fix_zero")

Se mylink.mydec contiver o número decimal 00012344.00, a seguinte função retornará o número dfloat 12344.

ds.DecimalToDFloat(mylink.mydec,"fix_zero")

Se mylink.mydec contiver o número decimal 00012344.120, a função a seguir retorna o dfloat número 12344.12.

ds.DecimalToDFloat(mylink.mydec,"fix_zero")

Se mylink.mydec contiver o número decimal 00012344.120, a função a seguir retornará o número dfloat 12344.12.

ds.DecimalToDFloat(mylink.mydec)

Se mylink.mydec contiver o número decimal 00012344.000, a seguinte função retornará o número dfloat 12344.

ds.DecimalToDFloat(mylink.mydec)

DecimalToString

Retorna o decimal fornecido como uma sequência. O argumento fix_zero especifica opcionalmente que todos os valores decimais zero são considerados válidos (por padrão, os números decimais que contêm todos os zeros são tratados como inválidos). Isso abrange o caso em que os bits de sinal da representação decimal compactada são todos 0 e todos os dígitos de conteúdo.. Este cast não é considerado válido a menos que fix_zero seja verdadeiro.

Sintaxe

ds.DecimalToString(decimal (decimal), ["fix_zero"])

retorna: o número decimal em formato de sequência.

Exemplos

Se mylink.mydec contiver o número decimal 00000004.00, a seguinte função retornará a sequência "4":

ds.DecimalToString(mylink.mydec,"suppress_zero")

Se mylink.mydec contiver o número decimal 00000004.00, a função a seguir retornará a sequência "0000000000000000000000000004.0000000000":

ds.DecimalToString(mylink.mydec,"fix_zero")

Se mylink.mydec contiver o número decimal 00000004.00, a seguinte função retornará a sequência "4":

ds.DecimalToString(mylink.mydec)

DecimalToTime

Retorna o decimal compactado fornecido como um horário. Opcionalmente, é possível especificar uma sequência de formatação que especifica como o horário é armazenado no número decimal. A string de formato padrão é "%hh%nn%ss", assim, por exemplo, o tempo 14:03:22 é armazenado como o número decimal 140322. As sequências de formatações devem especificar um formato que contenha apenas números Por exemplo, não é possível especificar uma sequência de formato como "%hh:%nn:%ss", pois o caractere de dois pontos (:) não pode ser armazenado em um valor decimal compactado. Os tokens a seguir são válidos para conversões em ou de valores decimais:

%hh (two-digit hours that use 24-hour clock)

%nn (two-digit minutes)

%ss (two-digit seconds)

%ss.N (two-digit seconds, plus the number of fractional digits allowed. The number of fractional digits is from 1 - 6 inclusive).

Os dígitos literais de 0 a 9 também são válidos.

Se o formato especificado incluir microssegundos (por exemplo, %ss.4), a posição do separador decimal será inferida no valor decimal. A posição do separador decimal não precisa coincidir com a escala especificada do decimal (por exemplo, escala = 4).

Sintaxe

ds.DecimalToTime(decimal (decimal), [format (string)])

retorna: O formato decimal no tempo.

Exemplo

Se mylink.mytimedec contém o valor decimal 200658, então a função a seguir retorna o tempo 20:06:58:

ds.DecimalToTime(mylink.mytimedec)

Se a coluna mylink.mytimedec contiver o valor decimal 580620, a função a seguir retornará o horário 20:06:58:

ds.DecimalToTime(mylink.mytimedec, "%ss%nn%hh")

DecimalToTimestamp

Retorna o decimal compactado fornecido como um registro de data e hora. Opcionalmente, é possível especificar uma sequência de formatação que especifica como o registro de data e hora é armazenado no número decimal. A string de formato padrão é "%hh%nn%ss", assim, por exemplo, o timestamp 2009-08-25 14:03:22 é armazenado como o número decimal 20090825140322. As sequências de formatações devem especificar um formato que contenha apenas números Por exemplo, não é possível especificar uma sequência de formato como "%yyyy/%mm/%dd%hh: %nn:%ss", porque o caractere de barra (/) e o caractere de dois pontos (:) não podem ser armazenados em um valor decimal compactado. Os tokens a seguir são válidos para conversões em ou de valores decimais:

%yyyy (four-digit year)

%yy (two-digit year)

%NNNNyy (two-digit year with cutoff)

%mm (two-digit month)

%dd (two-digit day of month)

%ddd (three-digit day of year)

%hh (two-digit hours that use 24-hour clock)

%nn (two-digit minutes)

%ss (two-digit seconds)

%ss.N (two-digit seconds, plus the number of fractional digits allowed. The number of fractional digits is from 1 - 6 inclusive).

Os dígitos literais de 0 a 9 também são válidos.

Sintaxe

ds.DecimalToTimestamp(decimal (decimal), [format (string)])

retorna: O decimal no formato timestamp.

Exemplo

Se mylink.mytimestampdec contém o valor 19580818200658, então a função a seguir retorna o timestamp 1958-08-18 20:06:58:

ds.DecimalToTimestamp(mylink.mytimestampdec)

Se link.mytimestampdec contém o valor decimal 200658220818, então a função a seguir retorna o timestamp 2022-08-18 20:06:58:

ds.DecimalToTimestamp(mylink.mytimestampdec, "%hh%nn%ss%yy%mm%dd")

DFloatToDecimal

Retorna o dfloat fornecido em representação decimal. O argumento rtype especifica opcionalmente um tipo de arredondamento, e é configurado para um dos valores a seguir:

ceil: Arredonda o campo de origem em direção ao infinito positivo. Por exemplo, 1,4-> 2, -1,6-> -1.

floor: Arredonda o campo de origem em direção ao infinito negativo. Por exemplo, 1,6-> 1, -1,4-> -2.

Sintaxe

ds.DFloatToDecimal(number (dfloat), [rtype (string)])

retorna: o decimal em formato dfloat.

Exemplos

Se mylink.myfloat contiver o número dfloat 2.534, a função a seguir retornará o número decimal 2.54:

ds.DFloatToDecimal(mylink.mydec,"ceil")

Se mylink.myfloat contiver o número dfloat 2.534, a função a seguir retornará o número decimal 2.53:

ds.DFloatToDecimal(mylink.mydec,"floor")

Se mylink.myfloat contiver o número dfloat 2.534, a função a seguir retornará o número decimal 2.53:

ds.DFloatToDecimal(mylink.mydec,"trunc_zero")

Se mylink.myfloat contiver o número dfloat 2.534, a função a seguir retornará o número decimal 2.53:

ds.DFloatToDecimal(mylink.mydec,"round_inf")

DfloatToStringNoExp

Retorna o dfloat fornecido em sua representação de sequência sem expoente, usando a escala especificada..

Sintaxe

ds.DfloatToStringNoExp(number (dfloat), scale (string))

retorna: o número dfloat em formato de sequência.

Exemplos

Se mylink.myfloat contiver o número dfloat 2.534, a função a seguir retornará a sequência "2.5":

ds.DfloatToStringNoExp(mylink.myfloat, "2")

Dtx

Converte um inteiro decimal para hexadecimal.

Sintaxe

ds.Dtx(number (int32), size(int8))

retorna: o resultado da string de formato.

Exemplo

O código a seguir retorna "002F":

ds.Dtx(47,4)

EBCDIC

Converte cada caractere de uma expressão de seu valor de representação ASCII para seu valor de representação EBCDIC.

Sintaxe

ds.Ebcdic(input (string))

retorna: a string ASCII convertida em uma sequência EDBCDII resultante.

Exemplo

O código a seguir retorna "193 194 195 64 241 242 243":

ds.Ebcdic("ABC 123")

Iconv

Converte uma string em um formato de armazenamento interno.

Sintaxe

ds.Iconv(string (string), code (string))

retorna: o formato de armazenamento interno no formato string.

Exemplo

O código a seguir retorna 10740:

ds.Iconv("27 MAY 97", "D2")

O código a seguir retorna 10740:

ds.Iconv("1997 5 27", "D YMD")

IntToBool

Converter inteiro em tipo bool. Retorna true para qualquer valor diferente de zero, e false para 0.

Sintaxe

ds.IntToBool(integer (int))

retorna: o valor booleano true ou false.

Exemplo

O valor 2 retorna true.

ds.IntToBool(2)

IsValid

Retorna se a sequência fornecida é válida para o tipo fornecido.

Os tipos válidos são "date", "decimal", "dfloat", "sfloat", "int8", "uint8", "int16", "uint16", "int32", "uint32", "int64","uint64"," string "," time "," timestamp ".

Para os tipos de dados de data, hora e registro de data e hora, opcionalmente é possível especificar uma sequência de formatação. A sequência de formatação descreve o formato que seus dados de entrada usam quando diferem dos formatos padrão para data, hora ou registro de data e hora. O formato padrão para data é "%yyyy-%mm-%dd". O formato padrão para o horário é "%hh:%mm:%ss". O formato padrão para timestamp é "%yyyyy-%mm-%dd %hh: %mm:%ss". Esta função não registra avisos.

Sintaxe

ds.IsValid(type (string), teststring (string), [format (string)])

retorna: um resultado de tipo int8, 1 se a entrada for válida para o tipo fornecido; caso contrário, 0.

Exemplo

Se mylink.mystring contém a sequência "1", então a função a seguir retorna o valor 1:

ds.IsValid("int8", mylink.mystring)

Se mylink.mystring contém a sequência "380096,06", então a função a seguir retorna o valor 0:

ds.IsValid("int8", mylink.mystring)

IsValidDate

Retorna se o valor fornecido é válido para o tipo de data. Esta função registra avisos.

Sintaxe

ds.IsValidDate(testdate (date))

retorna: um resultado de tipo int8, 1 se a entrada for válida para o tipo fornecido; caso contrário, 0.

Se mylink.mydate contém a data 2011-09-13, então a função a seguir retorna o valor 1.

ds.IsValidDate(mylink.mydate)

Se mylink.mydate contém a sequência "380096,06", então a função a seguir retorna o valor 0, pois a sequência convertida não é uma data válida.

ds.IsValidDate(mylink.mydate)

IsValidDecimal

Retorna se o valor fornecido é válido para o tipo de decimal. Se o allzerosflag for configurado como 0, uma representação de zeros não será válida. O allzerosflag é configurado para 0 por padrão.

Sintaxe

ds.IsValidDecimal(testvalue (decimal), [allzerosflag (uint8)])

retorna: um resultado de tipo int8, 1 se a entrada for válida para o tipo fornecido; caso contrário, 0.

Exemplos

Se mylink.mynum contém o valor 310007,65, então a função a seguir retorna o valor 1.

ds.IsValidDecimal(mylink.mynum)

IsValidTime

Retorna se o horário fornecido é válido para o tipo de horário.

Sintaxe

ds.IsValidTime(testtime (time))

retorna: um resultado de tipo int8, 1 se a entrada for válida para o tipo fornecido; caso contrário, 0.

Exemplos

Se mylink.mytime contém o tempo 23:09:22, então a função a seguir retorna o valor 1:

ds.IsValidTime(mylink.mytime)

IsValidTimestamp

Retorna se o registro de data e hora é válido para o tipo de registro de data e hora.

Sintaxe

ds.IsValidTimestamp(testtimestamp (timestamp))

retorna: um resultado de tipo int8, 1 se a entrada for válida para o tipo fornecido; caso contrário, 0.

Exemplos

Se mylink.mytimestamp contém o tempo 2011-09-13 23:09:22, então a função a seguir retorna o valor 1:

ds.IsValidTimestamp(mylink.mytimestamp)

Oconv

Converte uma expressão em um formato de saída.

Sintaxe

ds.Oconv(expression (string), conversion (string))

retorna: o resultado para um formato de saída de string de formato.

Exemplo

O código a seguir retorna 1997-147:

ds.Oconv(10740, "D-YJ")

O código a seguir retorna 27 MAY 97:

ds.Oconv(10740, "D DMY, [A3,2]")

RawNumAt

Retorna o valor de número inteiro no valor de índice especificado, no campo bruto especificado. O índice começa em 0.

Sintaxe

ds.RawNumAt(rawfield (string), index (int32))

retorna: o valor de número inteiro no índice no formato int32.

Exemplos

Se o column mylink.myraw contiver um valor bruto derivado da string "hello" (que é "{ 0x68 0x65 0x6C 0x6C 0x6F }" ), então a função a seguir retorna o inteiro 104 (o código ASCII do caractere h):

ds.RawNumAt(mylink.myraw, 0)

Se mylink.myraw contiver um valor bruto derivado da string "hello" (que é "{ 0x68 0x65 0x6C 0x6C 0x6F }" ), a função a seguir retornará 0, pois o índice especificado está fora do intervalo:

ds.RawNumAt(mylink.myraw, 12)

RawToString

Retorna o valor bruto fornecido como uma representação em sequência. Deve-se assegurar-se de que o valor de entrada bruto contenha uma sequência de bytes que sejam válidos como caracteres no conjunto de caracteres de destino no qual a sequência de saída é usada.

Por exemplo, o valor bruto { 0xE0 0x41 0x42 } não é uma sequência válida de caracteres UTF-8, visto que o byte líder, 0xE0, deve ser seguido por um byte no intervalo [0x80..0xBF].

Se um valor bruto ' { xE0 x41 x42 } for passado para a função RawToString, poderá ocorrer um erro se a string de saída for acessada como se estivesse codificada em UTF-8.

Sintaxe

ds.RawToString(rawfield (string))

retorna: o valor bruto fornecido como uma sequência.

Exemplos

Se mylink.myraw contém o valor { 0x31 0x31 0x30 0x35 0x32 0x32 0x30 0x39 }, então a função a seguir retorna a sequência "11052209".

ds.RawToString(mylink.myraw)

Seq

Gera um valor de código numérico a partir de um caractere ASCII. É possível opcionalmente especificar o argumento allow8bits para converter valores ASCII de 8 bits.

Sintaxe

ds.Seq(seq (char))

retorna: o código numérico do caractere ASCII.

Exemplos

O exemplo a seguir mostra o caractere A como o código ASCII 65.

ds.Seq("A")

SeqAt

Retorna o valor do ponto de código numérico do caractere na posição especificada na sequência fornecida. O índice começa em 0. Se o índice especificado estiver fora de alcance, a função retornará 0.

Sintaxe

ds.SeqAt(basestring (string), index (int32))

retorna: valor do ponto de código numérico do caractere na posição especificada na sequência determinada no formato int32.

Exemplos

Se mylink.mystring contém a sequência "horse", então a função a seguir retorna o valor 0x6F (isto é, o valor ASCII do caractere o).

ds.SeqAt(mylink.mystring, 1)

StringToBool

Converte string para tipo bool. Retorno falso para cadeia vazia, retorno true para qualquer outro valor.

Sintaxe

ds.StringToBool(string (string))

retorna: o valor booleano true ou false.

Exemplo

Uma sequência vazia retorna falsa.

ds.StringToBool("")

StringToDate

Retorna uma data da sequência fornecida no formato especificado. Não será necessário especificar uma sequência de formatação se a sequência contiver uma data no formato padrão aaaa-mm-dd.

Sintaxe

ds.StringToDate(string (string), [format (string)])

retorna: a sequência até a data no formato especificado.

Exemplos

Se mylink.mystring contém a string "1958-08-18", então a função a seguir retorna a data 1958-08-18.

ds.StringToDate(mylink.mystring)

Se mylink.mystring contém a string "18:08:1958", então a função a seguir retorna a data 1958-08-18.

ds.StringToDate(mylink.mystring,"%dd:%mm:%yyyy")

StringToDecimal

Retorna a sequência fornecida como uma representação decimal. O argumento rtype especifica opcionalmente um tipo de arredondamento, e é configurado para um dos valores a seguir:

ceil: Arredonda o campo de origem em direção ao infinito positivo. Por exemplo, 1,4-> 2, -1,6-> -1.

floor: Arredonda o campo de origem em direção ao infinito negativo. Por exemplo, 1,6-> 1, -1,4-> -2.

Sintaxe

ds.StringToDecimal(string (string), [rtype (string)])

retorna: a sequência em formato decimal.

Exemplos

Se mylink.mystring contiver a cadeia "19982.22", a seguinte função retornará o decimal 19982.22.

ds.StringToDecimal(mylink.mystring)

Se mylink.mystring contiver a cadeia "19982.2276", a função a seguir retornará o decimal 19982.23.

ds.StringToDecimal(mylink.mystring,"ceil")

StringToRaw

Retorna uma sequência como seu valor do código bruto.

Sintaxe

ds.StringToRaw(string (string))

retorna: o valor do código bruto correspondente da sequência.

Exemplos

Se mylink.mystring contiver a string "hello", a função a seguir retorna o valor "{0x68 0x65 0x6C 0x6C 0x6F}".

ds.StringToRaw(mylink.mystring)

StringToTime

Retorna uma representação de horário da sequência fornecida.

Sintaxe

ds.StringToTime(string (string), [format (string)])

retorna: a sequência no valor de tempo.

Exemplos

Se mylink.mystring contém a sequência "20:06:58", então a função retorna um horário de 20:06:58.

ds.StringToTime(mylink.mystring)

Se mylink.mystring contém a sequência "20: 6:58", então a função retorna um horário de 20:06:58.

ds.StringToTime(mylink.mystring,"%(h,s):%(n,s):%(s,s)")

StringToTimestamp

Retorna a sequência fornecida no formato do registro de data e hora.

Sintaxe

ds.StringToTimestamp(string (string), [format (string)])

retorna: a sequência no formato do registro de data e hora.

Exemplos

Se mylink.mystring contém a string "1958-08-08 20:06:58", então a função retorna o timestamp 1958-08-08 20:06:58.

ds.StringToTimestamp(mylink.mystring)

Se mylink.mystring contém a string "8/ 8/1958 20: 6:58", então a função retorna o timestamp 1958-08-08 20:06:58.

ds.StringToTimestamp(mylink.mystring, "%(d,s)/%(m,s)/%yyyy%(h,s):%(n,s):%(s,s)")

StringToUstring

Retorna um ustring da sequência determinada, opcionalmente usando o mapa especificado (caso contrário, ele usa padrão do projeto).

Sintaxe

ds.StringToUstring(string (string), [mapname (string)])

retorna: a sequência em formato ustring.

Exemplos

Se mylink.mystring contém a sequência "11052009", então a função a seguir retorna a sequência "11052009".

ds.StringToUstring(mylink.mystring)

TimestampToDate

Retorna uma data do registro de data e hora fornecido.

Sintaxe

ds.TimestampToDate(timestamp (timestamp))

retorna: a data resultante do registro de data e hora.

Exemplos

Se mylink.mytimestamp contém o timestamp 1958-08-18 20:06:58, então a função a seguir retorna a data 1958-08-18:

ds.TimestampToDate(mylink.mytimestamp)

TimestampToDecimal

Retorna o registro de data e hora fornecido como um decimal compactado. A sequência de formato padrão é " %yyyyy%mm%dd%hh%nn%ss ". Por exemplo, o registro de data e hora 2009-08-25 14:03:22 é armazenado como o número decimal 20090825140322. Entretanto, há a opção de especificar uma sequência de formatação que define como a data é armazenada no número decimal. As sequências de formatações devem especificar um formato que contenha apenas números Por exemplo, não é possível especificar uma sequência de formato como "%yyyy/%mm/%dd%hh: %nn:%ss", porque o caractere de barra (/) e o caractere de dois pontos (:) não podem ser armazenados em um valor decimal compactado. Os tokens a seguir são válidos para conversões em ou de valores decimais:

%yyyy (four-digit year)

%yy (two-digit year)

%NNNNyy (two-digit year with cutoff)

%mm (two-digit month)

%dd (two-digit day of month)

%ddd (three-digit day of year)

%hh (two-digit hours that use 24-hour clock)

%nn (two-digit minutes)

%ss (two-digit seconds)

%ss.N (two-digit seconds, plus the number of fractional digits allowed. The number of fractional digits is from 1 - 6 inclusive).

Os dígitos literais de 0 a 9 também são válidos.

Sintaxe

ds.TimestampToDecimal(timestamp (timestamp), [format (string)])

retorna: o registro de data e hora resultante em formato decimal.

Exemplos

Se mylink.mytimestamp contém o timestamp 1958-08-18 20:06:58, então a função a seguir retorna o valor decimal 19580818200658:

ds.TimestampToDecimal(mylink.mytimestamp)

Se mylink.mytimestamp contém o timestamp 1958-08-18 20:06:58, então a função a seguir retorna o valor decimal 200658580818:

ds.TimestampToDecimal(mylink.mytimestamp, "%hh%nn%ss%yy%mm%dd")

TimestampToString

Retorna o registro de data e hora fornecido como um formato de cadeia de caracteres

Sintaxe

ds.TimestampToString(timestamp (timestamp), [format (string)])

retorna: o registro de data e hora resultante em formato de sequência.

Exemplos

Se mylink.mytimestamp contém o timestamp 1958-08-18 20:06:58, então a função retorna a string "1958-08-18 20:06:58".

ds.TimestampToString(mylink.mytimestamp)

Se mylink.mytimestamp contém o timestamp 1958-08-18 20:06:58, então a função retorna a string "1 8 / 0 8 / 1 9 5 8 20:06:58":

ds.TimestampToString(mylink.mytimestamp, "%dd/%mm/%yyyy %hh:%nn:%ss")

TimestampToTime

Retorna o registro de data e hora fornecido como o formato de hora

Sintaxe

ds.TimestampToTime(timestamp (timestamp), [format (string)])

retorna: o registro de data e hora resultante no formato de hora.

Exemplos

Se mylink.mytimestamp contém o timestamp 1958-08-18 20:06:58, então a função retorna o tempo 20:06:58:

ds.TimestampToTime(mylink.mytimestamp)

TimeToString

Retorna uma sequência a partir do horário fornecido.

Sintaxe

ds.TimeToString(timestamp (timestamp), [format (string)])

retorna: o resulto em formato de hora.

Exemplos

Se mylink.mytime contém o horário 20:06:58, então a função a seguir retorna a sequência "20:06:58":

ds.TimeToString(mylink.mytime)

Se mylink.mytime contém o horário 20:06:58, então a função a seguir retorna a sequência "58:06:20":

ds.TimeToString(mylink.mytime, "%ss:%nn:%hh")

TimeToDecimal

Retorna o horário fornecido como um decimal compactado. A sequência de formato padrão é "%hh%nn%ss", assim, por exemplo, o horário 14:03:22 é armazenado como o número decimal 140322. Entretanto, há a opção de especificar uma sequência de formatação que define como o horário é armazenado no número decimal. As sequências de formatação podem especificar apenas um formato que contenha números. Por exemplo, não é possível especificar uma sequência de formato como "%hh:%nn:%ss", pois o caractere de dois pontos (:) não pode ser armazenado em um valor decimal compactado. Os tokens a seguir são válidos para conversões em ou de valores decimais:

%hh (two-digit hours that use 24-hour clock)

%nn (two-digit minutes)

%ss (two-digit seconds)

%ss.N (two-digit seconds, plus the number of fractional digits allowed. The number of fractional digits is from 1 - 6 inclusive).

Os dígitos literais de 0 a 9 também são válidos.

Sintaxe

ds.TimeToDecimal(time (time), [format (string)])

retorna: o horário em formato decimal.

Exemplos

Se mylink.mytime contém o horário 20:06:58, então a função a seguir retorna o valor decimal 200658:

ds.TimeToDecimal(mylink.mytime)

Se mylink.mytime contém o horário 20:06:58, então a função a seguir retorna o valor decimal 580620:

ds.TimeToDecimal(mylink.mytime, "%ss%nn%hh")

UniChar

Gera um único caractere Unicode com base em um valor decimal, na faixa de 0 a 65535.

Sintaxe

ds.UniChar(expression (int32))

retorna: o resultado da string de formato.

Exemplo

O código a seguir retorna "õ":

ds.UniChar(0x00F5)

UniSeq

Gera um valor decimal com base em um único caractere Unicode.

Sintaxe

ds.UniSeq(expression (string))

retorna: o decimal correspondente ao caractere Unicode do formato int32.

Exemplo

O código a seguir retorna 195:

ds.UniSeq("ä")

UstringToString

Retorna uma sequência do ustring fornecido usando como opção o mapa especificado (caso contrário, usa o mapa padrão do projeto).

Sintaxe

ds.UstringToString(string (ustring), [mapname(string)])

retorna: o resultado em formato de sequência.

Exemplos

Se mylink.myustring contém a sequência "11052009", então a função a seguir retorna a sequência "11052009":

ds.UstringToString(mylink.myustring)

Xtd

Converte uma string hexadecimal para decimal.

Sintaxe

ds.Xtd(hexadecimal (string))

retorna: o valor decimal correspondente para a sequência hexidecimal.

Exemplo

O código a seguir retorna 48879:

ds.Xtd("beef")

Int

Retorna a porção inteira de uma expressão. Quaisquer operações aritméticas especificadas são calculadas usando a precisão total do sistema. A parte fracionária do valor é truncada, não arredondada e o número inteiro restante é retornado.

Sintaxe

ds.Int(expression (dfloat))

retorna: o valor decimal que é arredondado e convertido para o tipo int64.

Exemplo

O código a seguir retorna 454:

ds.Int(454.95)

O código a seguir retorna 2:

ds.Int(2.35)

Funções de data e hora

Use essas funções para funções de dados e tempo em uma expressão.

As funções que especificam datas, horas ou registros de data e hora nos argumentos usam sequências com formatos específicos:

Para uma data, o formato é %yyyy-%mm-%dd
Por um tempo, o formato é %hh:%nn:%ss. Se estendido para incluir microssegundos, o formato é %hh:%nn:%ss.x em que x determina o número de casas decimais determinado aos segundos.
Para um registro de data e hora, o formato é o formato de data seguido pelo formato de hora.

As funções que têm os dias da semana no argumento assumem uma sequência que especifica o dia da semana O dia é especificado como uma abreviação de três letras ou como o nome completo. Por exemplo, ambas as sequências "thu" e "thursday" são válidas.

CurrentDate

Retorna a data em que a tarefa é executada.

Sintaxe

ds.CurrentDate()

retorna: a data atual no formato de data.

Exemplos

Use esta função para obter a data atual.

ds.CurrentDate()

CurrentTime

Retorna a hora em que a tarefa é executada.

Sintaxe

ds.CurrentTime()

retorna: o momento atual em formato de tempo.

Exemplos

Use esta função para obter o horário atual.

ds.CurrentTime()

CurrentTimeMS

Retorna a hora, incluindo microssegundos, em que a tarefa é executada.

Sintaxe

ds.CurrentTimeMS()

retorna: o horário atual em formato de hora, incluindo microssegundos.

Exemplos

Utilize esta função para recuperar o horário atual e gerar os dados..

ds.CurrentTimeMS()

CurrentTimestamp

Retorna um registro de data e hora que fornece a data e a hora em que a tarefa é executada.

Sintaxe

ds.CurrentTimestamp()

retorna: o timestamp atual em formato timestamp.

Exemplos

Use esta função para recuperar o atual registro de data e hora para os dados de saída.

ds.CurrentTimestamp()

CurrentTimestampMS

Retorna um registro de data e hora, incluindo microssegundos, que fornece a data e a hora em que a tarefa é executada.

Sintaxe

ds.CurrentTimestampMS()

retorna: o timestamp atual em formato timestamp.

Exemplos

Use esta função para recuperar o atual registro de data e hora para os dados de saída.

ds.CurrentTimestampMS()

Data

Retorna um valor numérico único de dias decorridos entre a data interna do sistema e 31 de dezembro de 1967, que é o Dia 0. Todas as datas após são números positivos que representam o número de dias decorrido desde o Dia 0. Todas as datas anteriores são números negativos que representam o número de dias antes do Dia 0

Sintaxe

ds.Date()

retorna: a data resultante do formato int.

Exemplos

Se a data atual for 15 de novembro de 1967, o código a seguir retorna -46. Se a data atual for 15 de fevereiro de 1968, o código a seguir retorna 46:

ds.Date()

DateFromDaysSince

Retorna uma data adicionando um número inteiro a uma data de referência. O número inteiro pode ser negativo para retornar uma data anterior à data de referência.

Sintaxe

ds.DateFromDaysSince(number (int32), [baseline_date_object (string)])

retorna: uma data adicionando um número inteiro a uma data de linha de base que o usuário digita.

Exemplos

Se mylink.myintcol contém o número inteiro 18250, e mylink.mydatecol contém a data 1958-08-18, então as três funções seguintes são equivalentes, e retornam a data 2008-08-05:

ds.DateFromDaysSince(18250,"1958-08-18")
ds.DateFromDaysSince(mylink.myintcol,"1958-08-18")
ds.DateFromDaysSince(mylink.myintcol,mylink.mydatecol)

Se ' mylink.mynegintcol contiver o número inteiro -1 e ' mylink.mydatecol contiver a data 1958-08-18, as três funções a seguir serão equivalentes e retornarão a data 1958-08-17:

ds.DateFromDaysSince(-1,"1958-08-18")
ds.DateFromDaysSince(mylink.mynegintcol,"1958-08-18")
ds.DateFromDaysSince(mylink.mynegintcol,mylink.mydatecol)

DateFromDaysSince2

Retorna uma data adicionando um número inteiro a uma data de referência. O número inteiro pode ser negativo para retornar uma data anterior à data de referência.

Sintaxe

ds.DateFromDaysSince2(number (int32), [baseline_date_object (date)])

retorna: uma data adicionando um número inteiro a uma data de linha de base que o usuário digita.

Exemplos

Se mylink.myint contém o número inteiro 18250, e mylink.mydate contém a data 1958-08-18, então as três funções seguintes são equivalentes, e retornam a data 2008-08-05:

ds.DateFromDaysSince2(18250,"1958-08-18")
ds.DateFromDaysSince2(mylink.myint,"1958-08-18")
ds.DateFromDaysSince2(mylink.myint, mylink.mydate)

Se ' mylink.mynegint contiver o número inteiro -1 e ' mylink.mydate contiver a data 1958-08-18, as três funções a seguir serão equivalentes e retornarão a data 1958-08-17:

ds.DateFromDaysSince2(-1,"1958-08-18")
ds.DateFromDaysSince2(mylink.mynegint,"1958-08-18")
ds.DateFromDaysSince2(mylink.mynegint, mylink.mydate)

DateFromComponents

Retorna uma data de determinados anos, meses e dia do mês, que é fornecida como três valores separados.

Sintaxe

ds.DateFromComponents(years (int32), months (int32), dayofmonth (int32))

retorna: uma única data com os valores especificados.

Exemplos

Se mylink.year contém o valor 2010, mylink.month contém o valor 12, e mylink.dayofmonth contém o valor 2, então as duas funções seguintes são equivalentes, e retornam a data 2010-12-02.

ds.DateFromComponents(2010, 12, 2)
ds.DateFromComponents(mylink.year, mylink.month, mylink.dayofmonth)

DateFromJulianDay

Retorna uma data a partir do número do determinado dia Juliano.

Sintaxe

ds.DateFromJulianDay(julianday (uint32))

retorna: a data do valor do Dia Juliano fornecido.

Exemplos

Se mylink.myjul contém o valor 2454614, então as duas funções seguintes são equivalentes, e retornam a data 2008-05-27.

ds.DateFromJulianDay(2454614)
ds.DateFromJulianDay(mylink.myjul)

DateOffsetByComponents

Retorna a data especificada, com deslocamentos aplicados a partir do deslocamento do ano, do deslocamento do mês e do deslocamento do dia do mês especificados, fornecidos como três valores separados. Os valores de deslocamento podem ser positivos, zero ou negativos.

Sintaxe

ds.DateOffsetByComponents(basedate (date), year_offset (int32), month_offset (int32), dayofmonth_offset (int32))

retorna: A data determinada deslocamento da data do formato.

Exemplos

Se mylink.basedate contém 2011-08-18 e mylink.yearos contém o valor 2, mylink.monthos contém o valor 0, e mylink.dayofmonthosol contém o valor 0, então as duas funções seguintes são equivalentes, e retornam a data 2013-08-18.

ds.DateOffsetByComponents("2011-08-18", 2, 0, 0)
ds.DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos)

Se ' mylink.basedate contiver 2011-08-18 e ' mylink.yearos contiver o valor -2, ' mylink.monthos contiver o valor 0 e ' mylink.dayofmonthosol contiver o valor 0, as duas funções a seguir serão equivalentes e retornarão a data 2009-08-18.

ds.DateOffsetByComponents("2011-08-18", -2, 0, 0)
ds.DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos)

Dia

Retorna o dia do mês a partir da data do sistema

Sintaxe

ds.Day()

retorna: dia do mês em formato int.

Exemplos

Se a data atual for 1967-12-31, o código a seguir retorna 31.

ds.Day()

DaysSinceFromDate

Leva uma determinada data do tipo data e uma data de origem do tipo string, e retorna o número de dias da data de origem até a data determinada.

Sintaxe

ds.DaysSinceFromDate(given_date (date), source_date_string (string))

retorna: a diferença em dias entre as duas datas dadas do tipo int32.

Exemplos

Se mylink.mysourcedate contém a data 1958-08-18 e mylink.mygivendate contém a data 2008-08-18, então as duas funções a seguir são equivalentes, e retornam o valor inteiro 18263.

ds.DaysSinceFromDate(mylink.mygivendate, mylink.mysourcedate)
ds.DaysSinceFromDate("2008-08-18","1958-08-18")

DaysSinceFromDate2

Leva uma determinada data do tipo data e uma data de origem do tipo data, e retorna o número de dias da data de origem até a data determinada.

Sintaxe

ds.DaysSinceFromDate2(given_date (date), source_date_object (date))

retorna: a diferença em dias entre as duas datas fornecidas no formato int32.

Exemplos

Se mylink.mysourcedate contém a data 1958-08-18 e mylink.mygivendate contém a data 2008-08-18, então as duas funções a seguir são equivalentes, e retornam o valor inteiro 18263.

ds.DaysSinceFromDate2(mylink.mygivendate, mylink.mysourcedate)
ds.DaysSinceFromDate2("2008-08-18","1958-08-18")

DaysInMonth

Retorna o número de dias no mês na data base fornecida.

Sintaxe

ds.DaysInMonth(basedate (date))

retorna: o número de dias no mês no formato int32.

Exemplos

Se mylink.mysourcedate contém a data 1958-08-18, então as duas funções a seguir são equivalentes, e retornam o valor inteiro 31.

ds.DaysInMonth(mylink.mysourcedate)
ds.DaysInMonth("1958-08-18")

DaysInYear

Retorna o número de dias no ano, na data base.

Sintaxe

ds.DaysInYear(basedate (date))

retorna: o número de dias no ano no formato int32.

Exemplos

Se mylink.mysourcedate contiver a data 18-8-2012, as duas funções a seguir serão equivalentes e retornarão o valor de número inteiro 366.

ds.DaysInYear(mylink.mysourcedate)
ds.DaysInYear("2012-08-18")

Se mylink.mysourcedate contiver a data 2011-08-18, as duas funções a seguir serão equivalentes e retornarão o valor de número inteiro 365.

ds.DaysInYear(mylink.mysourcedate)
ds.DaysInYear("2011-08-18")

DateOffsetByDays

Retorna o deslocamento de data especificado pelo número de dias especificado. O valor de deslocamento pode ser positivo, zero ou negativo.

Sintaxe

ds.DateOffsetByDays(basedate (date), dayoffset (int32))

retorna: o objeto de data com a compensação correspondente.

Exemplos

Se mylink.basedate contém 2011-08-18 e mylink.dayoffset contém o valor 2, então as duas funções seguintes são equivalentes, e retornam a data 2011-08-20.

ds.DateOffsetByDays("2011-08-18", 2)
ds.DateOffsetByDays(mylink.basedate, mylink.dayoffset)

Se mylink.basedate contiver 2011-08-18 e mylink.dayoffset contiver o valor -31, as duas funções a seguir serão equivalentes e retornarão a data 2011-07-18.

ds.DateOffsetByDays("2011-08-18", -31)
ds.DateOffsetByDays(mylink.basedate, mylink.dayoffset)

HoursFromTime

Retorna a parte de horas de um horário.

Sintaxe

ds.HoursFromTime(time (time))

retorna: o valor das horas no formato int8.

Exemplos

Se mylink.mytime contém o horário 22:30:00, então as duas funções a seguir são equivalentes, e retornam o valor de número inteiro 22.

ds.HoursFromTime(mylink.mytime)
ds.HoursFromTime("22:30:00")

JulianDayFromDate

Retorna um número de dia Juliano a partir da data fornecida.

Sintaxe

ds.JulianDayFromDate(time (time))

retorna: o número do Dia Juliano no formato int32 da data especificada.

Exemplos

Se mylink.mydate contém a data 2008-05-27, então as duas funções a seguir são equivalentes, e retornam o valor 2454614.

ds.JulianDayFromDate("2008-05-27")
ds.JulianDayFromDate(mylink.mydate)

MicroSecondsFromTime

Retorna a parte de microssegundo de um horário.

Sintaxe

ds.MicroSecondsFromTime(time (time))

retorna: o valor dos microssegundos do horário no formato int32.

Exemplos

Se mylink.mytime contém o horário 22 :30:00.32, então a função a seguir retorna o valor 320000:

ds.MicroSecondsFromTime(mylink.mytime)

MidnightSecondsFromTime

Retorna o número de segundos desde a meia-noite até o horário fornecido.

Sintaxe

ds.MidnightSecondsFromTime(time (time))

retorna: o segundo valor de meia-noite até o horário, no formato int8 .

Exemplos

Se mylink.mytime contém o horário 00:30:52, então as duas funções a seguir são equivalentes, e retornam o valor 1852:

ds.MidnightSecondsFromTime("00:30:52")
ds.MidnightSecondsFromTime(mylink.mytime)

MinutesFromTime

Retorna a parte de minutos de um horário.

Sintaxe

ds.MinutesFromTime(time (time))

retorna: o valor de minutos do tempo, em formato int8 .

Exemplos

Se mylink.mytime contém o horário 22:30:52, então as duas funções a seguir são equivalentes, e retornam o valor 30:

ds.MinutesFromTime("22:30:52")
ds.MinutesFromTime(mylink.mytime)

MonthDayFromDate

Retorna o dia do mês a partir da data fornecida.

Sintaxe

ds.MonthDayFromDate(date (date))

retorna: o dia do mês a partir da data determinada em formato int8 .

Exemplos

Se mylink.mydate contém a data 2008-08-18, então as duas funções a seguir são equivalentes, e retornam o valor 18:

ds.MonthDayFromDate("2008-08-18")
ds.MonthDayFromDate(mylink.mydate)

MonthFromDate

Retorna o número do mês da data fornecida.

Sintaxe

ds.MonthFromDate(date (date))

retorna: o número do mês de formato int8.

Exemplos

Se mylink.mydate contém a data 2008-08-18, então as duas funções a seguir ambas retornam o valor 8:

ds.MonthFromDate("2008-08-18")
ds.MonthFromDate(mylink.mydate)

WeekdayFromDate

Retorna o número do dia da semana desde a data determinada. É possível especificar o dia que é considerado como o primeiro na semana e, se não especificado, será domingo por padrão.

Sintaxe

ds.WeekdayFromDate(date (date), [origin_day (string)])

retorna: o dia da semana desde a data determinada em formato int8 .

Exemplos

Se mylink.mydate contém a data 2008-08-18, então as duas funções a seguir são equivalentes, e retornam o valor 1:

ds.WeekdayFromDate("2008-08-18")
ds.WeekdayFromDate(mylink.mydate)

Se mylink.mydate contém a data 2008-08-18, e mylink.origin_day contém "saturday", então as seguintes funções são equivalentes, e retornam o valor 2:

ds.WeekdayFromDate("2008-08-18", "saturday")
ds.WeekdayFromDate("2008-08-18", "sat")
ds.WeekdayFromDate(mylink.mydate, mylink.origin_day)

NextWeekdayFromDate

Retorna a data do dia da semana especificado mais próximo após a data de origem. O dia da semana é especificado como o nome completo, por exemplo, quinta-feira, ou uma abreviação de três letras, por exemplo, "qui".

Sintaxe

ds.NextWeekdayFromDate(sourcedate (date), day_of_week (string))

retorna: o dia do mês da data fornecida.

Exemplos

Se mylink.mysourcedate contém a data 2008-08-18 e o dia da semana que é especificado é quinta-feira, então as duas funções a seguir são equivalentes, e retornam o valor 2008-08-21:

ds.NextWeekdayFromDate("2008-08-18", "thursday")
ds.NextWeekdayFromDate(mylink.mysourcedate, "thu")

NthWeekdayFromDate

Retorna a data do dia especificado do deslocamento de semana pelo número especificado de semanas a partir da data de origem. O dia da semana é especificado como o nome completo, por exemplo, quinta-feira, ou uma abreviação de três letras, por exemplo, Qui. Os valores de deslocamento podem ser positivos, negativos ou zero.

Sintaxe

ds.NthWeekdayFromDate(basedate (date), day_of_week (string), week_offset (int32))

retorna: a data da compensação de semana especificada por semanas a partir da data especificada.

Exemplos

Se mylink.mydate contém a data 2009-08-18 e quinta-feira é especificado com um deslocamento de 1, então as duas funções a seguir são equivalentes, e retornam o valor 2009-08-20. A primeira ocorrência de Thursday é retornada. No exemplo a seguir, a quinta-feira ocorre na mesma semana que a data 2009-08-18. A data 2009-08-18 é uma terça-feira.

ds.NthWeekdayFromDate("2009-08-18", "thursday", 1)
ds.NthWeekdayFromDate(mylink.mydate, "thu", 1)

Se ' mylink.mydate contiver a data 2009-08-18 e Thursday for especificado com um deslocamento de -2, as duas funções a seguir serão equivalentes e retornarão o valor 2009-08-06. A ocorrência da quinta-feira, ou seja, duas quintas-feiras, é retornada.

ds.NthWeekdayFromDate("2009-08-18", "thursday", -2)
ds.NthWeekdayFromDate(mylink.mydate, "thu", -2)

PreviousWeekdayFromDate

Retorna a data do dia da semana especificado que é o dia mais recente antes da data de origem. O dia da semana é especificado como o nome completo, por exemplo, quinta-feira, ou uma abreviação de três letras, por exemplo, "qui".

Sintaxe

ds.PreviousWeekdayFromDate(sourcedate (date), day_of_week (string))

retorna: a data do dia da semana mais recente a partir da data especificada.

Exemplos

Se mylink.mysourcedate contém a data 2008-08-18 e quinta-feira é especificado, então as duas funções a seguir são equivalentes, e retornam o valor 2008-08-14:

ds.PreviousWeekdayFromDate("2008-08-18", "thursday")
ds.PreviousWeekdayFromDate(mylink.mysourcedate, "thu")

SecondsFromTime

Retorna a segunda parte de um tempo.

Sintaxe

ds.SecondsFromTime(time (time))

Retorna: o segundo valor do tempo no formato dfloat.

Exemplos

Se mylink.mytime contém o horário 22:30:52, então as duas funções a seguir são equivalentes, e retornam o valor 52:

ds.SecondsFromTime("22:30:52")
ds.SecondsFromTime(mylink.mytime)

SecondsSinceFromTimestamp

Retorna o número de segundos entre dois objetos do registro de data e hora.

Sintaxe

ds.SecondsSinceFromTimestamp(timestamp (timestamp), timestamp_base_string (string))

Retorna: o segundo valor no formato dfloat.

Exemplos

Se mylink.mytimestamp contiver o registro de data e hora 2008-08-18 22:30:52 e mylink.mytimestamp_base contiver o registro de data e hora 2008-08-19 22:30:52, as duas funções a seguir serão equivalentes e retornarão o valor -86400:

ds.SecondsSinceFromTimestamp("2008-08-18 22:30:52","2008-08-19 22:30:52")
ds.SecondsSinceFromTimestamp(mylink.mytimestamp, mylink.mytimestamp_base)

SecondsSinceFromTimestamp2

Retorna o número de segundos entre dois objetos do registro de data e hora.

Sintaxe

ds.SecondsSinceFromTimestamp2(timestamp (timestamp), timestamp_base_object (timestamp))

Retorna: o segundo valor no formato dfloat.

Exemplos

ds.SecondsSinceFromTimestamp2("2008-08-18 22:30:52","2008-08-19 22:30:52")
ds.SecondsSinceFromTimestamp2(mylink.mytimestamp, mylink.mytimestamp_base)

Hora

Retorna um valor de sequência que expressa o horário interno do dia O tempo interno é o número de segundos que passaram desde a meia-noite para o milésimo de segundo mais próximo (horário local).

Sintaxe

ds.Time()

retorna: o tempo resultante da string de formato.

Exemplos

Se o horário atual for 11:17:43:19, o código a seguir retornará 40663.842:

ds.Time()

TimeDate

Retorna a hora e data do sistema como uma sequência formatada.

Sintaxe

ds.TimeDate()

retorna: a data e hora do sistema no formato de sequência.

TimeFromComponents

Retorna um tempo de tipo de data a partir das horas, minutos, segundos e microssegundos fornecidos como int32.

Sintaxe

ds.TimeFromComponents(hours (int32), minutes (int32), seconds (int32), microseconds (int32))

retorna: o tempo em tipo de data.

Exemplos

Se mylink.hourcol contiver o valor 10, mylink.mincol contiver o valor 12, mylink.seccol contiver o valor 2 e mylink.mseccol contiver 0, as duas funções a seguir serão equivalentes e retornarão o tempo 10:12:02:

ds.TimeFromComponents(10, 12, 2, 0)
ds.TimeFromComponents(mylink.hourcol, mylink.mincol, mylink.seccol, mylink.mseccol)

TimeFromMidnightSeconds

Retorna o tempo do sistema no formato de tempo.

Sintaxe

ds.TimeFromMidnightSeconds(seconds (time))

retorna: os segundos desde a meia-noite em formato de tempo.

Exemplos

Se mylink.mymidnightseconds contém o valor 240, então as duas funções a seguir são equivalentes, e retornam o valor 00:04:00:

ds.TimeFromMidnightSeconds(240)
ds.TimeFromMidnightSeconds(mylink.mymidnightseconds)

TimeOffsetByComponents

Retorna o horário, com deslocamentos aplicados a partir do tempo base com deslocamento de hora, deslocamento de minuto e deslocamento de segundo, cada um deles fornecido como valores separados. O deslocamento de segundos pode incluir segundos parciais.

Sintaxe

ds.TimeOffsetByComponents(basetime (time), hour_offset (int32), minute_offset (int32), second_offset (dfloat))

retorna: a compensação de horário pelos valores especificados.

Exemplos

Se mylink.basetime contém 14:05:29 e mylink.houros contém o valor 2, mylink.minos contém o valor 0, mylink.secos contém o valor 20, então as duas funções a seguir são equivalentes, e retornam o tempo 16:05:49.

ds.TimeOffsetByComponents("14:05:29", 2, 0, 20)
ds.TimeOffsetByComponents(mylink.basetime, mylink.houros, mylink.minos, mylink.secos)

TimeOffsetBySeconds

Retorna o horário especificado, com deslocamentos aplicados a partir do tempo base com deslocamento de segundos. O deslocamento de segundos pode incluir segundos parciais.

Sintaxe

ds.TimeOffsetBySeconds(basetime (time), second_offset (dfloat))

retorna: o tempo com segundos deslocados pelo valor especificado.

Exemplos

Se mylink.basetime contiver 14:05:29.30 e mylink.secos contiver o valor 2.5, as duas funções a seguir serão equivalentes e retornarão o horário 14:05:31.

ds.TimeOffsetBySeconds("14:05:29.30", 2.5)
ds.TimeOffsetBySeconds(mylink.basetime, mylink.secos)

TimestampFromDateTime

Retorna um registro de data e hora a partir da data e hora fornecidas.

Sintaxe

ds.TimestampFromDateTime(date (date), time (time))

retorna: o registro de data e hora da data e hora fornecidas.

Exemplos

Se mylink.mydate contiver a data 2008-08-18 e mylink.mytime contiver o horário 22:30:52, as duas funções a seguir serão equivalentes e retornarão o registro de data e hora 2008-08-18 22:30:52:

ds.TimestampFromDateTime("2008-08-18","22:30:52")
ds.TimestampFromDateTime(mylink.mydate, mylink.mytime)

TimestampFromSecondsSince

Retorna um registro de data e hora derivado do número de segundos do objeto de registro de data e hora de base.

Sintaxe

ds.TimestampFromSecondsSince(seconds (dfloat), [base_timestamp_object (string)])

retorna: o registro de data e hora derivado do valor fornecido de segundos.

Exemplos

Se mylink.myseconds contiver o valor 2563 e mylink.timestamp_base contiver o registro de data e hora 2008-08-18 22:30:52, as duas funções a seguir serão equivalentes e retornarão o registro de data e hora 2008-08-18 23:13:35:

ds.TimestampFromSecondsSince(2563,"2008-08-18 22:30:52")
ds.TimestampFromSecondsSince(mylink.myseconds,mylink.timestamp_base)

TimestampFromSecondsSince2

Retorna um registro de data e hora derivado do número de segundos do objeto de registro de data e hora de base.

Sintaxe

ds.TimestampFromSecondsSince2(seconds (dfloat), [base_timestamp_object (timestamp)])

retorna: o registro de data e hora derivado do valor fornecido de segundos.

Exemplos

ds.TimestampFromSecondsSince2(2563,"2008-08-18 22:30:52")
ds.TimestampFromSecondsSince2(mylink.myseconds, mylink.timestamp_base)

TimestampFromTimet

Retorna um registro de data e hora do valor de sequência time_t do UNIX fornecido.

Sintaxe

ds.TimestampFromTimet(timet_string (int32))

retorna: o registro de data e hora derivado do valor fornecido de segundos.

Exemplos

Se mylink.mytimet contiver o valor 1234567890, as duas funções a seguir serão equivalentes e retornarão o registro de data e hora 2009-02-13 23:31:30:

ds.TimestampFromTimet(1234567890)
ds.TimestampFromTimet(mylink.mytimet)

TimestampFromTime2

Retorna um registro de data e hora dos objetos de hora e de registro de data e hora fornecidos. O valor no objeto de hora sobrescreve o valor de hora no objeto de registro de data e hora de modo que apenas a parte da data seja utilizada do registro de data e hora.

Sintaxe

ds.TimestampFromTime2(time (time), timestamp (timestamp))

retorna: o registro de data e hora dos objetos de horário e registro de data e hora fornecidos.

Exemplos

Se mylink.mytime contiver o horário 12:03:22 e mylink.mytimestamp contiver o registro de data e hora 2008-08-18 22:30:52, as duas funções a seguir serão equivalentes e retornarão o registro de data e hora 2008-08-18 12:03:22:

ds.TimestampFromTime2("12:03:22", "2008-08-18 22:30:52")
ds.TimestampFromTime2(mylink.mytime, mylink.mytimestamp)

TimestampOffsetByComponents

Retorna o registro de data e hora, com deslocamentos aplicados a partir do registro de data e hora de base com deslocamento de ano, deslocamento de mês, deslocamento de dia, deslocamento de hora, deslocamento de minuto e deslocamento de segundo, cada um fornecido como valores separados. O deslocamento de segundos pode incluir microssegundos.

Sintaxe

ds.TimestampOffsetByComponents(basetimestamp (timestamp), year_offset (int32), month_offset (int32), dayofmonth_offset (int32), hour_offset (int32), minute_offset (int32), second_offset (dfloat))

retorna: a compensação de registro de data e hora por valores especificados.

Exemplos

Se ' mylink.basetimestamp contiver 2009-08-18 14:05:29 e ' mylink.yearos contiver 0, ' mylink.monthos contiver o valor 2, ' mylink.dayos contiver o valor ' -4, ' mylink.houros contiver o valor 2, ' mylink.minos contiver o valor 0, ' mylink.secos contiver o valor 20, então as duas funções a seguir são equivalentes e retornam o registro de data e hora 2009-10-14 16:05:49.

ds.TimestampOffsetByComponents("2009-08-18 14:05:29", 0, 2, -4, 2, 0, 20)
ds.TimestampOffsetByComponents(mylink.basetimestamp, mylink.houros,
mylink.minos, mylink.secos)

TimestampOffsetBySeconds

Retorna o registro de data e hora, com deslocamentos aplicados a partir do registro de data e hora de base com deslocamento de segundos. O deslocamento de segundos pode incluir microssegundos.

Sintaxe

ds.TimestampOffsetBySeconds(basetimestamp (timestamp), second_offset (dfloat))

retorna: o deslocamento timestamp por valores especificados em formato timestamp.

Exemplos

Se mylink.basetimestamp contiver 2009-08-18 14:05:29 e mylink.secos contiver o valor 32760, as duas funções a seguir serão equivalentes e retornarão o registro de data e hora 2009-08-18 23:11:29:

ds.TimestampOffsetBySeconds("2009-08-18 14:05:29", 32760)
ds.TimestampOffsetBySeconds(mylink.basetimestamp, mylink.secos)

TimetFromTimestamp

Retorna um valor time_t UNIX a partir do registro de data e hora fornecido.

Sintaxe

ds.TimetFromTimestamp(timestamp (timestamp))

retorna: o time_t UNIX por dado timestamp em formato int32 .

Exemplos

Se mylink.mytimestamp contém o valor 2009-02-13 23:31:30, então as duas funções a seguir são equivalentes, e retornam o valor 1234567890:

ds.TimetFromTimestamp("2009-02-13 23:31:30")
ds.TimetFromTimestamp(mylink.mytimestamp)

YeardayFromDate

Retorna o número do dia no ano da data fornecida.

Sintaxe

ds.YeardayFromDate(date (date))

retorna: o número do dia no formato int16.

Exemplos

Se mylink.mydate contém a data 2008-08-18, então as duas funções a seguir são equivalentes, e retornam o valor 231:

ds.YeardayFromDate("2008-08-18")
ds.YeardayFromDate(mylink.mydate)

YearFromDate

Retorna o ano da data fornecida.

Sintaxe

ds.YearFromDate(date (date))

retorna: o número do ano no formato int16.

Exemplos

Se mylink.mydate contém a data 2008-08-18, então as duas funções a seguir são equivalentes, e retornam o valor 2008:

ds.YearFromDate("2008-08-18")
ds.YearFromDate(mylink.mydate)

YearweekFromDate

Retorna o número da semana no ano da data fornecida.

Sintaxe

ds.YearweekFromDate(date (date))

retorna: o número da semana no formato int16.

Exemplos

Se mylink.mydate contém a data 2008-08-18, então as duas funções a seguir são equivalentes, e retornam o valor 33:

ds.YearweekFromDate("2008-08-18")
ds.YearweekFromDate(mylink.mydate)

Mês

Retorna o mês atual.

Sintaxe

ds.Month()

retorna: o mês atual.

Exemplos

O código a seguir retorna o mês atual em formato int.

ds.Month()

Ano

Retorna o ano atual.

Sintaxe

ds.Year()

retorna: o ano atual em formato int.

Exemplos

O código a seguir retorna o ano atual.

ds.Year()

OPERATOR FUNCTIONS

As funções do operador comparam dois objetos e retornam um valor booleano (true ou false):

Igual a

Compara se dois objetos são iguais.

Sintaxe

ds.EQ(object1 (any), object2 (any))

retorna: true se o valor do objeto for igual, false caso contrário.

Exemplos

As expressões a seguir retornam true:

ds.EQ(null,null)
ds.EQ(true,true)
ds.EQ("1",1)
ds.EQ("1",1.0)

As expressões a seguir retornam false:

ds.EQ(1,null)
ds.EQ(false,true)
ds.EQ("a","b")

Não igual a

Compara se dois objetos não são iguais.

Sintaxe

ds.NE(object1 (any), object2 (any))

retorna: true se o valor do objeto não for igual, caso contrário, false.

Exemplos

As expressões a seguir retornam true:

ds.NE(1,null) 
ds.NE(true,false) 
ds.NE(false,true) 
ds.NE("a","b")

As expressões a seguir retornam false:

ds.NE(null,null) 
ds.NE(true,true) 
ds.NE(false,false) 
ds.NE("a","a")

Menor que

Usa dois objetos como parâmetros e retorna true se o primeiro objeto for menor do que o segundo

Sintaxe

ds.LT(object1 (any), object2 (any))

retorna: true se o primeiro objeto for menor que o segundo, caso contrário, false.

Exemplos

As expressões a seguir retornam true:

ds.LT("a","b")

As expressões a seguir retornam false:

ds.LT("a","a")
ds.LT("a","b")
ds.LT("202310071855","20380727")

Maior que

Usa dois objetos como parâmetros e retorna true se o primeiro objeto for maior do que o segundo

Sintaxe

ds.GT(object1 (any), object2 (any))

retorna: true se o primeiro objeto for maior do que o segundo, caso contrário, false.

Exemplos

As expressões a seguir retornam true:

ds.GT("b","a")

As expressões a seguir retornam false:

ds.GT("a","a")
ds.GT("5.12","5.123")

Maior que ou igual a

Usa dois objetos como parâmetros e retorna true se o primeiro objeto for maior ou igual ao segundo.

Sintaxe

ds.GE(object1 (any), object2 (any))

retorna: true se o primeiro objeto for maior ou igual ao segundo, false caso contrário.

Exemplos

As expressões a seguir retornam true:

ds.GE(2, 1)
ds.GE("a","a")

Menor que ou igual a

Usa dois objetos como parâmetros e retorna true se o primeiro objeto for menor ou igual ao segundo.

Sintaxe

ds.LE(object1 (any), object2 (any))

Retorna: true se o primeiro objeto for menor ou igual ao segundo, caso contrário, false.

Exemplos

As expressões a seguir retornam true:

ds.GE(1, 2)
ds.LE("a","a") == true

Funções lógicas

As funções lógicas executam operações de bit.

BitAnd

Retorna AND bit a bit dos dois argumentos de número inteiro.

Sintaxe

ds.BitAnd(number1 (uint64), number2 (uint64))

retorna: o AND bit a bit no formato uint64.

Exemplos

Se mylink.mynumber1 contém o número 352 e mylink.mynumber2 contém o número 400, então as duas funções a seguir são equivalentes, e retornam o valor 256:

ds.BitAnd(352,400)
ds.BitAnd(mylink.mynumber1, mylink.mynumber2)

BitCompress

Retorna o número inteiro feito por meio do argumento de sequência, que contém uma representação binária "1"s e "0"s.

Sintaxe

ds.BitCompress(string (string))

Retorna: o número resultante representado por binários do formato uint64.

Exemplos

Se mylink.mynumber1 contém a string "0101100000", então as duas funções a seguir ambas retornam o número 352.

ds.BitCompress("0101100000")
ds.BitCompress(mylink.mynumber)

BitExpand

Retorna uma sequência contendo a representação binária em "1"s e "0"s do número inteiro especificado.

Sintaxe

ds.BitExpand(number (uint64))

retorna: uma sequência contendo a representação binária do número inteiro.

Exemplos

Se mylink.mynumber1 contém o número 352, então as duas funções a seguir são equivalentes, e retornam a string "101100000".

ds.BitExpand(352)
ds.BitExpand(mylink.mynumber)

BitOr

Retorna OR bit a bit dos dois argumentos de número inteiro.

Sintaxe

ds.BitOr(number1 (uint64), number2 (uint64))

retorna: o OR bit a bit dos dois argumentos de número inteiro.

Exemplos

Se mylink.mynumber1 contém o número 352 e mylink.mynumber2 contém o número 400, então as duas funções a seguir são equivalentes, e retornam o valor 496:

ds.BitOr(352,400)
ds.BitOr(mylink.mynumber1, mylink.mynumber2)

BitXOr

Retorna Exclusive OR bit a bit dos dois argumentos de número inteiro.

Sintaxe

ds.BitXOr(number1 (uint64), number2 (uint64))

retorna: o Exclusive OR no formato uint64.

Exemplos

Se mylink.mynumber1 contém o número 352 e mylink.mynumber2 contém o número 400, então as duas funções a seguir são equivalentes, e retornam o valor 240:

ds.BitXOr(352,400)
ds.BitXOr(mylink.mynumber1, mylink.mynumber2)

Não

Retorna o complemento do valor lógico de uma expressão. Se o valor da expressão for true, a função Not retornará um valor false (0). Se o valor da expressão for false, a função NOT retornará um valor true (1). Uma expressão numérica avaliada como 0 é um valor lógico falso. Uma expressão numérica avaliada como alguma outra coisa, que não seja o valor nulo, é uma lógica verdadeira. Uma sequência vazia é logicamente falsa. Todas as outras expressões de sequência incluindo as sequências que incluem uma sequência vazia, espaços ou o número 0 e espaços, são verdadeiramente verdadeiras.

Sintaxe

ds.Not()

retorna: o valor de complement no formato int8.

Exemplos

Se mylink.myexpression contém a expressão 5 - 5, então as duas funções a seguir são equivalentes, e retornam o valor 1:

ds.Not(5-5)
ds.Not(mylink.myexpression)

Se mylink.myexpression contém a expressão 5 + 5, então as duas funções a seguir são equivalentes, e retornam o valor 0:

ds.Not(5+5)
ds.Not(mylink.myexpression)

SetBit

Retorna um número inteiro com bits específicos configurados para um estado específico, em que origfield é o valor de entrada para o qual executar a ação, bitlist é uma sequência contendo uma lista de números de bits separados por vírgula para o qual configurar o estado, e bitstate é 1 ou 0, indicando para qual estado configurar esses bits.

Sintaxe

ds.SetBit(origfield (uint64), bitlist (string), bitstate (uint8))

retorna o número com os bits configurados para o estado especificado no formato uint64.

Exemplos

Se mylink.origfield contém o número 352, mylink.bitlist contém a lista "2,4,8", e mylink.bitstate contém o valor 1, então as duas funções a seguir são equivalentes, e retornam o valor 494:

ds.SetBit(356,"2,4,8",1)
ds.SetBit(mylink.origfield, mylink.bitlist, mylink.bitstate)

Sim

Retorna o valor verdadeiro de 1.

Sintaxe

ds.True()

retorna: o número inteiro 1.

Exemplos

O código a seguir retorna 1:

ds.True()

Não

Retorna o valor falso de 0.

Sintaxe

ds.False()

retorna: o número inteiro 0.

Exemplos

O código a seguir retorna 0:

ds.False()

Funções mataticas

As funções matemáticas executam operações matemáticas.

Abs

Retorna o valor absoluto de qualquer expressão numérica. O valor absoluto de uma expressão é sua magnitude não atribuída.

Sintaxe

ds.Abs(numeric_expression (int32))

retorna: o valor absoluto da expressão numérica no formato dfloat.

Exemplos

Se mylink.number1 contém o número 12 e mylink.number2 contém o número 34, então as duas funções a seguir são equivalentes, e retornam o número 22:

ds.Abs(12-34)
ds.Abs(mylink.mynumber1-mylink.mynumber2)

Se mylink.number1 contém o número 34 e mylink.number2 contém o número 12, então as duas funções a seguir são equivalentes, e retornam o número 22:

ds.Abs(34-12)
ds.Abs(mylink.mynumber1-mylink.mynumber2)

Acos

Calcula o arco cosseno trigonométrico de uma expressão. A expressão deve ser um valor numérico. O resultado é expresso em radianos.

Sintaxe

ds.Acos(numeric_expression (dfloat))

retorna: o radiano resultante no formato dfloat.

Exemplos

Se mylink.number contiver o número 0.707106781, as duas funções a seguir serão equivalentes e retornarão o valor 0.7854:

ds.Acos(0.707106781)
ds.Acos(mylink.mynumber)

ACOS

Retorna o arco trigonométrico-cosseno de expressão. A entrada deve ser um valor numérico. O resultado é expresso em graus.

Sintaxe

ds.ACOS(expression (float64))

retorna: o ângulo em graus, de formato float64 .

Exemplos

O código a seguir retorna o valor 45:

ds.ACOS(0.707106781)

Asin

Calcula o arco seno trigonométrico de uma expressão. A expressão deve ser um valor numérico. O resultado é expresso em radianos.

Sintaxe

ds.Asin(numeric_expression (dfloat))

retorna: o resultado radiano no formato dfloat.

Exemplos

Se mylink.number contiver o número 0.707106781, as duas funções a seguir serão equivalentes e retornarão o valor 0.7854:

ds.Asin(0.707106781)
ds.Asin(mylink.mynumber)

ASEN

Retorna o seno trigonométrico de uma expressão. Entrada é o ângulo expresso em graus.

Sintaxe

ds.ASIN(expression(float64))

retorna: o ângulo em graus, de formato float64 .

Exemplos

O código a seguir retorna o valor 45:

ds.ASIN(0.707106781)

Atan

Calcula o arco tangente trigonométrico de uma expressão. A expressão deve ser um valor numérico. O resultado é expresso em radianos.

Sintaxe

ds.Atan(numeric_expression (dfloat))

retorna: o resultado radiano no formato dfloat.

Exemplos

Se mylink.number contiver o número 135, as duas funções a seguir serão equivalentes e retornarão o valor 1.5634, que é o ângulo que possui um arco tangente de 135:

ds.Atan(135)
ds.Atan(mylink.mynumber)

ATAN

Retorna o arco-tangente trigonométrico da expressão A entrada deve ser um valor numérico. O resultado é expresso em graus.

Sintaxe

ds.ATAN(expression(float64))

retorna: o ângulo em graus, de formato dfloat.

Exemplos

O código a seguir retorna o valor 45:

ds.ATAN(1)

Atan2

Calcula o arco tangente trigonométrico de duas entradas usando os sinais das duas entradas para determinar o quadrante do resultado. As entradas devem ser valores numéricos. O resultado é expresso em radianos.

Sintaxe

ds.Atan2(numeric_expression (dfloat, dfloat))

retorna: o resultado radiano no formato dfloat.

Exemplos

Se mylink.number1 contiver o número 10.0 e mylink.number2 contiver o número -10.0, as duas funções a seguir serão equivalentes e retornarão o valor 2.3562:

ds.Atan2(10.0, -10.0)
ds.Atan2(mylink.mynumber1, mylink.mynumber2)

Ceil

Calcula o menor valor de número inteiro maior ou igual ao valor decimal fornecido.

Sintaxe

ds.Ceil(number (dfloat))

retorna: o menor valor de número inteiro em int32.

Exemplos

Se mylink.number contém o número 2355,66, então as duas funções a seguir são equivalentes, e retornam o valor 2356:

ds.Ceil(2355.66)
ds.Ceil(mylink.mynumber)

Cos

Calcula o cosseno trigonométrico de uma expressão. A expressão deve ser um valor numérico. A expressão deve produzir um valor numérico que seja o ângulo em radianos.

Sintaxe

ds.Cos(radians (dfloat))

retorna: o ângulo em radianos no formato dfloat.

Exemplos

Se mylink.number contém o número 0,785398, então as duas funções a seguir são equivalentes, e retornam o valor 0,7071:

ds.Cos(0.785398)
ds.Cos(mylink.mynumber)

COS

Retorna o cosseno trigonométrico de um ângulo. A expressão é um ângulo como um valor em graus.

Sintaxe

ds.COS(expression(float64))

retorna: o ângulo em graus, de formato float64 .

Exemplos

O código a seguir retorna o valor 0.7071:

ds.COS(45)

Cosh

Calcula o cosseno hiperbólico de uma expressão. A expressão deve ser um valor numérico.

Sintaxe

ds.Cosh(number (dfloat))

retorna: o cosseno resultante no formato dfloat.

Exemplos

Se mylink.number contém o número 2, então as duas funções a seguir são equivalentes, e retornam o valor 3,7622:

ds.Cosh(2)
ds.Cosh(mylink.mynumber)

Div

Calcula o cosseno hiperbólico de uma expressão. A expressão deve ser um valor numérico.

Sintaxe

ds.Div(dividend (dfloat), divisor (dfloat))

retorna: o cosseno resultante no formato dfloat.

Exemplos

Se mylink.dividend contém o número 100, e mylink.divisor contém o número 25, então as duas funções a seguir são equivalentes, e retornam o valor 4:

ds.Div(100,25)
ds.Div(mylink.dividend, mylink.divisor)

Exp

Calcula o resultado da base e elevada à potência designada pelo valor da expressão. O valor de e é aproximadamente 2,71828. A expressão deve ser avaliada como um valor numérico.

Sintaxe

ds.Exp(number (dfloat))

retorna: o e resultante elevado à potência especificada no formato dfloat.

Exemplos

Se mylink.number contém o número 5, então as duas funções a seguir são equivalentes, e retornam o valor 54,5982:

ds.Exp(5-1)
ds.Exp(mylink.number-1)

Fabs

Calcula o valor absoluto do valor flutuante fornecido.

Sintaxe

ds.Fabs(number (dfloat))

retorna: o valor absoluto do número flutuante.

Exemplos

Se mylink.number contém o número -26,53, então as duas funções a seguir são equivalentes, e retornam o valor 26,53:

ds.Fabs(-26.53)
ds.Fabs(mylink.number)

Andar

Calcula o maior valor de número inteiro menor ou igual ao valor decimal fornecido.

Sintaxe

ds.Floor(number (dfloat))

retorna: o maior inteiro menor ou igual ao valor decimal no formato int32 .

Exemplos

Se mylink.number contém o número 203,25, então as duas funções a seguir são equivalentes, e retornam o valor 203:

ds.Floor(203.25)
ds.Floor(mylink.number)

Ldexp

Retorna um valor dfloat da multiplicação da mantissa por 2 elevado à potência do expoente.

Sintaxe

ds.Ldexp(mantissa (dfloat), exponent (int32))

retorna: a mantissa resultante no formato dfloat.

Exemplos

Se mylink.mantissa contém o número 2, e mylink.exponent contém o número 3, então as duas funções a seguir são equivalentes, e retornam o valor 16:

ds.Ldexp(2,3)
ds.Ldexp(mylink.mantissa, mylink.exponent)

Llabs

Calcula o valor absoluto do valor de número inteiro fornecido.

Sintaxe

ds.Llabs(number (integer))

retorna: o valor absoluto do número inteiro fornecido como um inteiro não assinado.

Exemplos

Se mylink.number contém o número -26, então as duas funções a seguir são equivalentes, e retornam o valor 26.

ds.Llabs(-26)
ds.Llabs(mylink.number)

Ln

Calcula o logaritmo natural de uma expressão na base e. O valor de e é aproximadamente 2,71828. A expressão deve ser avaliada como um valor numérico maior que 0.

Sintaxe

ds.Ln(number (dfloat))

retorna: o logaritmo resultante da expressão na base e.

Exemplos

Se mylink.number contiver o número 6, as duas funções a seguir serão equivalentes e retornarão o valor 1.7918:

ds.Ln(6)
ds.Ln(mylink.number)

Log10

Retorna o logaritmo na base 10 do valor fornecido.

Sintaxe

ds.Log10(number (dfloat))

retorna: o logaritmo base 10 resultante em formato dfloat.

Exemplos

Se mylink.number contiver o número 6, as duas funções a seguir serão equivalentes e retornarão o valor 1.7782:

ds.Log10(6)
ds.Log10(mylink.number)

Máx.

Retorna o maior dos dois valores de argumento.

Sintaxe

ds.Max(number1 (int32), number2(int32))

retorna: o maior dos dois números inteiros no formato int32 .

Exemplos

Se mylink.number1 contém o número 6, e mylink.number1 contém o número 101, então as duas funções a seguir são equivalentes, e retornam o valor 101:

ds.Max(6,101)
ds.Max(mylink.number1, mylink.number2)

Mínimo

Retorna o mínimo dos dois valores de argumento

Sintaxe

ds.Min(number1 (int32), number2(int32))

retorna: o menor dos dois números inteiros.

Exemplos

Se mylink.number1 contém o número 6, e mylink.number1 contém o número 101, então as duas funções a seguir são equivalentes, e retornam o valor 6:

ds.Min(6,101)
ds.Min(mylink.number1, mylink.number2)

Mod

Calcula o módulo (o restante) das duas expressões (dividendo, divisor).

Sintaxe

ds.Mod(dividend (int32), divisor (int32))

retorna: o modulo resultante no formato int32.

Exemplos

Se mylink.dividend contém o número 115, e mylink.divisor contém o número 25, então as duas funções a seguir são equivalentes, e retornam o valor 15:

ds.Mod(115,25)
ds.Mod(mylink.dividend, mylink.divisor)

Neg

Nega um número.

Sintaxe

ds.Neg(number (dfloat))

retorna: o número negado resultante no formato dfloat.

Exemplos

Se mylink.number contém o número 123, então as duas funções a seguir são equivalentes, e retornam o valor -123:

ds.Neg(123)
ds.Neg(mylink.number)

Pwr

Calcula o valor de uma expressão quando elevada a uma potência especificada (expressão, potência).

Sintaxe

ds.Pwr(expression (dfloat), power (dfloat))

retorna: o número resultante que é levantado para a energia especificada no formato dfloat

Exemplos

Se mylink.expression contém o número 2, e mylink.power contém o número 3, então as duas funções a seguir são equivalentes, e retornam o valor 8:

ds.Pwr(2,3)
ds.Pwr(mylink.expression, mylink.power)

Rand

Retorna um número inteiro pseudoaleatório entre 0 e 2³²-1.

Sintaxe

ds.Rand()

retorna: o número inteiro aleatório resultante no formato uint32.

Exemplos

Use essa função para gerar um número pseudoaleatório:

ds.Rand()

Aleatório

Retorna um número inteiro pseudoaleatório entre 0 e 2³²-1.

Sintaxe

ds.Random()

retorna: o número inteiro aleatório resultante no formato uint32.

Exemplos

Use essa função para gerar um número aleatório:

ds.Random()

ARRED

Gera qualquer inteiro aleatório positivo ou negativo ou 0. Usa o número total de números inteiros como entrada, incluindo 0, a partir do qual o número aleatório pode ser selecionado Ou seja, se n é o valor de numeric_expression, o número aleatório é gerado a partir dos números 0 através de (n-1).

Sintaxe

ds.Rnd(numeric_expression (int))

retorna: um número aleatório de 0 para (numeric_expression - 1) em formato int.

Exemplos

O código a seguir retorna um número aleatório a partir de 0-19.

ds.Rnd(20)

Sin

Calcula o seno trigonométrico de uma expressão. A expressão deve ser um valor numérico. A expressão deve produzir um valor numérico que seja o ângulo em radianos.

Sintaxe

ds.Sin(radians (dfloat))

retorna: o ângulo resultante no formato dfloat.

Exemplos

Se mylink.number contém o número 0,785398, então as duas funções a seguir são equivalentes, e retornam o valor 0,7071:

ds.Sin(0.785398)
ds.Sin(mylink.mynumber)

SEN

Retorna o seno trigonométrico de uma expressão. Entrada é o ângulo expresso em graus.

Sintaxe

ds.SIN(expression(float64))

retorna: o ângulo em graus, de formato dfloat.

Exemplos

O código a seguir retorna o valor 0.7071:

ds.SIN(45)

Sinh

Calcula o seno hiperbólico de uma expressão. A expressão deve ser um valor numérico.

Sintaxe

ds.Sinh(number (dfloat))

retorna: o seno resultante no formato dfloat.

Exemplos

Se mylink.number contiver o número 2, as duas funções a seguir serão equivalentes e retornarão o valor 3.6269:

ds.Sinh(2)
ds.Sinh(mylink.mynumber)

Sqrt

Calcula a raiz quadrada de um número.

Sintaxe

ds.Sqrt(number (dfloat))

retorna: a raiz quadrada resultante do número no formato dfloat.

Exemplos

Se mylink.number contém o número 450, então as duas funções a seguir são equivalentes, e retornam o valor 21,2132:

ds.Sqrt(450)
ds.Sqrt(mylink.mynumber)

Tan

Calcula a tangente trigonométrica de uma expressão. A expressão deve produzir um valor numérico que seja o ângulo em radianos.

Sintaxe

ds.Tan(radians (dfloat))

retorna: a tangente resultante no formato dfloat.

Exemplos

Se mylink.number contiver o número 0.7853981, as duas funções a seguir serão equivalentes e retornarão o valor 1:

ds.Tan(0.7853981)
ds.Tan(mylink.mynumber)

TAN

Retorna a função TAN para retornar a tangente trigonométrica da entrada. A entrada representa um ângulo expresso em graus.

Sintaxe

ds.TAN(expression(float64))

retorna: o ângulo em graus, de formato float64 .

Exemplos

O código a seguir retorna o valor 1:

ds.TAN(45)

ATAN

Retorna o arco-tangente trigonométrico da expressão A entrada deve ser um valor numérico. O resultado é expresso em graus.

Sintaxe

ds.ATAN(expression(float64))

retorna: o ângulo em graus, de formato float64 .

Exemplos

O código a seguir retorna o valor 45:

ds.ATAN(1)

Tanh

Calcula a tangente hiperbólica de uma expressão. A expressão deve ser um valor numérico.

Sintaxe

ds.Tanh(number (dfloat))

retorna: a tangente resultante no formato dfloat.

Exemplos

Se mylink.number contém o número 2, então as duas funções a seguir são equivalentes, e retornam o valor 0,964028:

ds.Tanh(2)
ds.Tanh(mylink.mynumber)

Funções de número

Use as funções numéricas para extrair a mantissa de um decimal ou de um número de vírgula flutuante. A categoria Número no editor de expressão também contém as funções de casting do tipo, que pode-se usar para executar cast de números como tipos de dados duplo, flutuante ou número inteiro.

As funções do transformador AsDouble(), AsFloat()e AsInteger() comportam-se de forma diferente do que outras funções de conversões de dados transformadores quando são usadas em derivações em que o resultado é uma string. O comportamento é porque o compilador do transformador não converte os resultados da função para essas funções em uma sequência.

AsDouble

Trate o número fornecido como dobro.

Sintaxe

ds.AsDouble(number (int, float and so on))

retorna: o número em formato duplo.

Exemplos

Na expressão a seguir, a entrada mynumber contém um número inteiro, mas a função emite um duplo. Se mylink.mynumber contiver o valor 56, as duas funções a seguir serão equivalentes e retornarão o valor 12.963:

ds.AsDouble(56/4.32)
ds.AsDouble(mylink.mynumber/4.32)

AsFloat

Trate o número fornecido como um valor flutuante.

Sintaxe

ds.AsFloat(number (int, double and so on))

retorna: o número no formato de flutuação.

Exemplos

Na expressão a seguir, a entrada mynumber contém um número inteiro, mas a função executa saída de um flutuante. Se mylink.mynumber contiver o valor 56, as duas funções a seguir serão equivalentes e retornarão o valor 12.963:

ds.AsFloat(56/4.32)
ds.AsFloat(mylink.mynumber/4.32)

AsInteger

Trate o número fornecido como um número inteiro. Mas há uma diferença no comportamento quando um decimal é designado a um número inteiro versus um flutuante ou um duplo sendo designado a um número inteiro. Se a conversão for feita do valor flutuante ou duplo para um número inteiro, ela será uma designação simples para um número inteiro. No caso de decimal AsInteger(), a função é iniciada e arredonda a saída para o valor mais próximo.

Sintaxe

ds.AsInteger(number (float, double and so on))

retorna: o número no formato de número inteiro.

Exemplos

Na expressão a seguir, o valor de entrada 12.962963 tem um tipo Double. Embora o valor seja do tipo Double, a função emite um número inteiro. Portanto, é uma designação simples para uma função de número inteiro e retorna o valor 12:

ds.AsInteger(12.962963)

Na expressão a seguir, os cálculos como (56/4.32) são tratados como um tipo Decimal e a chamada de função AsInteger() iniciada é arredondada para o valor mais próximo e retorna o valor 13:

ds.AsInteger(56/4.32)

FIX

Converte um valor numérico em um número de ponto flutuante com um número de precisão especificado. Se o número for avaliado para o valor nulo, null será retornado. O valor de precisão é um valor numérico que corresponde ao número de algarismo de precisão no número de ponto flutuante. A precisão padrão é 4. O valor do modo é uma sinalização que especifica como o excesso de dígitos são tratados. Se o modo for 0 ou não especificado, o excesso de dígitos é arredondado. Se o modo for qualquer coisa diferente de 0, o excesso de dígitos são truncados.

Sintaxe

ds.FIX(numeric_expression (string), precision (int8), mode (int32))

retorna: o número convertido de formato dfloat.

Exemplos

O seguinte código retorna o número 37.7363.

ds.FIX("37.73629273")

MantissaFromDecimal

Retorna a mantissa do decimal fornecido.

Sintaxe

ds.MantissaFromDecimal(number (decimal))

retorna: a mantissa no formato dfloat.

Exemplos

Se mylink.number contiver o número 243.7675, as duas funções a seguir serão equivalentes e retornarão o valor 7675:

ds.MantissaFromDecimal(243.7675)
ds.MantissaFromDecimal(mylink.mynumber)

MantissaFromDFloat

Retorna a mantissa do dfloat fornecido.

Sintaxe

ds.MantissaFromDFloat(number (dfloat))

retorna: a mantissa no formato dfloat.

Exemplos

Se mylink.number contém o número 1.234412000000000010E+4, então a função a seguir retorna o valor 1:

ds.MantissaFromDFloat(mylink.mynumber)

Real

Converte um número em uma sequência para digitar ponto flutuante sem perda de precisão.

Sintaxe

ds.Real(numeric_expression (string))

retorna: o número convertido de formato dfloat.

Exemplos

O seguinte código retorna o número 1.23.

ds.Real("1.23")

Funções brutas

Use a função Bruta para obter o comprimento dos dados em uma coluna que contém dados brutos

RawLength

Retorna o comprimento de uma sequência bruta.

Sintaxe

ds.RawLength(input string (string))

retorna: o comprimento da sequência bruta no formato int32.

Exemplos

Se mylink.rawdata contém os dados brutos de um bitmap, então a função a seguir retorna o tamanho do bitmap em bytes:

ds.RawLength(mylink.rawdata)

Funções de sequência de caracteres

Use essas funções para funções relacionadas à cadeia em uma expressão

AlNum

Verifica se a sequência fornecida contém apenas caracteres alfanuméricos.

Sintaxe

ds.AlNum(string (string))

retorna: um resultado de tipo int8, 1 se a entrada for válida para o tipo fornecido; caso contrário, 0.

Exemplo

Se mylink.mystring1 contiver a sequência "OED_75_9*E", a função a seguir retornará o valor 0 (false).

ds.AlNum(mylink.mystring1)

Se mylink.mystring2 contiver a sequência "12redroses", a função a seguir retornará o valor 1 (true).

ds.AlNum(mylink.mystring2)

Alfa

Verifica se a sequência fornecida contém apenas caracteres alfabéticos.

Sintaxe

ds.Alpha(string (string))

retorna: um resultado de tipo int8, 1 se a entrada for válida para o tipo fornecido; caso contrário, 0.

Exemplos

Se mylink.mystring1 contém a sequência "12redroses", então a função a seguir retornaria o valor 0 (false).

ds.Alpha(mylink.mystring1)

Se mylink.mystring2 contém a sequência "twelveredroses", então a função a seguir retornaria o valor 1 (true).

ds.Alpha(mylink.mystring2)

Gatos

Concatena duas strings.

Sintaxe

ds.Cats(str1 (string), str2 (string))

retorna: a sequência concatenada resultante.

Exemplos

O código a seguir retorna "ABC123".

ds.Cats("ABC", "123")

Mudança

Substitui a subsequência fornecida em uma expressão por uma sequência de substituição.

Se o argumento de subsequência for uma sequência vazia, o valor do argumento de expressão será retornado.

Se o valor do argumento de substituição for uma sequência vazia, todas as ocorrências da subsequência que começam na posição indicada pelo valor do argumento de início serão removidas. Se o valor do argumento de ocorrência for menor ou igual a 0, todas as ocorrências que iniciam a partir da posição indicada pelo valor do argumento de início serão substituídas. Caso contrário, o número de ocorrências que são substituídas é indicado pelo valor do argumento de ocorrência, começando a partir da posição que é indicada pelo valor do argumento de início. Se o valor do argumento inicial for menor ou igual a 1, a substituição iniciará a partir da primeira ocorrência. Caso contrário, a substituição será iniciada a partir da posição indicada pelo valor do argumento inicial.

Sintaxe

ds.Change(expression (string), substring (string), replacement (string), [occurrence (int32), [begin (int32)]])

retorna: a nova sequência com todas as subsequências substituídas.

Exemplos

Se mylink.mystring contém a expressão "aaabbbcccbbb", então a função a seguir retorna a sequência "aaaZZZcccZZZ".

ds.Change(mylink.mystring,"bbb","ZZZ")

Se mylink.mystring contém a expressão "ABC" e a subsequência estiver vazia, então a função a seguir retorna a sequência "ABC".

ds.Change(mylink.mystring,"","ZZZ")

Se mylink.mystring contém a expressão "aaabbbcccbbb" e a substituição estiver vazia, então a função a seguir retorna a string "aaaccc".

ds.Change(mylink.mystring, "bbb", "")

CompactWhiteSpace

Retorna a sequência depois de reduzir todo o espaço em branco consecutivo em um único espaço.

Sintaxe

ds.CompactWhiteSpace(string (string))

retorna: a sequência resultante com espaços em branco reduzidos.

Exemplos

Se mylink.mystring contiver a sequência "muitos espaços", a função a seguir retornará a sequência "muitos espaços":

ds.CompactWhiteSpace(mylink.mystring)

Comparar

Compara duas sequências para classificação. A comparação pode ser alinhada à esquerda (o padrão) ou alinhada à direita. Uma comparação alinhada à direita compara subsequências numéricas dentro das cadeias especificadas como números.

As sequências numéricas devem ocorrer na mesma posição de caracteres em cada sequência. Por exemplo, uma comparação alinhada à direita das sequências AB100 e AB99 indica que a AB100 é maior que AB99, pois 100 é maior que 99. Uma comparação alinhada à esquerda das sequências AC99 e AB100 indica que o AC99 é maior, pois C é maior que B.

Sintaxe

ds.Compare(string1 (string), string2 (string), [justification ("L" or "R")])

retorna: um resultado do tipo int8, -1 se string1 for menor que string2, 0 se ambas as sequências forem iguais e 1 se string1 for maior que string2.

Exemplos

Se mylink.mystring1 contém a sequência "AB99" e mylink.mystring2 contém a sequência "AB100", então a função a seguir retorna o resultado 1.

ds.Compare(mylink.mystring1, mylink.mystring2, "L")

Se mylink.mystring1 contém a sequência "AB99" e mylink.mystring2 contém a sequência "AB100", então a função a seguir retorna o resultado -1.

ds.Compare(mylink.mystring1, mylink.mystring2, "R")

CompareNoCase

Compara duas sequências para classificação, ignorando maiúsculas e minúsculas.

Sintaxe

ds.CompareNoCase(string1 (string), string2 (string))

retorna: um resultado do tipo int8, -1 se string1 for menor que string2, 0 se ambas as sequências forem iguais e 1 se string1 for maior que string2.

Exemplos

Se mylink.mystring1 contém a sequência "Chocolate Cake" e mylink.mystring2 contém a sequência "chocolate cake", então a função a seguir retorna o resultado 0.

ds.CompareNoCase(mylink.mystring1, mylink.mystring2)

CompareNum

Compara os primeiros n caracteres de duas sequências, n sendo especificado pelo usuário.

Sintaxe

ds.CompareNum(string1 (string), string2 (string), length (int16))

retorna: um resultado do tipo int8, -1 se string1 for menor que string2, 0 se ambas as sequências forem iguais e 1 se string1 for maior que string2.

Exemplos

Se mylink.mystring1 contém a sequência "Chocolate" e mylink.mystring2 contém a sequência "Choccy Treat", então a função a seguir retorna o resultado 0.

ds.CompareNum(mylink.mystring1, mylink.mystring2,4)

CompareNumNoCase

Compara os primeiros n caracteres de duas sequências, sem distinção entre maiúsculas e minúsculas, n sendo especificado pelo usuário.

Sintaxe

ds.CompareNumNoCase(string1 (string), string2 (string), length (int16))

retorna: um resultado do tipo int8, -1 se string1 for menor que string2, 0 se ambas as sequências forem iguais e 1 se string1 for maior que string2.

Exemplos

Se mylink.myraw contém a sequência "chocolate" e mylink.mystring2 contém a sequência "Choccy Treat", então a função a seguir retorna o resultado 0.

ds.CompareNumNoCase(mylink.mystring1, mylink.mystring2,4)

Conversão

Converte uma sequência em um formato de armazenamento interno ou externo especificado. A expressão de sequência avalia a sequência a ser convertida.

A tabela a seguir mostra os valores que podem ser especificados para conversão. O conv_code especifica tipos de formatos de armazenamento que estão envolvidos na conversão e conv_mode especifica qual formato é usado para entrada ou saída. Se você especificar "I" para conv_mode, a função ICONV() é usada para a conversão. Se você especificar "O" para conv_mode, a função OCONV() é usada para a conversão.

Tabela para valores de conversão

`conv_code`	`conv_mode`	Descrição
MÁX	I	Converte a sequência de entrada de hexadecimal em decimal.
MB	I	Converte a sequência de entrada de binário em decimal.
MX0C	I	Converte a sequência de entrada de hexadecimal para uma sequência de caracteres ASCII
MB0C	I	Converte a sequência de entrada de binário em sequência de caracteres ASCII.
MÁX	O	Converte a sequência de entrada de decimal em hexadecimal.
MB	O	Converte a sequência de entrada de decimal em binário.
MX0C	O	Converte a sequência de entrada de sequência de caracteres ASCII em hexadecimal.
MB0C	O	Converte a sequência de entrada de sequência de caracteres ASCII em binário.

Sintaxe

ds.Conversion(string (string), conv_code (string), conv_mode (string))

retorna: a sequência convertida.

Exemplos

Se mylink.mystring contém a sequência "1111", então a função a seguir retorna o valor 15.

ds.Conversion(mylink.mystring,"MB", "I")

Se mylink.mystring contém a sequência "CDE", então a função a seguir retorna o valor 434445.

ds.Conversion(mylink.mystring,"MX0C", "O")

Converter

Converte os caracteres na sequência que é designada na expressão fornecida. Converte os caracteres que são especificados em uma lista nos caracteres especificados em outra lista.

Sintaxe

ds.Convert(fromlist (string), tolist (string), expression (string))

retorna: a sequência com os caracteres designados convertidos.

Exemplos

Se mylink.mystring1 contém a sequência "NOW IS THE TIME", então a função a seguir retorna a sequência "NOW YS XHE XYME".

ds.Convert("TI","XY", mylink.mystring1)

Contagem

Conta o número de vezes que uma subsequência ocorre em uma sequência.

Sintaxe

ds.Count(string (string), substring (string))

retorna: o número de ocorrências de substring em formato int32 .

Exemplos

Se mylink.mystring1 contém a sequência ""chocolate drops, chocolate ice cream, chocolate bars", então a função a seguir retorna 3.

ds.Count(mylink.mystring1, "choc")

Dcount

Conta o número de campos delimitados em uma sequência.

Sintaxe

ds.Dcount(string (string), delimiter (string))

retorna: o número de campos delimitados no formato int32 .

Exemplos

Se mylink.mystring1 contém a sequência ""chocolate drops, chocolate ice cream, chocolate bars", então a função a seguir retorna 3.

ds.Dcount(mylink.mystring1,",")

DownCase

Muda todas as letras maiúsculas em uma sequência para letras minúsculas.

Sintaxe

ds.DownCase(string (string))

retorna: a sequência resultante em todas as minúsculas.

Exemplos

Se mylink.mystring1 contém a sequência "CaMel cAsE", então a função a seguir retorna a sequência "camel case".

ds.DownCase(mylink.mystring1)

DQuote

Coloca uma sequência entre aspas duplas.

Sintaxe

ds.DQuote(string (string))

retorna: a sequência resultante entre aspas duplas.

Exemplos

Se mylink.mystring1 contiver a sequência precisa de citações, a função a seguir retornará a sequência "precisa de citações".

ds.DQuote(mylink.mystring1)

Ereplace

Substitui uma subsequência em uma expressão com sequência de substituição.

Se o argumento da subsequência for uma sequência vazia, o valor do argumento de substituição será pré-fixado com o valor do argumento da expressão. Se o argumento de substituição for uma cadeia vazia, todas as ocorrências da subcadeia que começam a partir da posição indicada pelo valor do argumento de início serão removidas. Se o valor do argumento de ocorrência for menor ou igual a 0, todas as ocorrências iniciadas a partir do valor do argumento de início serão substituídas. Caso contrário, o número de ocorrências que são substituídas será indicado pelo valor do argumento de ocorrência, iniciando a partir da posição indicada pelo valor do argumento inicial. Se o valor do argumento inicial for menor ou igual a 1, a substituição iniciará a partir da primeira ocorrência. Caso contrário, a substituição será iniciada a partir da posição indicada pelo valor do argumento de início.

Sintaxe

ds.Ereplace(expression (string), substring (string), replacement (string), [occurrence (int32), [begin (int32)]])

retorna: a sequência resultante com todas as ocorrências da subsequência substituída.

Exemplos

Se mylink.mystring contém a expressão "ABC" e a subsequência estiver vazia, a função a seguir retorna o valor "ZZZABC".

ds.Ereplace(mylink.mystring,"","ZZZ")

Se mylink.mystring contém a expressão "aaabbbcccbbb" e a substituição estiver vazia, a função a seguir retorna o valor "aaaccc".

ds.Ereplace(mylink.mystring, "bbb", "")

Exchange

Substitui um caractere em uma string.

Sintaxe

ds.Exchange(str (string), findStr (string), replaceStr (string))

retorna: a sequência resultante com caracteres substituídos.

Exemplos

O código a seguir retorna: ".B.BC" (em inglês).

ds.Exchange("ABABC", "41", "2E")

EXTRACT

Acesse o conteúdo de dados de um campo, valor ou subvalor especificado a partir de uma matriz dinâmica. A função semelhante a REMOVE.

A matriz dinâmica de entrada deve ter apenas CHAR (254), CHAR (253), CHAR (252) como delimitadores e sua hierarquia como anteriormente gravada. Respectivamente, elas podem ser recuperadas pelas funções AM ou FM, VM, SM ou SVM. FM é o delimitador dos campos das cadeias de caracteres, VM é o delimitador dos valores das cadeias de caracteres e SM é o delimitador dos subvalores das cadeias de caracteres.

Para saber mais sobre ' EXTRACT, consulte a função EXTRACT.

Sintaxe

ds.EXTRACT(str (string), field (int64), [value (int64), subvalue (int64)])

retorna: a sequência extraída resultante string de formato.

Exemplos

Os códigos a seguir retornam: "9ü3ü5". A matriz dinâmica contém 3 campos que são separados por FM / AM, 2 valores no primeiro campo, 1 subvalor no primeiro valor e assim por diante.

ds.EXTRACT("1" + ds.FM() + "4" + ds.VM() + "9" + ds.SM() + "3" + ds.SM() + "5" + ds.FM() + "1" + ds.VM() + "0" + ds.SM() + "7" + ds.SM() + "3", 2, 2)
ds.EXTRACT("1" + ds.AM() + "4" + ds.VM() + "9" + ds.SM() + "3" + ds.SM() + "5" + ds.AM() + "1" + ds.VM() + "0" + ds.SM() + "7" + ds.SM() + "3", 2, 2)

O código a seguir retorna uma string vazia, já que existem apenas 3 campos e não 10 ou mais.

ds.EXTRACT("1" + ds.FM() + "4" + ds.VM() + "9" + ds.SM() + "3" + ds.SM() + "5" + ds.FM() + "1" + ds.VM() + "0" + ds.SM() + "7" + ds.SM() + "3", 10, 0, 0)

Campo

Retorna uma ou mais subsequências que estão localizadas entre os delimitadores especificados em uma sequência. A ocorrência de argumento especifica qual ocorrência do delimitador deve ser usada como um terminador. Opcionalmente, o número do argumento especifica quantas subsequências serão retornadas.

Sintaxe

ds.Field(string (string), delimiter (string), occurrence (int32), [number (int32)])

retorna: a sequência correspondente entre os delimitadores.

Exemplos

Se mylink.mystring1 contém a sequência "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers", então a função a seguir retorna a sequência " chocolate ice cream".

ds.Field(mylink.mystring1,",",2)

Se mylink.mystring1 contém a sequência "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers", então a função a seguir retorna a sequência " chocolate ice cream, chocolate bars".

ds.Field(mylink.mystring1,",",2,2)

FieldStore

Modifica strings de caracteres, inserindo, excluindo ou substituindo campos separados por uma sequência de delimitadores especificados. A string delimiters denota a string a ser modificada e pode ser qualquer caractere ASCII único. A função também usa parâmetros start (a posição da sequência de entrada na qual a modificação é iniciada) e number que é o número de vezes que uma nova sequência é inserida na sequência de entrada.

Sintaxe

ds.FieldStore(str (string), delimiter (string), start (int8), number (int8), new_fields (string))

retorna: a sequência modificada de string de formato.

Exemplos

O código a seguir retorna a string A#B#C#D#5:

ds.FieldStore("1#2#3#4#5", "#", 1, 4, "A#B#C#D")

Fmt

Utiliza a função FMT ou uma expressão de formato para formatar dados para saída. Qualquer expressão BASIC pode ser formatada para saída, seguindo-a com uma expressão de formato. Para obter detalhes sobre a sintaxe da função Fmt, consulte Função FMT.

Sintaxe

ds.Fmt(string (string), format (string))

retorna: os dados formatados resultantes de string de formato.

Exemplos

O código a seguir retorna a string "23-69-86":

ds.Fmt("236986","R##-##-##")

O seguinte código retorna o número "***** $555.666,898.00":

ds.Fmt("555666898","20*R2$,")

FmtDP

Converte um conjunto de caracteres multibyte de cadeia de tipos no formato de destino. Se globalização (globalização) não estiver ativada, a função FmtDP funcionará como uma função Fmt equivalente. Para obter detalhes sobre a sintaxe da função FmtDP , consulte FmtDP.

Sintaxe

ds.FmtDP(string (string), format (string), [mapname (string)])

retorna: a sequência convertida de string de formato.

Exemplos

O código a seguir retorna o número 56789:

ds.FmtDP("123456789","R#5")

Dobra

Dobra strings para criar substrings. string é a sequência a ser dobrada. length é o comprimento das substrings em caracteres.

ds.Fold(str (string), length (int8))

retorna: a sequência dobrada resultante.

O código a seguir retorna "THISþIS AþTESTþFOLDEþD STRþING".

ds.Fold("THIS IS A TEST FOLDED STRING", 5)

Dobrar

No modo de globalização (globalização), dobra sequências para criar subsequências que usam posições de exibição de caracteres.

Sintaxe

ds.Folddp(str (string), length (int), opmap (string))

retorna: a sequência dobrada resultante.

Exemplos

O código a seguir retorna: "Página Final de Página Final do STþUNICOþDE".

ds.Folddp("这里需要 UNICODE STRING", 5, "0")

Índice

Localiza a posição do caractere inicial de uma subsequência. A ocorrência do argumento especifica qual ocorrência da subsequência deve ser localizada.

Sintaxe

ds.Index(string (string), substring (string), occurrence (int32))

retorne: o resultado no formato int32 do número de ocorrências.

Exemplos

Se mylink.mystring1 contém a sequência "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers", então a função a seguir retorna o valor 18.

ds.Index(mylink.mystring1,"chocolate",2)

Esquerda

Retorna os n caracteres mais à esquerda de uma sequência.

Sintaxe

ds.Left(string (string) number (int32))

retorna: os n caracteres mais à esquerda da sequência.

Exemplos

Se mylink.mystring1 contém a sequência "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers", então a função a seguir retorna a sequência "chocolate".

ds.Left(mylink.mystring1,9)

Len

Retorna o comprimento de uma sequência em caracteres.

Sintaxe

ds.Len(string (string))

retorna: o comprimento da string em formato int32 .

Exemplos

Se mylink.mystring1 contém a sequência "chocolate", então a função a seguir retorna o valor 9.

ds.Len(mylink.mystring1)

Empréstimo

No modo de globalização (globalização), retorna o comprimento de uma cadeia com suas posições totais de exibição.

Sintaxe

ds.Lendp(str (string), opmap (string))

retorna: o comprimento da cadeia de formato int64.

Exemplos

O código a seguir retorna: 19.

ds.Lendp("这里需要 UNICODE STRING", "0")

Correspondência

Sinônimo de MATCHES. Usado para comparar uma expressão string com um padrão. Para saber mais sobre a sintaxe ' Match, consulte Match Operator.

Sintaxe

ds.Match(str (string), pattern (string))

retorna: o resultado de se o padrão corresponde à sequência de entrada, de formato Booleano

Exemplos

O código a seguir retorna falso:

ds.Match("XYZ123AB", "3X3N")

O código a seguir retorna true:

ds.Match("XYZ123AB", "3X3N...")

MatchField

Procura uma string e retorna a parte dela que corresponde ao parâmetro input pattern . Para saber mais sobre a sintaxe " MatchField, consulte Operador MATCH.

Sintaxe

ds.MatchField(str (string), pattern (string), field (int))

retorna: o resultado da string de formato.

Exemplos

O código a seguir retorna a string "XYZ":

ds.MatchField("XYZ123AB", "3X3N...", 1)

Número

Retornará 1 se for possível converter a sequência em um número, caso contrário, retornará 0.

Sintaxe

ds.Num(string (string))

retorna: 1 se a string pode ser convertida em um número, ou retorna 0 caso contrário, em formato int32 .

Exemplos

Se mylink.mystring1 contém a sequência "22", então a função a seguir retorna o valor 1.

ds.Num(mylink.mystring1)

Se mylink.mystring1 contém a sequência "twenty two", então a função a seguir retorna o valor 0.

ds.Num(mylink.mystring1)

PadString

Retorna a sequência preenchida com o número especificado de caracteres de preenchimento.

Sintaxe

ds.PadString(string (string) padstring (string) padlength (int32))

retorna: a sequência preenchida resultante.

Exemplos

Se mylink.mystring1 contém a sequência "AB175", então a função a seguir retorna a sequência "AB17500000".

ds.PadString(mylink.mystring1,"0",5)

REMOVER

Extrai e retorna elementos de matriz dinâmica que são separados por delimitadores do sistema, e para indicar qual delimitador do sistema foi encontrado. Ele aceita um CHAR como um delimitador e retorna o número correspondente como qual delimitador é localizado.

Número	Tipo de Delimitador
0	Fim da cadeia
1	Marca de item ASCII CHAR (255)
2	Marca de campo ASCII CHAR (254)
3	Marca de valor ASCII CHAR (253)
4	Marca de subvalor ASCII CHAR (252)
5	Marca de texto ASCII CHAR (251)
6	ASCII CHAR (250) (Não disponível no tipo PIOPEN)
7	ASCII CHAR (249) (Não disponível no tipo PIOPEN)
8	ASCII CHAR (248) (Não disponível no tipo PIOPEN)

Para obter mais informações sobre a função REMOVE, consulte Função REMOVE.

Sintaxe

ds.REMOVE(str (string))

retorna: a sequência resultante com delimitadores removidos da lista string de formato, e o número que corresponde ao delimitador encontrado.

Exemplos

O código a seguir retorna ["3", "12"].

ds.REMOVE("12" + ds.VM() + "12" + ds.VM())

Direito

Retorna os n caracteres mais à direita de uma sequência.

Sintaxe

ds.Right(string (string) number (int32))

retorna: os n caracteres de mais à direita de uma sequência.

Exemplos

Se mylink.mystring1 contém a sequência "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers", então a função a seguir retorna a sequência "dippers".

ds.Right(mylink.mystring1,7)

Soundex

Retorna um código que identifica um conjunto de palavras que são (aproximadamente) foneticamente iguais com base no algoritmo padrão, aberto para a avaliação SOUNDEX .

Sintaxe

ds.Soundex(string (string))

retorna: o código que identifica um conjunto de palavras foneticamente semelhantes.

Exemplos

Se mylink.mystring1 contém a sequência "Griffin", então a função a seguir retorna o código "G615".

ds.Soundex(mylink.mystring1)

Se mylink.mystring1 contém a sequência "Griphin" então a função a seguir também retorna o código "G615".

ds.Soundex(mylink.mystring1)

Espaço

Retorna uma sequência de n caracteres de espaço.

Sintaxe

ds.Space(length (int32))

retorna: uma sequência de espaços em branco com comprimento especificado.

Exemplos

Se mylink.mylength contém o número 100, então a função a seguir retorna uma sequência que contém 100 caracteres de espaço.

ds.Space(mylink.mylength)

SQuote

Inclui uma sequência entre aspas simples.

Sintaxe

ds.SQuote(string (string))

retorna: a sequência entre aspas.

Exemplos

Se mylink.mystring1 contiver a sequência precisa de aspas, então a função a seguir retornará a sequência 'precisa de aspas'.

ds.SQuote(mylink.mystring1)

Str

Repete uma sequência o número de vezes especificado.

Sintaxe

ds.Str(string (string), repeats (int32))

retorna: a sequência resultante repetida n vezes.

Exemplos

Se mylink.mystring1 contém a sequência precisa de "choc", então a função a seguir retorna a sequência "chocchocchocchocchoc".

ds.Str(mylink.mystring1,5)

StripWhiteSpace

Retorna a sequência após remover todos os caracteres de espaço em branco dela.

Sintaxe

ds.StripWhiteSpace(string (string))

retorna: a sequência sem espaços em branco.

Exemplos

Se mylink.mystring contém a sequência "too many spaces", então a função a seguir retorna a sequência "toomanyspaces":

ds.StripWhiteSpace(mylink.mystring)

Subsequência de caracteres

Retorna a substring especificada.

Quando n é especificado, a função obtém os últimos n caracteres de uma cadeia.

Quando start e length são especificados, a função obtém os caracteres com comprimento igual a length a partir da posição start de uma sequência.

Quando um delimitador é especificado, a função obtém uma ou mais subsequências que estão localizadas entre os delimitadores especificados em uma sequência. occu é o número de delimitadores e num é o comprimento da substring entre delimitadores na subsequência resultante.

Sintaxe

ds.Substring(string (string), n (int8))
ds.Substring(string (string), start (int8), length (int8))
ds.Substring(string (string), delimiter (string), occu (int8), num (int8))

retorna: a matriz substring resultante de string de formato.

Exemplos

O seguinte código retorna "ab.cd".

ds.Substring("ab.cd", ".", 1, 2)

Subcadeias

Cria uma matriz dinâmica, da qual todos os elementos são substrings dos elementos correspondentes da matriz dinâmica de entrada.

Sintaxe

ds.Substrings(str (string), start (int8), length (int8))

retorna: a matriz dinâmica resultante com substrings correspondentes à matriz de entrada, de formato string.

Exemplos

O código a seguir retorna "NESýITHþ23üý50ü".

ds.Substrings("JONESýSMITHþ1.23ü20ý2.50ü10", 3, 20)

Trim

Remove todos os espaços à esquerda e à direita e as tabulações. A função também reduz as ocorrências internas de espaços ou tabulações em um.

Opcionalmente, o argumento stripchar especifica um caractere diferente de um espaço ou uma tabulação. O argumento options especifica o tipo de operação de corte a ser executada e contém um ou mais dos seguintes valores:

A: Remover todas as ocorrências de stripchar.
B Remover ambas as ocorrências de espaços iniciais e finais de stripchar.
D Remover caracteres de espaço em branco redundantes, iniciais e finais.
E Remover caracteres de espaço em branco finais.
F Remover caracteres de espaço em branco iniciais.
L Remover todas as ocorrências iniciais de stripchar.
R Remover ocorrências redundantes, iniciais e finais de stripchar.
T Remover todas as ocorrências finais de stripchar.

Sintaxe

ds.Trim(string (string), [stripchar (string)], [options (string)])

retorna: a sequência cortada.

Exemplos

Se mylink.mystring contiver a sequência " Sequência com espaço em branco ", em seguida, a seguinte função retorna a sequência" Sequência com espaço em branco ":

ds.Trim(mylink.mystring)

Se mylink.mystring contém a string " ..Remover .. dots redundantes .... ", a função a seguir retornará a sequência "Remove.redundant.dots":

ds.Trim(mylink.mystring,".")

Se mylink.mystring contém a string "Remover .. all.. dots....", a função a seguir retornará a sequência "Removealldots":

ds.Trim(mylink.mystring,".","A")

Se mylink.mystring contém a string "Remover .. trailing.. dots....", a função a seguir retornará a sequência "Remove..trailing..dots":

ds.Trim(mylink.mystring,".","T")

TrimB

Remove todos os espaços à direita e tabulações de uma sequência.

Sintaxe

ds.TrimB(string (string))

retorna: a sequência cortada.

Exemplos

Se mylink.mystring contém a sequência "too many trailing spaces ", então a função a seguir retorna a sequência "too many trailing spaces":

ds.TrimB(mylink.mystring)

TrimF

Remove todos os espaços à esquerda e as tabulações de uma sequência.

Sintaxe

ds.TrimF(string (string))

retorna: a sequência cortada.

Exemplos

Se mylink.mystring contém a sequência " too many leading spaces", então a função a seguir retorna a sequência "too many leading spaces":

ds.TrimF(mylink.mystring)

TrimLeadingTrailing

Remove todos os espaços iniciais e finais e as tabulações de uma sequência.

Sintaxe

ds.TrimLeadingTrailing(string (string))

retorna: a sequência cortada.

Exemplos

Se mylink.mystring contém a sequência " too many spaces ", então a função a seguir retorna a sequência "too many spaces":

ds.TrimLeadingTrailing(mylink.mystring)

UpCase

Muda todas as letras minúsculas em uma sequência para maiúsculas.

Sintaxe

ds.UpCase(string (string))

retorna: a sequência resultante em todas as maiúsculas.

Exemplos

Se ' mylink.mystring1 contiver a string "CaMel cAsE", a função a seguir retornará a string "CAMEL CASE":

ds.UpCase(mylink.mystring1)

IM

Retorna CHAR (255). Funciona o mesmo que AM.

Sintaxe

ds.IM()

retorna: o CHAR resultante (255).

Exemplos

O código a seguir retorna 'bonus'.

ds.IM()

DE

Retorna CHAR (254).

Sintaxe

ds.FM()

retorna: o CHAR resultante (254).

Exemplos

O código a seguir retorna 'þ'.

ds.FM()

AM

Retorna CHAR (254). Funciona o mesmo que FM.

Sintaxe

ds.AM()

retorna: o CHAR resultante (254).

Exemplos

O código a seguir retorna 'þ'.

ds.AM()

VM

Retorna CHAR (253).

Sintaxe

ds.VM()

retorna: o CHAR resultante (253).

Exemplos

O código a seguir retorna 'ý'.

ds.VM()

SOMA

Retorna CHAR (252). Funciona o mesmo que SVM.

Sintaxe

ds.SM()

retorna: o CHAR resultante (252).

Exemplos

O código a seguir retorna 'ü'.

ds.SM()

SVM

Retorna CHAR (252). Funciona o mesmo que SM.

Sintaxe

ds.SVM()

retorna: o CHAR resultante (252).

Exemplos

O código a seguir retorna 'ü'.

ds.SVM()

TM

Retorna CHAR (251).

Sintaxe

ds.TM()

retorna: o CHAR resultante (251).

Exemplos

O código a seguir retorna 'û'.

ds.TM()

Funções de Utilitário

As funções de utilitário especificam vários propósitos relacionados à recuperação de informações sobre funções específicas do DataStage .

ElementAt

Retorna o elemento na lista especificado pelo índice.

Sintaxe

ds.ElementAt(list (object))

retorna: o índice de elemento do objeto de formato.

Exemplos

O código a seguir retorna 'b':

ds.ElementAt(["a","b","c"], 1)

O código a seguir retorna 2:

ds.ElementAt([1,2,3], 1)

GetCommandName

Leva o ID do nó de uma atividade "Run Bash Script" e o recupera o nome de comando da atividade de script Run bash.

Sintaxe

ds.GetCommandName(tasks.activity_id (string))

retorna: o nome de comando da string de formato.

Exemplos

O código a seguir retorna o nome do comando da tarefa run_bash_script_5:

ds.GetCommandName(tasks.run_bash_script_5)

GetCommandOutput

Leva o ID do nó de uma "Executar atividade de Script Bash" e recupera sua saída padrão. É equivalente à expressão CEL:

tasks.<activity_id>.results.standard_output

Sintaxe

ds.GetCommandOutput(tasks.activity_id (string))

retorna: a saída padrão de cadeia de formato.

Exemplos

O código a seguir retorna a saída padrão da tarefa run_bash_script_5:

ds.GetCommandOutput(tasks.run_bash_script_5)

GetErrorMessage

Usado apenas na tarefa em um manipulador de exceções, a saída é o texto da mensagem que é registrado como um aviso quando a exceção é emitida

Sintaxe

ds.GetErrorMessage()

retorna: a mensagem resultante de string de formato.

Exemplos

O código a seguir retorna a mensagem de erro de uma tarefa falha:

ds.GetErrorMessage()

GetErrorNumber

Usado na tarefa em um manipulador de exceções apenas, a saída é o número inteiro, que indica o tipo de erro iniciado. 1 ou -1.

1 indica que a tarefa executou uma tarefa que foi cancelada e nenhum manipulador específico está configurado.

--1 indica que a tarefa não foi executada por outros motivos.

Sintaxe

ds.GetErrorNumber()

retorna: o inteiro resultante do formato int.

Exemplos

O código a seguir retorna o número de erro do tipo de atividade do manipulador de exceções:

ds.GetErrorNumber()

GetErrorSource

Usada na tarefa em um manipulador de exceção apenas, a saída é o nome artístico do estágio de atividade que levantou a exceção.

Sintaxe

ds.GetErrorSource()

retorna: o valor resultante da tarefa de string de formato.

Exemplos

O código a seguir retorna a tarefa que falhou:

ds.GetErrorSource()

GetJobName

Retorna o nome da tarefa da atividade Executar DataStage no momento em que a função é executada. É equivalente à expressão CEL:

tasks.<activity_id>.results.job_name

Sintaxe

ds.GetJobName(tasks.activity_id (string))

retorna: o nome do trabalho de string de formato.

Exemplos

O código a seguir retorna o nome da tarefa run_datastage_flow_1:

ds.GetJobName(tasks.run_datastage_flow_1)

GetJobNameWithInvocationId

Retorna o nome da tarefa da atividade Executar DataStage no momento em que a função é executada com um ID de chamada de sufixo se a tarefa foi executada em várias instâncias e o ID de chamada da tarefa não estiver vazio...

Sintaxe

ds.GetJobNameWithInvocationId(tasks.nodeId)

retorna: o nome da tarefa da sequência de formatações, sufixado com o ID de chamada se disponível.

Exemplos

O seguinte código retorna rowGenPeekJob.bigloop1 com o nome da tarefa rowGenPeekJob e o ID de chamada de bigloop1:

ds.GetJobNameWithInvocationId(tasks.rowGenPeekJob)

GetJobStatus

Obtém o ID do nó de uma "atividade Executar DataStage " e recupera seu status de tarefa para <activity_name>.$JobStatus. É equivalente à expressão cel a seguir:

((tasks.<activity_id>.results.status == 'Completed') ? 1 : ((tasks.<activity_id>.results.status == 'CompletedWithWarnings') ? 2 : ((tasks.<activity_id>.results.status == 'Cancelled') ? 96 : 3)))

Sintaxe

ds.GetJobStatus(tasks.activity_id (string))

retorna: o status de tarefa do formato int.

Exemplos

O código a seguir retorna o status da tarefa run_datastage_flow_1:

ds.GetJobStatus(tasks.run_datastage_flow_1)

GetListCounter

Usada na tarefa em um loop com contador de lista apenas, a saída é o valor atual da variável de contador.

Sintaxe

ds.GetListCounter()

retorna: o valor resultante do contador de string de formato.

Exemplos

O código a seguir retorna o valor atual do loop.

ds.GetListCounter()

GetNumericCounter

Usada na tarefa em um loop com um contador numérico apenas, a saída é o valor atual da variável de contador do loop.

Sintaxe

ds.GetNumericCounter()

retorna: o valor resultante do contador de formato int.

Exemplos

O código a seguir retorna o valor atual do loop.

ds.GetNumericCounter()

GetOutputArg

Retorna o valor especificado de uma chave de uma entrada de JSON do tipo sequência.

Sintaxe

ds.GetOutputArg(JSON (string), key_value (string))

retorna: O valor do campo de propriedade

Exemplos

O código a seguir retorna o valor de cadeia "tom":

ds.GetOutputArg("{"name":"tom"}", "name")

GetReturnValue

Leva o ID do nó de uma atividade "Run Bash Script" e retorna o valor da atividade Run Bash Script. É equivalente à expressão CEL a seguir:

tasks.<activity_id>.results.return_value

Sintaxe

ds.GetReturnValue(tasks.activity_id (string))

retorna: o valor resultante da tarefa de formato int.

Exemplos

O código a seguir retorna o valor da tarefa tasks.run_bash_script_5:

ds.GetReturnValue(tasks.run_bash_script_5)

GetUserStatus

Obtém o ID de uma tarefa de fluxo DataStage e retorna o status da tarefa de fluxo DataStage na tarefa de sequência. A função não funcionará se for executada em tarefa paralela. É equivalente à expressão CEL:

tasks.<activity_id>.results.user_status

Sintaxe

ds.GetUserStatus(tasks.run_datastage_id (string))

retorna: o status do ID da tarefa de fluxo do DataStage da sequência de formatações

Exemplos

O código a seguir retorna o valor do ID da tarefa run_datastage_5:

ds.GetUserStatus(tasks.run_datastage_5)

LogName

Retorna o nome de login do usuário atual.

Sintaxe

ds.LogName()

retorna: o nome de login do usuário atual da string de formato.

Exemplos

O código a seguir retorna o nome de login do usuário atual.

ds.LogName()

Caminho

Retorna o nome do caminho do usuário atual.

Sintaxe

ds.Path()

retorna: o nome do caminho do usuário atual da string de formato.

Exemplos

O código a seguir retorna o nome do caminho do usuário atual.

ds.Path()

Esquema

Retorna o nome do esquema do usuário atual.

Sintaxe

ds.Schema()

retorna: o nome do esquema do usuário atual da string de formato.

Exemplos

O código a seguir retorna o nome do esquema do usuário atual.

ds.Schema()

UserNo

Retorna o número de usuário do usuário atual.

Sintaxe

ds.UserNo()

retorna: as informações do usuário do usuário atual do formato int.

Exemplos

O código a seguir retorna o número de usuário do usuário atual.

ds.UserNo()

Quem

Retorna o usuário atual.

Sintaxe

ds.Who()

retorna: o usuário atual da string de formato.

Exemplos

O código a seguir retorna o usuário atual.

ds.Who()

Funções de manipulação nula

Funções que fazem manipulação nula.

IsNull

Retorna true quando a expressão de entrada é avaliada para o valor null.

Sintaxe

ds.IsNull(input (any))

retorna: o resultado de se a expressão é avaliada como nula, do formato Booleano..

Exemplos

O código a seguir retorna true.

ds.IsNull(null)

O código a seguir retorna falso.

ds.IsNull(0)

IsNotNull

Retorna true quando a expressão de entrada não se avalia para o valor nulo.

Sintaxe

ds.IsNotNull(input (any))

retorna: o resultado de se a expressão não é avaliada como nula, do formato Booleano

Exemplos

O código a seguir retorna falso.

ds.IsNotNull(null)

O código a seguir retorna true.

ds.IsNotNull(0)

Nulo

Retorna o valor nulo.

Sintaxe

ds.Null()

retorna: o valor nulo.

Exemplos

O código a seguir retorna null.

ds.Null()

NullToEmpty

Retorna uma string vazia se a entrada for nula, caso contrário, retorna o valor da coluna de entrada.

Sintaxe

ds.NullToEmpty(input (any))

retorna: uma string vazia ou o valor de entrada.

Exemplos

O código a seguir retorna "AA".

ds.NullToEmpty("AA")

O código a seguir retorna "".

ds.NullToEmpty(null)

NullStr

Retorna o CHAR string nulo (128).

Sintaxe

ds.NullStr()

retorna: o string nulo CHAR (128).

Exemplos

O código a seguir retorna €.

ds.NullStr()

NullToValue

Retorna o valor especificado se a entrada for nula, caso contrário, retorna o valor da coluna de entrada.

Sintaxe

ds.NullToValue(input (any), default (any))

retorna: o valor especificado ou o valor de entrada.

Exemplos

O código a seguir retorna "teste".

ds.NullToValue("test", "default")

O código a seguir retorna "default".

ds.NullToValue(null, "default")

O código a seguir retorna 1.

ds.NullToValue(null, 1)

NullToZero

Retorna 0 se a entrada for nula, caso contrário, retorna o valor da coluna de entrada.

Sintaxe

ds.NullToZero(input (any))

retorna: 0 ou o valor de entrada.

Exemplos

O código a seguir retorna 88.

ds.NullToZero(88)

O código a seguir retorna 0.

ds.NullToZero(null)

SetNull

Designa um valor nulo para a coluna de destino.

Sintaxe

ds.SetNull()

retorna: define o destino para o valor nulo.

Exemplos

O código a seguir retorna null.

ds.SetNull()

Funções de Macros

Funções que manipulam a recuperação de um conjunto de metadados do projeto relacionados a tarefas de sequência do DataStage

JobName

Retorna o nome do trabalho sequenciador.

Sintaxe

ds.JobName

retorna: o nome de job sequencer da string de formato.

Exemplos

O código a seguir retorna o nome do job sequencer.

ds.JobName

JobStartDate

Retorna a data de início de tarefa do sequenciador.

Sintaxe

ds.JobStartDate

retorna: a data de início da tarefa do sequenciador da sequência de formatações.

Exemplos

O código a seguir retorna a data de início de tarefa do sequenciador.

ds.JobStartDate

JobStartTime

Retorna o tempo de início de tarefa do sequenciador.

Sintaxe

ds.JobStartTime

retorna: o tempo de início de tarefa do sequenciador de string de formato.

Exemplos

O código a seguir retorna o tempo de início de tarefa do sequenciador.

ds.JobStartTime

JobStartTimestamp

Retorna o timestamp de início de tarefa sequenciador.

Sintaxe

ds.JobStartTimestamp

retorna: o job sequencer start timestamp of format timestamp.

Exemplos

O código a seguir retorna o timestamp de início de job sequencer.

ds.JobStartTimestamp

HostName

Retorna o nome do host do servidor DataStage ..

Sintaxe

ds.HostName

retorna: o job sequencer InvocationId da string format.

Exemplos

O código a seguir retorna o job sequencer InvocationId.

ds.HostName

ProjectName

Retorna o nome do projeto do job sequencer de execução

Sintaxe

ds.ProjectName

retorna: o nome do projeto do job sequencer de execução.

Exemplos

O código a seguir retorna o nome do projeto do job sequencer de execução.

ds.ProjectName

ProjectId

Retorna o ID do projeto do job sequencer em execução.

Sintaxe

ds.ProjectId

retorna: o ID do projeto do job sequencer em execução.

Exemplos

O código a seguir retorna o ID do projeto do job sequencer em execução.

ds.ProjectId

JobId

Retorna o ID do job do job sequencer em execução.

Sintaxe

ds.JobId

retorna: o ID do emprego do job sequencer em execução.

Exemplos

Os comandos a seguir retornam o ID da tarefa da tarefa do sequenciador em execução.

ds.JobId

JobController

Retorna o nome do fluxo de pipeline da tarefa do sequenciador em execução

Sintaxe

ds.JobController

retorna: o nome do fluxo de pipeline da tarefa do sequenciador em execução

Exemplos

Os comandos a seguir retornam o nome do fluxo de pipeline da tarefa do sequenciador em execução

ds.JobController