Utilice estas funciones de DataStage en los editores de código de Orchestration Pipelines, por ejemplo, para definir una variable de usuario o crear una condición avanzada.
Sintaxis para las funciones del Generador de expresiones
En la sintaxis de los argumentos, los corchetes indican que un argumento es opcional.
Un parámetro puede aceptar datos de cualquier tipo. Puede especificar un argumento de tipo serie, int, float, null y otros tipos. Por ejemplo, la función IsNull(input (any)) acepta los siguientes tipos de parámetros, pero no es exclusiva de los tipos siguientes:
ds.IsNull(1)
ds.IsNull("try null")
ds.IsNull(1.78)
ds.IsNull(null)
El generador de expresiones utiliza estas categorías para codificar funciones:
Funciones de conversión
Convierte un único formato de elemento de datos en otro.
Ascii
Convierte los valores de caracteres en una serie de formato EBCDIC a ASCII.
Sintaxis
ds.Ascii(input (string))
devuelve: la serie EDBCDI convertida a una serie ASCII resultante de serie de formato.
Ejemplo
El código siguiente devuelve "65 66 67":
ds.Ascii("193 194 195")
Char
Devuelve un carácter ASCII de su valor de código numérico.
Sintaxis
ds.Char(code (uint8))
devuelve: el carácter correspondiente del formato char.
Ejemplo
El ejemplo siguiente genera el código ASCII 65 como el carácter A.
ds.Char(65)
Suma de comprobación
Devuelve un valor de código de redundancia cíclico para una serie.
Sintaxis
ds.Checksum(input (string))
devuelve: el valor de suma de comprobación de una serie de formato que es un código de redundancia cíclica.
Ejemplo
El código siguiente devuelve 57158:
ds.Checksum("This is any arbitrary string value")
CRC32
Utiliza la función CRC32 para devolver un código de redundancia cíclica de 16 bits.
Sintaxis
ds.CRC32(input (string))
devuelve: el resultado del formato decimal.
Ejemplo
El código siguiente devuelve 57158:
ds.CRC32("This is any arbitrary string value")
DateToString
Devuelve la representación de serie de la fecha. La serie de formato predeterminada para las fechas es "%aaaa%mm%dd", por lo que, por ejemplo, la fecha 25-08-2009 se almacena como el número decimal 20090825. No obstante, puede especificar opcionalmente una serie de formato que establece cómo se almacena la fecha en el número decimal. Las series de formato deben especificar un formato que contenga sólo números. Por ejemplo, no puede especificar una serie de formato como "%aaaa-%mm-%dd", porque el carácter de guion (-) no se puede almacenar en un valor decimal empaquetado. Las señales siguientes son válidas para las conversiones a o desde valores decimales:
%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)
Los dígitos literales de 0 a 9 también son válidos.
Sintaxis
ds.DateToString(date (date), [format (string)])
devuelve: la fecha en formato de serie.
Ejemplo
Si mylink.mydate contiene la fecha 18th de agosto de 2009, el código siguiente devuelve la serie "2009-08-18":
ds.DateToString(mylink.mydate)
El ejemplo siguiente genera la fecha contenida en la columna mylink.mydate en una serie con el formato dd:mm:yyyy. Si mylink.mydate contenía la fecha 18th de agosto de 2009, el código siguiente devuelve la serie "18:08:2009":
ds.DateToString(mylink.mydate, "%dd:%mm:%yyyy")
DateToDecimal
Devuelve la fecha dada como un valor decimal empaquetado. La serie de formato predeterminada para las fechas es "%aaaa%mm%dd", por lo que, por ejemplo, la fecha 25-08-2009 se almacena como el número decimal 20090825. No obstante, puede especificar opcionalmente una serie de formato que establece cómo se almacena la fecha en el número decimal. Las series de formato deben especificar un formato que contenga sólo números. Por ejemplo, no puede especificar una serie de formato como "%aaaa-%mm-%dd", porque el carácter de guion (-) no se puede almacenar en un valor decimal empaquetado. Las señales siguientes son válidas para las conversiones a o desde valores decimales:
%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)
Los dígitos literales de 0 a 9 también son válidos.
Sintaxis
ds.DateToDecimal(basedate (date), [format (string)])
devuelve: la fecha en formato de número decimal.
Ejemplo
Si mylink.basedate contiene la fecha 2012-08-18, la siguiente función almacena la fecha como el número decimal 18082012:
ds.DateToDecimal(mylink.basedate, "%dd%mm%yyyy")
Si mylink.basedate contiene la fecha 2012-08-18, la siguiente función almacena la fecha como el número decimal 20120818:
ds.DateToDecimal(mylink.basedate)
DecimalToDate
Devuelve el decimal empaquetado dado como una fecha. Se omiten tanto el signo como la escala del número decimal cuando se convierten en una fecha. La serie de formato predeterminada es "%aaaa%mm%dd", por lo que, por ejemplo, la fecha 25-08-2009 se almacena como el número decimal 20090825. No obstante, puede especificar opcionalmente una serie de formato que establece cómo se almacena la fecha en el número decimal. Las series de formato deben especificar sólo un formato que contenga números. Por ejemplo, no puede especificar una serie de formato como "%aaaa-%mm-%dd", porque el carácter de guion (-) no se puede almacenar en un valor decimal empaquetado. Las señales siguientes son válidas para las conversiones a o desde valores decimales:
%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)
Los dígitos literales de 0 a 9 también son válidos.
Sintaxis
ds.DecimalToDate(basedec (decimal), [format (string)])
devuelve: el número decimal en formato de fecha.
Ejemplo
Si mylink.mydecdata contiene el valor 18082012, la función siguiente devuelve la fecha 2012-08-18:
ds.DecimalToDate(mylink.basedate, "%dd%mm%yyyy")
Si mylink.mydecdata contiene el valor -201208.18, la función siguiente devuelve la fecha 2012-08-18:
ds.DecimalToDate(mylink.basedate)
DecimalToDecimal
Devuelve el decimal dado en representación decimal. El argumento rtype especifica opcionalmente un tipo de redondeo y se establece en uno de los valores siguientes:
ceil: Redondea el campo de origen hacia el infinito positivo. Por ejemplo, 1.4-> 2, -1.6 -> -1.
floor: Redondea el campo de origen hacia el infinito negativo. Por ejemplo, 1.6 -> 1, -1.4-> -2.
round_inf; Redondea o trunca el campo de origen al valor representable más cercano, rompiendo los empates redondeando los valores positivos al infinito positivo y los valores negativos al infinito negativo. Por ejemplo, 1.4 -> 1, 1.5 -> 2, -1.4 -> -1, -1.5 -> -2.
trunc_zero: Descarta los dígitos fraccionarios a la derecha del dígito fraccionario más a la derecha soportado en el destino, independientemente del signo. Por ejemplo, si el destino es un entero, se truncan todos los dígitos fraccionales. Si el destino es otro decimal con una escala menor, redondea o trunca al tamaño de escala del decimal de destino. Por ejemplo, 1.6 -> 1, -1.6 -> -1.
Sintaxis
ds.DecimalToDecimal(decimal (decimal), [rtype (string)])
devuelve: el número decimal resultante.
Ejemplo
Si mylink.mydec contiene el número decimal 2.5345, la función siguiente devuelve el número decimal 2.54:
ds.DecimalToDecimal(mylink.mydec,"ceil")
Si mylink.mydec contiene el número decimal 2.5345, la función siguiente devuelve el número decimal 2.53.
ds.DecimalToDecimal(mylink.mydec,"floor")
Si mylink.mydec contiene el número decimal 2.5345, la función siguiente devuelve el número decimal 2.53.
ds.DecimalToDecimal(mylink.mydec,"trunc_zero")
Si mylink.mydec contiene el número decimal 2.5345, la función siguiente devuelve el número decimal 2.53.
ds.DecimalToDecimal(mylink.mydec,"round_inf")
DecimalToDFloat
Devuelve el decimal especificado en la representación de dfloat. El argumento opcional fix_zero especifica que todos los valores decimales cero se consideran válidos (de forma predeterminada, los números decimales que contienen todos los ceros se tratan como no válidos).
Sintaxis
ds.DecimalToDFloat(decimal (decimal), ["fix_zero"])
devuelve: el número decimal en formato dfloat.
Ejemplos
Si mylink.mydec contiene el número decimal 00000004.00, la función siguiente devuelve el número 4 de dfloat .
ds.DecimalToDFloat(mylink.mydec,"fix_zero")
Si mylink.mydec contiene el número decimal 00012344.00, la función siguiente devuelve el número dfloat 12344.
ds.DecimalToDFloat(mylink.mydec,"fix_zero")
Si mylink.mydec contiene el número decimal 00012344.120, la función siguiente devuelve el dfloat número 12344.12.
ds.DecimalToDFloat(mylink.mydec,"fix_zero")
Si mylink.mydec contiene el número decimal 00012344.120, la función siguiente devuelve el número dfloat 12344.12.
ds.DecimalToDFloat(mylink.mydec)
Si mylink.mydec contiene el número decimal 00012344.000, la función siguiente devuelve el número dfloat 12344.
ds.DecimalToDFloat(mylink.mydec)
DecimalToString
Devuelve el decimal dado como una serie. El argumento fix_zero especifica opcionalmente que todos los valores decimales cero se consideran válidos (de forma predeterminada, los números decimales que contienen todos los ceros se tratan como no válidos). Esto cubre el caso en el que los bits de signo de la representación decimal empaquetada son todos 0 y todos los dígitos de contenido. Esta conversión no se considera válida a menos que fix_zero sea verdadero.
Sintaxis
ds.DecimalToString(decimal (decimal), ["fix_zero"])
devuelve: el número decimal en formato de serie.
Ejemplos
Si mylink.mydec contiene el número decimal 00000004.00, la siguiente función devuelve la serie "4":
ds.DecimalToString(mylink.mydec,"suppress_zero")
Si mylink.mydec contiene el número decimal 00000004.00, la siguiente función devuelve la serie "0000000000000000000000000004.0000000000":
ds.DecimalToString(mylink.mydec,"fix_zero")
Si mylink.mydec contiene el número decimal 00000004.00, la siguiente función devuelve la serie "4":
ds.DecimalToString(mylink.mydec)
DecimalToTime
Devuelve el decimal empaquetado dado como una hora. Opcionalmente, puede especificar una serie de formato que especifique cómo se almacena la hora en el número decimal. La serie de formato predeterminada es "%hh%nn%ss", por lo que, por ejemplo, la hora 14:03:22 se almacena como el número decimal 140322. Las series de formato deben especificar un formato que contenga sólo números. Por ejemplo, no puede especificar una serie de formato como "%hh:%nn:%ss", porque el carácter de dos puntos (:) no se puede almacenar en un valor decimal empaquetado. Las señales siguientes son válidas para las conversiones a o desde valores decimales:
%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).
Los dígitos literales de 0 a 9 también son válidos.
Si el formato especificado incluye microsegundos (por ejemplo, %ss.4), la posición del punto decimal se infiere en el valor decimal. La posición de la coma decimal no tiene que coincidir con la escala especificada del decimal (por ejemplo, escala = 4).
Sintaxis
ds.DecimalToTime(decimal (decimal), [format (string)])
devuelve: el decimal en formato de hora.
Ejemplo
Si mylink.mytimedec contiene el valor decimal 200658, la siguiente función devuelve la hora 20:06:58:
ds.DecimalToTime(mylink.mytimedec)
Si la columna mylink.mytimedec contiene el valor decimal 580620, la función siguiente devuelve la hora 20:06:58:
ds.DecimalToTime(mylink.mytimedec, "%ss%nn%hh")
DecimalToTimestamp
Devuelve el decimal empaquetado dado como una indicación de fecha y hora. Opcionalmente, puede especificar una serie de formato que especifique cómo se almacena la indicación de fecha y hora en el número decimal. La serie de formato predeterminada es "%hh%nn%ss", por lo que, por ejemplo, la indicación de fecha y hora 2009-08-25 14:03:22 se almacena como el número decimal 20090825140322. Las series de formato deben especificar un formato que contenga sólo números. Por ejemplo, no puede especificar una serie de formato como "%aaaa/%mm/%dd%hh: %nn:%ss", porque el carácter de barra inclinada (/) y el carácter de dos puntos (:) no se pueden almacenar en un valor decimal empaquetado. Las señales siguientes son válidas para las conversiones a o desde valores decimales:
%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).
Los dígitos literales de 0 a 9 también son válidos.
Si el formato especificado incluye microsegundos (por ejemplo, %ss.4), la posición del punto decimal se infiere en el valor decimal. La posición de la coma decimal no tiene que coincidir con la escala especificada del decimal (por ejemplo, escala = 4).
Sintaxis
ds.DecimalToTimestamp(decimal (decimal), [format (string)])
devuelve: el decimal en formato de indicación de fecha y hora.
Ejemplo
Si mylink.mytimestampdec contiene el valor 19580818200658, la siguiente función devuelve la indicación de fecha y hora 1958-08-18 20:06:58:
ds.DecimalToTimestamp(mylink.mytimestampdec)
Si link.mytimestampdec contiene el valor decimal 200658220818, la siguiente función devuelve la indicación de fecha y hora 2022-08-18 20:06:58:
ds.DecimalToTimestamp(mylink.mytimestampdec, "%hh%nn%ss%yy%mm%dd")
DFloatToDecimal
Devuelve el número dfloat dado en representación decimal. El argumento rtype especifica opcionalmente un tipo de redondeo y se establece en uno de los valores siguientes:
ceil: Redondea el campo de origen hacia el infinito positivo. Por ejemplo, 1.4-> 2, -1.6 -> -1.
floor: Redondea el campo de origen hacia el infinito negativo. Por ejemplo, 1.6 -> 1, -1.4-> -2.
round_inf; Redondea o trunca el campo de origen al valor representable más cercano, rompiendo los empates redondeando los valores positivos al infinito positivo y los valores negativos al infinito negativo. Por ejemplo, 1.4 -> 1, 1.5 -> 2, -1.4 -> -1, -1.5 -> -2.
trunc_zero: Descarta los dígitos fraccionarios a la derecha del dígito fraccionario más a la derecha soportado en el destino, independientemente del signo. Por ejemplo, si el destino es un entero, se truncan todos los dígitos fraccionales. Si el destino es otro decimal con una escala menor, redondea o trunca al tamaño de escala del decimal de destino. Por ejemplo, 1.6 -> 1, -1.6 -> -1.
Sintaxis
ds.DFloatToDecimal(number (dfloat), [rtype (string)])
devuelve: el decimal en formato dfloat.
Ejemplos
Si mylink.myfloat contiene el número dfloat 2.534, la función siguiente devuelve el número decimal 2.54:
ds.DFloatToDecimal(mylink.mydec,"ceil")
Si mylink.myfloat contiene el número dfloat 2.534, la función siguiente devuelve el número decimal 2.53:
ds.DFloatToDecimal(mylink.mydec,"floor")
Si mylink.myfloat contiene el número dfloat 2.534, la función siguiente devuelve el número decimal 2.53:
ds.DFloatToDecimal(mylink.mydec,"trunc_zero")
Si mylink.myfloat contiene el número dfloat 2.534, la función siguiente devuelve el número decimal 2.53:
ds.DFloatToDecimal(mylink.mydec,"round_inf")
DfloatToStringNoExp
Devuelve el dfloat dado en su representación de serie sin exponente, utilizando la escala especificada.
Sintaxis
ds.DfloatToStringNoExp(number (dfloat), scale (string))
devuelve: el número dfloat en formato de serie.
Ejemplos
Si mylink.myfloat contiene el número dfloat 2.534, la siguiente función devuelve la serie "2.5":
ds.DfloatToStringNoExp(mylink.myfloat, "2")
Dtx
Convierte un entero decimal en hexadecimal.
Sintaxis
ds.Dtx(number (int32), size(int8))
devuelve: el resultado de la serie de formato.
Ejemplo
El siguiente código devuelve "002F":
ds.Dtx(47,4)
EBCDIC
Convierte cada carácter de una expresión de su valor de representación ASCII a su valor de representación EBCDIC.
Sintaxis
ds.Ebcdic(input (string))
devuelve: la serie ASCII convertida a una serie EDBCDII resultante.
Ejemplo
El código siguiente devuelve "193 194 195 64 241 242 243":
ds.Ebcdic("ABC 123")
Iconv
Convierte una serie a un formato de almacenamiento interno.
Sintaxis
ds.Iconv(string (string), code (string))
devuelve: el formato de almacenamiento interno en formato de serie.
Ejemplo
El código siguiente devuelve 10740:
ds.Iconv("27 MAY 97", "D2")
El código siguiente devuelve 10740:
ds.Iconv("1997 5 27", "D YMD")
IntToBool
Convertir entero a tipo bool. Devuelve true para cualquier valor distinto de cero y false para 0.
Sintaxis
ds.IntToBool(integer (int))
devuelve: el valor booleano de true o false.
Ejemplo
El valor de 2 devuelve true.
ds.IntToBool(2)
IsValid
Devuelve si la serie dada es válida para el tipo indicado.
Los tipos válidos son "date", "decimal", "dfloat", "sfloat", "int8", "uint8", "int16", "uint16", "int32", "uint32", "int64","uint64"," serie "," hora "," indicación de fecha y hora ".
Para los tipos de datos de fecha, hora e indicación de fecha y hora, opcionalmente puede especificar una serie de formato. La serie de formato describe el formato que utilizan sus datos de entrada cuando difieren de los formatos predeterminados para la fecha, hora o indicación de fecha y hora. El formato predeterminado para la fecha es "%aaaa-%mm-%dd". El formato predeterminado para la hora es "%hh: %mm:%ss". El formato predeterminado para la indicación de fecha y hora es "%yyyy-%mm-%dd %hh: %mm:%ss". Esta función no registra los avisos.
Sintaxis
ds.IsValid(type (string), teststring (string), [format (string)])
devuelve: un resultado de tipo int8, 1 si la entrada es válida para el tipo dado y de lo contrario 0.
Ejemplo
Si mylink.mystring contiene la serie "1", la función siguiente devuelve el valor 1:
ds.IsValid("int8", mylink.mystring)
Si mylink.mystring contiene la serie "380096.06", la función siguiente devuelve el valor 0:
ds.IsValid("int8", mylink.mystring)
IsValidDate
Devuelve si la serie dada es válida para el tipo de fecha. Esta función registra los avisos.
Sintaxis
ds.IsValidDate(testdate (date))
devuelve: un resultado de tipo int8, 1 si la entrada es válida para el tipo dado y de lo contrario 0.
Si mylink.mydate contiene la fecha 2011-09-13, la siguiente función devuelve el valor 1.
ds.IsValidDate(mylink.mydate)
Si mylink.mydate contiene la serie "380096.06", la función siguiente devuelve el valor 0, porque la serie convertida no es una fecha válida.
ds.IsValidDate(mylink.mydate)
IsValidDecimal
Devuelve si el valor dado es válido para el tipo de decimal. Si allzerosflag se establece en 0, una representación de todo ceros no es válida. El allzerosflag se establece en 0 de forma predeterminada.
Sintaxis
ds.IsValidDecimal(testvalue (decimal), [allzerosflag (uint8)])
devuelve: un resultado de tipo int8, 1 si la entrada es válida para el tipo dado y de lo contrario 0.
Ejemplos
Si mylink.mynum contiene el valor 310007.65, la función siguiente devuelve el valor 1.
ds.IsValidDecimal(mylink.mynum)
IsValidTime
Devuelve si la hora dada es válida para el tipo de hora.
Sintaxis
ds.IsValidTime(testtime (time))
devuelve: un resultado de tipo int8, 1 si la entrada es válida para el tipo dado y de lo contrario 0.
Ejemplos
Si mylink.mytime contiene la hora 23:09:22, la siguiente función devuelve el valor 1:
ds.IsValidTime(mylink.mytime)
IsValidTimestamp
Devuelve si la indicación de fecha y hora dada es válida para el tipo de indicación de fecha y hora.
Sintaxis
ds.IsValidTimestamp(testtimestamp (timestamp))
devuelve: un resultado de tipo int8, 1 si la entrada es válida para el tipo dado y de lo contrario 0.
Ejemplos
Si mylink.mytimestamp contiene la hora 2011-09-13 23:09:22, la siguiente función devuelve el valor 1:
ds.IsValidTimestamp(mylink.mytimestamp)
Oconv
Convierte una expresión a un formato de salida.
Sintaxis
ds.Oconv(expression (string), conversion (string))
devuelve: el resultado a un formato de salida de cadena de formato.
Ejemplo
El código siguiente devuelve 1997-147:
ds.Oconv(10740, "D-YJ")
El código siguiente devuelve 27 MAY 97:
ds.Oconv(10740, "D DMY, [A3,2]")
RawNumAt
Devuelve el valor de entero en el valor de índice especificado en el campo sin formato especificado. El índice comienza en 0.
Sintaxis
ds.RawNumAt(rawfield (string), index (int32))
devuelve: el valor entero en el índice en formato int32.
Ejemplos
Si column mylink.myraw contiene un valor en bruto que se deriva de la serie "hello" (que es "{ 0x68 0x65 0x6C 0x6C 0x6F }"), a continuación, la siguiente función devuelve el entero 104 (el código ASCII para el carácter h):
ds.RawNumAt(mylink.myraw, 0)
Si mylink.myraw contiene un valor en bruto que se deriva de la serie "hello" (que es "{ 0x68 0x65 0x6C 0x6C 0x6F }"), la siguiente función devuelve 0 porque el índice especificado está fuera de rango:
ds.RawNumAt(mylink.myraw, 12)
RawToString
Devuelve el valor sin formato dado como una representación de serie. Debe asegurarse de que el valor de entrada sin formato contiene una secuencia de bytes válidos como caracteres en el juego de caracteres de destino en el que se utiliza la serie de salida.
Por ejemplo, el valor en bruto { 0xE0 0x41 0x42 } no es una secuencia válida de caracteres UTF-8 , ya que se supone que el byte inicial, 0xE0, va seguido de un byte en el rango [0x80..0xBF].
Si se pasa un valor raw ' { xE0 x41 x42 } ' a la función RawToString, podría producirse un error si se accede a la cadena de salida como si estuviera codificada en UTF-8.
Sintaxis
ds.RawToString(rawfield (string))
devuelve: el valor bruto dado como una serie.
Ejemplos
Si mylink.myraw contiene el valor { 0x31 0x31 0x30 0x35 0x32 0x32 0x30 0x39 }, la siguiente función devuelve la serie "11052209".
ds.RawToString(mylink.myraw)
Sec
Genera un valor de código numérico a partir de un carácter ASCII. Opcionalmente, puede especificar el argumento allow8bits para convertir valores ASCII de 8 bits.
Sintaxis
ds.Seq(seq (char))
devuelve: el código numérico de carácter ASCII.
Ejemplos
El ejemplo siguiente genera el carácter A como el código ASCII 65.
ds.Seq("A")
SeqAt
Devuelve el valor de punto de código numérico del carácter en la posición especificada en la serie dada. El índice comienza en 0. Si el índice especificado está fuera de rango, la función devuelve 0.
Sintaxis
ds.SeqAt(basestring (string), index (int32))
devuelve: valor de punto de código numérico del carácter en la posición especificada en la serie dada en formato int32.
Ejemplos
Si mylink.mystring contiene la serie "horse", la función siguiente devuelve el valor 0x6F (es decir, el valor ASCII del carácter o).
ds.SeqAt(mylink.mystring, 1)
StringToBool
Convierte la serie en tipo bool. Devuelve false para una serie vacía, devuelve true para cualquier otro valor.
Sintaxis
ds.StringToBool(string (string))
devuelve: el valor booleano de true o false.
Ejemplo
Una serie vacía devuelve false.
ds.StringToBool("")
StringToDate
Devuelve una fecha de la serie dada en el formato especificado. No tiene que especificar una serie con formato si la serie contiene una fecha con el formato predeterminado aaaa-mm-dd.
Sintaxis
ds.StringToDate(string (string), [format (string)])
devuelve: la serie hasta la fecha en el formato especificado.
Ejemplos
Si mylink.mystring contiene la serie "1958-08-18", la siguiente función devuelve la fecha 1958-08-18.
ds.StringToDate(mylink.mystring)
Si mylink.mystring contiene la serie "18:08:1958", la siguiente función devuelve la fecha 1958-08-18.
ds.StringToDate(mylink.mystring,"%dd:%mm:%yyyy")
StringToDecimal
Devuelve la serie dada como una representación decimal. El argumento rtype especifica opcionalmente un tipo de redondeo y se establece en uno de los valores siguientes:
ceil: Redondea el campo de origen hacia el infinito positivo. Por ejemplo, 1.4-> 2, -1.6 -> -1.
floor: Redondea el campo de origen hacia el infinito negativo. Por ejemplo, 1.6 -> 1, -1.4-> -2.
round_inf; Redondea o trunca el campo de origen al valor representable más cercano, rompiendo los empates redondeando los valores positivos al infinito positivo y los valores negativos al infinito negativo. Por ejemplo, 1.4 -> 1, 1.5 -> 2, -1.4 -> -1, -1.5 -> -2.
trunc_zero: Descarta los dígitos fraccionarios a la derecha del dígito fraccionario más a la derecha soportado en el destino, independientemente del signo. Por ejemplo, si el destino es un entero, se truncan todos los dígitos fraccionales. Si el destino es otro decimal con una escala menor, redondea o trunca al tamaño de escala del decimal de destino. Por ejemplo, 1.6 -> 1, -1.6 -> -1.
Sintaxis
ds.StringToDecimal(string (string), [rtype (string)])
devuelve: la serie en formato decimal.
Ejemplos
Si mylink.mystring contiene la serie "19982.22", la siguiente función devuelve el decimal 19982.22.
ds.StringToDecimal(mylink.mystring)
Si mylink.mystring contiene la serie "19982.2276", la siguiente función devuelve el decimal 19982.23.
ds.StringToDecimal(mylink.mystring,"ceil")
StringToRaw
Devuelve una serie como su valor de código sin formato.
Sintaxis
ds.StringToRaw(string (string))
devuelve: el valor de código sin formato correspondiente de la serie.
Ejemplos
Si mylink.mystring contiene la serie "hello", la función siguiente devuelve el valor "{0x68 0x65 0x6C 0x6C 0x6F}".
ds.StringToRaw(mylink.mystring)
StringToTime
Devuelve una representación de hora de la serie dada.
Sintaxis
ds.StringToTime(string (string), [format (string)])
devuelve: la serie en el valor de hora.
Ejemplos
Si mylink.mystring contiene la serie "20:06:58", la función devuelve la hora 20:06:58.
ds.StringToTime(mylink.mystring)
Si mylink.mystring contiene la serie "20: 6:58", la función devuelve la hora 20:06:58.
ds.StringToTime(mylink.mystring,"%(h,s):%(n,s):%(s,s)")
StringToTimestamp
Devuelve la serie especificada en formato de indicación de la hora.
Sintaxis
ds.StringToTimestamp(string (string), [format (string)])
devuelve: la serie en formato de indicación de fecha y hora.
Ejemplos
Si mylink.mystring contiene la serie "1958-08-08 20:06:58", la función devuelve la indicación de fecha y hora 1958-08-08 20:06:58.
ds.StringToTimestamp(mylink.mystring)
Si mylink.mystring contiene la serie "8/ 8/1958 20: 6:58", la función devuelve la indicación de fecha y hora 1958-08-08 20:06:58.
ds.StringToTimestamp(mylink.mystring, "%(d,s)/%(m,s)/%yyyy%(h,s):%(n,s):%(s,s)")
StringToUstring
Devuelve un ustring de la serie dada, opcionalmente utilizando la correlación especificada (de lo contrario, utiliza el valor predeterminado del proyecto).
Sintaxis
ds.StringToUstring(string (string), [mapname (string)])
devuelve: la serie en formato ustring.
Ejemplos
Si mylink.mystring contiene la serie "11052009", la función siguiente devuelve la serie de caracteres "11052009".
ds.StringToUstring(mylink.mystring)
TimestampToDate
Devuelve una fecha a partir de la indicación de fecha y hora dada.
Sintaxis
ds.TimestampToDate(timestamp (timestamp))
devuelve: la fecha resultante de la indicación de fecha y hora.
Ejemplos
Si mylink.mytimestamp contiene la indicación de fecha y hora 1958-08-18 20:06:58, la siguiente función devuelve la fecha 1958-08-18:
ds.TimestampToDate(mylink.mytimestamp)
TimestampToDecimal
Devuelve la indicación de fecha y hora dada como un decimal empaquetado. La serie de formato predeterminada es " %aaaa%mm%dd%hh%nn%ss". Por ejemplo, la indicación de fecha y hora 2009-08-25 14:03:22 se almacena como número decimal 20090825140322. No obstante, puede especificar opcionalmente una serie de formato que establece cómo se almacena la fecha en el número decimal. Las series de formato deben especificar un formato que contenga sólo números. Por ejemplo, no puede especificar una serie de formato como "%aaaa/%mm/%dd%hh: %nn:%ss", porque el carácter de barra inclinada (/) y el carácter de dos puntos (:) no se pueden almacenar en un valor decimal empaquetado. Las señales siguientes son válidas para las conversiones a o desde valores decimales:
%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).
Los dígitos literales de 0 a 9 también son válidos.
Si el formato especificado incluye microsegundos (por ejemplo, %ss.4), la posición del punto decimal se infiere en el valor decimal. La posición del punto decimal no debe coincidir con la escala especificada del decimal (por ejemplo, escala = 4).
Sintaxis
ds.TimestampToDecimal(timestamp (timestamp), [format (string)])
devuelve: la indicación de fecha y hora resultante en formato decimal.
Ejemplos
Si mylink.mytimestamp contiene la indicación de fecha y hora 1958-08-18 20:06:58, la siguiente función devuelve el valor decimal 19580818200658:
ds.TimestampToDecimal(mylink.mytimestamp)
Si mylink.mytimestamp contiene la indicación de fecha y hora 1958-08-18 20:06:58, la siguiente función devuelve el valor decimal 200658580818:
ds.TimestampToDecimal(mylink.mytimestamp, "%hh%nn%ss%yy%mm%dd")
TimestampToString
Devuelve la indicación de fecha y hora proporcionada como un formato de serie.
Sintaxis
ds.TimestampToString(timestamp (timestamp), [format (string)])
devuelve: la indicación de fecha y hora resultante en formato de serie.
Ejemplos
Si mylink.mytimestamp contiene la indicación de fecha y hora 1958-08-18 20:06:58, la función devuelve la serie "1958-08-18 20:06:58".
ds.TimestampToString(mylink.mytimestamp)
Si mylink.mytimestamp contiene la indicación de fecha y hora 1958-08-18 20:06:58, la función devuelve la serie "1 8/0 8/1 9 5 8 20:06:58":
ds.TimestampToString(mylink.mytimestamp, "%dd/%mm/%yyyy %hh:%nn:%ss")
TimestampToTime
Devuelve la indicación de fecha y hora especificada como formato de hora.
Sintaxis
ds.TimestampToTime(timestamp (timestamp), [format (string)])
devuelve: la indicación de fecha y hora resultante en formato de hora
Ejemplos
Si mylink.mytimestamp contiene la indicación de fecha y hora 1958-08-18 20:06:58, la función devuelve la hora 20:06:58:
ds.TimestampToTime(mylink.mytimestamp)
TimeToString
Devuelve una serie a partir de la hora dada.
Sintaxis
ds.TimeToString(timestamp (timestamp), [format (string)])
devuelve: el resultado en formato de hora.
Ejemplos
Si mylink.mytime contiene la hora 20:06:58, la siguiente función devuelve la serie "20:06:58":
ds.TimeToString(mylink.mytime)
Si mylink.mytime contiene la hora 20:06:58, la siguiente función devuelve la serie "58:06:20":
ds.TimeToString(mylink.mytime, "%ss:%nn:%hh")
TimeToDecimal
Devuelve la hora dada como un decimal empaquetado. La serie de formato predeterminada es " %hh%nn%ss ", por lo que, por ejemplo, la hora 14:03:22 se almacena como el número decimal 140322. No obstante, puede especificar opcionalmente una serie de formato que especifique cómo se almacena la hora en el número decimal. Las series de formato solo pueden especificar un formato que contenga números. Por ejemplo, no puede especificar una serie de formato como "%hh:%nn:%ss", porque el carácter de dos puntos (:) no se puede almacenar en un valor decimal empaquetado. Las señales siguientes son válidas para las conversiones a o desde valores decimales:
%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).
Los dígitos literales de 0 a 9 también son válidos.
Si el formato especificado incluye microsegundos (por ejemplo, %ss.4), la posición del punto decimal se infiere en el valor decimal. La posición del punto decimal no debe coincidir con la escala especificada del decimal (por ejemplo, escala = 4).
Sintaxis
ds.TimeToDecimal(time (time), [format (string)])
devuelve: la hora en formato decimal.
Ejemplos
Si mylink.mytime contiene la hora 20:06:58, la función siguiente devuelve el valor decimal 200658:
ds.TimeToDecimal(mylink.mytime)
Si mylink.mytime contiene la hora 20:06:58, la función siguiente devuelve el valor decimal 580620:
ds.TimeToDecimal(mylink.mytime, "%ss%nn%hh")
UniChar
Genera un único carácter Unicode basado en un valor decimal, en el rango de 0 a 65535.
Sintaxis
ds.UniChar(expression (int32))
devuelve: el resultado de la serie de formato.
Ejemplo
El código siguiente devuelve "õ":
ds.UniChar(0x00F5)
UniSeq
Genera un valor decimal basado en un único carácter Unicode.
Sintaxis
ds.UniSeq(expression (string))
devuelve: el decimal correspondiente al carácter Unicode del formato int32.
Ejemplo
El código siguiente devuelve 195:
ds.UniSeq("ä")
UstringToString
Devuelve una serie de la ustring dada, opcionalmente utilizando la correlación especificada (de lo contrario, utiliza la correlación predeterminada del proyecto).
Sintaxis
ds.UstringToString(string (ustring), [mapname(string)])
devuelve: el resultado en formato de serie.
Ejemplos
Si mylink.myustring contiene la serie de caracteres "11052009", la siguiente función devuelve la serie "11052009":
ds.UstringToString(mylink.myustring)
Xtd
Convierte una serie hexadecimal en decimal.
Sintaxis
ds.Xtd(hexadecimal (string))
devuelve: el valor decimal correspondiente a la serie hexadecimal.
Ejemplo
El código siguiente devuelve 48879:
ds.Xtd("beef")
Int
Devuelve la parte entera de una expresión. Las operaciones aritméticas especificadas se calculan utilizando la precisión completa del sistema. La parte fraccional del valor se trunca, no se redondea y se devuelve el entero que queda.
Sintaxis
ds.Int(expression (dfloat))
devuelve: el valor decimal que se redondea y se convierte al tipo int64.
Ejemplo
El código siguiente devuelve 454:
ds.Int(454.95)
El código siguiente devuelve 2:
ds.Int(2.35)
Funciones de fecha y hora
Utilice estas funciones para las funciones de datos y de tiempo en una expresión.
Las funciones que especifican fechas, horas o indicaciones de fecha y hora en los argumentos utilizan series con formatos específicos:
- Para una fecha, el formato es
%yyyy-%mm-%dd - Para una hora, el formato es
%hh:%nn:%ss. Si se amplía para incluir microsegundos, el formato es%hh:%nn:%ss.xdonde x da el número de segundos decimales que se da a los segundos. - Para una indicación de fecha y hora, el formato es el formato de fecha seguido del formato de hora.
Las funciones que tienen los días de la semana en el argumento toman una serie que especifica el día de la semana. El día se especifica como una abreviatura de tres letras o el nombre completo. Por ejemplo, las series "thu" y "thurday" son ambas válidas.
CurrentDate
Devuelve la fecha en la que se ejecuta el trabajo.
Sintaxis
ds.CurrentDate()
devuelve: la fecha actual en formato de fecha.
Ejemplos
Utilice esta función para obtener la fecha actual.
ds.CurrentDate()
CurrentTime
Devuelve la hora en que se ejecuta el trabajo.
Sintaxis
ds.CurrentTime()
devuelve: la hora actual en formato de hora.
Ejemplos
Utilice esta función para obtener la hora actual.
ds.CurrentTime()
CurrentTimeMS
Devuelve la hora, incluidos los microsegundos, en que se ejecuta el trabajo.
Sintaxis
ds.CurrentTimeMS()
devuelve: la hora actual en formato de hora, incluidos microsegundos.
Ejemplos
Utilice esta función para recuperar la hora actual y generar los datos.
ds.CurrentTimeMS()
CurrentTimestamp
Devuelve una indicación de fecha y hora que indica la fecha y hora en que se ejecuta el trabajo.
Sintaxis
ds.CurrentTimestamp()
devuelve: la indicación de fecha y hora actual en formato de indicación de fecha y hora.
Ejemplos
Utilice esta función para recuperar la indicación de fecha y hora actual a los datos de salida.
ds.CurrentTimestamp()
CurrentTimestampMS
Devuelve la indicación de fecha y hora, incluidos los microsegundos, del momento en que ejecuta el trabajo.
Sintaxis
ds.CurrentTimestampMS()
devuelve: la indicación de fecha y hora actual en formato de indicación de fecha y hora.
Ejemplos
Utilice esta función para recuperar la indicación de fecha y hora actual a los datos de salida.
ds.CurrentTimestampMS()
Fecha
Devuelve un único valor numérico de días transcurridos entre la fecha interna del sistema y el 31 de diciembre de 1967, que es el día 0. Todas las fechas posteriores son números positivos que representan el número de días transcurridos desde el día 0. Todas las fechas anteriores son números negativos que representan el número de días antes del día 0.
Sintaxis
ds.Date()
devuelve: la fecha resultante del formato int.
Ejemplos
Si la fecha actual es el 15 de noviembre de 1967, el código siguiente devuelve -46. Si la fecha actual es el 15 de febrero de 1968, el código siguiente devuelve 46:
ds.Date()
DateFromDaysSince
Devuelve una fecha añadiendo un entero a una fecha de línea base. El entero puede ser negativo para devolver una fecha anterior a la fecha de línea base.
Sintaxis
ds.DateFromDaysSince(number (int32), [baseline_date_object (string)])
devuelve: una fecha añadiendo un entero a una fecha de línea base que especifique el usuario.
Ejemplos
Si mylink.myintcol contiene el entero 18250 y mylink.mydatecol contiene la fecha 1958-08-18, las tres funciones siguientes son equivalentes y devuelven la fecha 2008-08-05:
ds.DateFromDaysSince(18250,"1958-08-18")
ds.DateFromDaysSince(mylink.myintcol,"1958-08-18")
ds.DateFromDaysSince(mylink.myintcol,mylink.mydatecol)
Si ' mylink.mynegintcol ' contiene el entero -1, y ' mylink.mydatecol ' contiene la fecha 1958-08-18, entonces las tres funciones siguientes son equivalentes, y devuelven la fecha 1958-08-17:
ds.DateFromDaysSince(-1,"1958-08-18")
ds.DateFromDaysSince(mylink.mynegintcol,"1958-08-18")
ds.DateFromDaysSince(mylink.mynegintcol,mylink.mydatecol)
DateFromDaysSince2
Devuelve una fecha añadiendo un entero a una fecha de línea base. El entero puede ser negativo para devolver una fecha anterior a la fecha de línea base.
Sintaxis
ds.DateFromDaysSince2(number (int32), [baseline_date_object (date)])
devuelve: una fecha añadiendo un entero a una fecha de línea base que especifique el usuario.
Ejemplos
Si mylink.myint contiene el entero 18250 y mylink.mydate contiene la fecha 1958-08-18, las tres funciones siguientes son equivalentes y devuelven la fecha 2008-08-05:
ds.DateFromDaysSince2(18250,"1958-08-18")
ds.DateFromDaysSince2(mylink.myint,"1958-08-18")
ds.DateFromDaysSince2(mylink.myint, mylink.mydate)
Si ' mylink.mynegint ' contiene el entero -1, y ' mylink.mydate ' contiene la fecha 1958-08-18, entonces las tres funciones siguientes son equivalentes, y devuelven la fecha 1958-08-17:
ds.DateFromDaysSince2(-1,"1958-08-18")
ds.DateFromDaysSince2(mylink.mynegint,"1958-08-18")
ds.DateFromDaysSince2(mylink.mynegint, mylink.mydate)
DateFromComponents
Devuelve una fecha a partir de los años, meses y día del mes especificados como tres valores separados.
Sintaxis
ds.DateFromComponents(years (int32), months (int32), dayofmonth (int32))
devuelve: una sola fecha con los valores especificados.
Ejemplos
Si mylink.year contiene el valor 2010, mylink.month contiene el valor 12 y mylink.dayofmonth contiene el valor 2, las dos funciones siguientes son equivalentes y devuelven la fecha 2010-12-02.
ds.DateFromComponents(2010, 12, 2)
ds.DateFromComponents(mylink.year, mylink.month, mylink.dayofmonth)
DateFromJulianDay
Devuelve una fecha del número de día del calendario juliano.
Sintaxis
ds.DateFromJulianDay(julianday (uint32))
devuelve: la fecha del valor del día del calendario juliano especificado.
Ejemplos
Si mylink.myjul contiene el valor 2454614, las dos funciones siguientes son equivalentes y devuelven la fecha 2008-05-27.
ds.DateFromJulianDay(2454614)
ds.DateFromJulianDay(mylink.myjul)
DateOffsetByComponents
Devuelve la fecha dada, con los desplazamientos aplicados a partir del desplazamiento del año dado, el desplazamiento del mes y el desplazamiento del día del mes, proporcionados como tres valores separados. Los valores de desplazamiento pueden ser positivos, cero o negativos.
Sintaxis
ds.DateOffsetByComponents(basedate (date), year_offset (int32), month_offset (int32), dayofmonth_offset (int32))
returns: El desplazamiento de fecha dado de la fecha de formato.
Ejemplos
Si mylink.basedate contiene 2011-08-18 y mylink.yearos contiene el valor 2, mylink.monthos contiene el valor 0 y mylink.dayofmonthosol contiene el valor 0, las dos funciones siguientes son equivalentes y devuelven la fecha 2013-08-18.
ds.DateOffsetByComponents("2011-08-18", 2, 0, 0)
ds.DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos)
Si ' mylink.basedate ' contiene 2011-08-18 y ' mylink.yearos ' contiene el valor -2, ' mylink.monthos ' contiene el valor 0, y ' mylink.dayofmonthosol ' contiene el valor 0, entonces las dos funciones siguientes son equivalentes, y devuelven la fecha 2009-08-18.
ds.DateOffsetByComponents("2011-08-18", -2, 0, 0)
ds.DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos)
Día
Devuelve el día del mes a partir de la fecha del sistema.
Sintaxis
ds.Day()
devuelve: día del mes en formato int.
Ejemplos
Si la fecha actual es 1967-12-31, el código siguiente devuelve 31.
ds.Day()
DaysSinceFromDate
Toma una fecha dada de tipo fecha y una fecha de origen de tipo serie y devuelve el número de días desde la fecha de origen hasta la fecha dada.
Sintaxis
ds.DaysSinceFromDate(given_date (date), source_date_string (string))
devuelve: la diferencia en días entre las dos fechas dadas de tipo int32.
Ejemplos
Si mylink.mysourcedate contiene la fecha 1958-08-18 y mylink.mygivendate contiene la fecha 2008-08-18, las dos funciones siguientes son equivalentes y devuelven el valor entero 18263.
ds.DaysSinceFromDate(mylink.mygivendate, mylink.mysourcedate)
ds.DaysSinceFromDate("2008-08-18","1958-08-18")
DaysSinceFromDate2
Obtiene una fecha de tipo determinada y una fecha de origen de tipo fecha, y devuelve el número de días desde la fecha de origen hasta la fecha determinada.
Sintaxis
ds.DaysSinceFromDate2(given_date (date), source_date_object (date))
devuelve: la diferencia en días entre las dos fechas dadas en formato int32.
Ejemplos
Si mylink.mysourcedate contiene la fecha 1958-08-18 y mylink.mygivendate contiene la fecha 2008-08-18, las dos funciones siguientes son equivalentes y devuelven el valor entero 18263.
ds.DaysSinceFromDate2(mylink.mygivendate, mylink.mysourcedate)
ds.DaysSinceFromDate2("2008-08-18","1958-08-18")
DaysInMonth
Devuelve el número de días del mes en la fecha base dada.
Sintaxis
ds.DaysInMonth(basedate (date))
devuelve: el número de días del mes en formato int32.
Ejemplos
Si mylink.mysourcedate contiene la fecha 1958-08-18, las dos funciones siguientes son equivalentes y devuelven el valor entero 31.
ds.DaysInMonth(mylink.mysourcedate)
ds.DaysInMonth("1958-08-18")
DaysInYear
Devuelve el número de días del año en la fecha base dada.
Sintaxis
ds.DaysInYear(basedate (date))
devuelve: el número de días del año en formato int32.
Ejemplos
Si mylink.mysourcedate contiene la fecha 2012-08-18, las dos funciones siguientes son equivalentes y devuelven el valor entero 366.
ds.DaysInYear(mylink.mysourcedate)
ds.DaysInYear("2012-08-18")
Si mylink.mysourcedate contiene la fecha 2011-08-18, las dos funciones siguientes son equivalentes y devuelven el valor entero 365.
ds.DaysInYear(mylink.mysourcedate)
ds.DaysInYear("2011-08-18")
DateOffsetByDays
Devuelve el desplazamiento de fecha dado por el número de días proporcionado. El valor de desplazamiento puede ser positivos, cero o negativo.
Sintaxis
ds.DateOffsetByDays(basedate (date), dayoffset (int32))
devuelve: el objeto de fecha con el desplazamiento correspondiente.
Ejemplos
Si mylink.basedate contiene 2011-08-18 y mylink.dayoffset contiene el valor 2, las dos funciones siguientes son equivalentes y devuelven la fecha 2011-08-20.
ds.DateOffsetByDays("2011-08-18", 2)
ds.DateOffsetByDays(mylink.basedate, mylink.dayoffset)
Si mylink.basedate contiene 2011-08-18 y mylink.dayoffset contiene el valor -31, las dos funciones siguientes son equivalentes y devuelven la fecha 2011-07-18.
ds.DateOffsetByDays("2011-08-18", -31)
ds.DateOffsetByDays(mylink.basedate, mylink.dayoffset)
HoursFromTime
Devuelve la parte correspondiente a las horas de una indicación de hora.
Sintaxis
ds.HoursFromTime(time (time))
devuelve: el valor de horas en formato int8.
Ejemplos
Si mylink.mytime contiene la hora 22:30:00, las dos funciones siguientes son equivalentes y devuelven el valor entero 22.
ds.HoursFromTime(mylink.mytime)
ds.HoursFromTime("22:30:00")
JulianDayFromDate
Devuelve el número de día del calendario juliano a partir de la fecha dada.
Sintaxis
ds.JulianDayFromDate(time (time))
devuelve: Devuelve el número de día del calendario juliano en formato int32, de la fecha especificada.
Ejemplos
Si mylink.mydate contiene la fecha 2008-05-27, las dos funciones siguientes son equivalentes y devuelven el valor 2454614.
ds.JulianDayFromDate("2008-05-27")
ds.JulianDayFromDate(mylink.mydate)
MicroSecondsFromTime
Devuelve la parte correspondiente a los microsegundos de una indicación de hora.
Sintaxis
ds.MicroSecondsFromTime(time (time))
devuelve: el valor de microsegundo de la hora, en formato int32.
Ejemplos
Si mylink.mytime contiene la hora 22 :30:00.32, la función siguiente devuelve el valor 320000:
ds.MicroSecondsFromTime(mylink.mytime)
MidnightSecondsFromTime
Devuelve el número de segundos desde la medianoche hasta la hora dada.
Sintaxis
ds.MidnightSecondsFromTime(time (time))
devuelve: el segundo valor desde la medianoche hasta la hora, en formato int8 .
Ejemplos
Si mylink.mytime contiene la hora 00:30:52, las dos funciones siguientes son equivalentes y devuelven el valor 1852:
ds.MidnightSecondsFromTime("00:30:52")
ds.MidnightSecondsFromTime(mylink.mytime)
MinutesFromTime
Devuelve la parte correspondiente a los minutos de una indicación de hora.
Sintaxis
ds.MinutesFromTime(time (time))
devuelve: el valor de minutos de la hora, en formato int8 .
Ejemplos
Si mylink.mytime contiene la hora 22:30:52, las dos funciones siguientes son equivalentes y devuelven el valor 30:
ds.MinutesFromTime("22:30:52")
ds.MinutesFromTime(mylink.mytime)
MonthDayFromDate
Devuelve el día del mes a partir de la fecha dada.
Sintaxis
ds.MonthDayFromDate(date (date))
devuelve: el día del mes a partir de la fecha dada en formato int8 .
Ejemplos
Si mylink.mydate contiene la fecha 2008-08-18, las dos funciones siguientes son equivalentes y devuelven el valor 18:
ds.MonthDayFromDate("2008-08-18")
ds.MonthDayFromDate(mylink.mydate)
MonthFromDate
Devuelve el número del mes a partir de la fecha dada.
Sintaxis
ds.MonthFromDate(date (date))
devuelve: el número del mes con el formato int8.
Ejemplos
Si mylink.mydate contiene la fecha 2008-08-18, las dos funciones siguientes devuelven el valor 8:
ds.MonthFromDate("2008-08-18")
ds.MonthFromDate(mylink.mydate)
WeekdayFromDate
Devuelve el número de día de la semana desde la fecha dada. Puede especificar el día que se considera como el primero de la semana y, si no se especifica, es domingo de forma predeterminada.
Sintaxis
ds.WeekdayFromDate(date (date), [origin_day (string)])
devuelve: el día de la semana desde la fecha especificada en formato int8 .
Ejemplos
Si mylink.mydate contiene la fecha 2008-08-18, las dos funciones siguientes son equivalentes y devuelven el valor 1:
ds.WeekdayFromDate("2008-08-18")
ds.WeekdayFromDate(mylink.mydate)
Si mylink.mydate contiene la fecha 2008-08-18, y mylink.origin_day contiene "saturday", las funciones siguientes son equivalentes y devuelven el valor 2:
ds.WeekdayFromDate("2008-08-18", "saturday")
ds.WeekdayFromDate("2008-08-18", "sat")
ds.WeekdayFromDate(mylink.mydate, mylink.origin_day)
NextWeekdayFromDate
Devuelve la fecha del día de la semana especificado más cercana después de la fecha de origen. El día de la semana se especifica como nombre completo, por ejemplo, thursday, o como una abreviatura de tres letras, por ejemplo, "thu".
Sintaxis
ds.NextWeekdayFromDate(sourcedate (date), day_of_week (string))
devuelve: el día del mes a partir de la fecha especificada.
Ejemplos
Si mylink.mysourcedate contiene la fecha 2008-08-18 y el día de la semana que se especifica es jueves, las dos funciones siguientes son equivalentes y devuelven el valor 2008-08-21:
ds.NextWeekdayFromDate("2008-08-18", "thursday")
ds.NextWeekdayFromDate(mylink.mysourcedate, "thu")
NthWeekdayFromDate
Devuelve la fecha del desplazamiento del día de la semana especificado mediante el número de semanas a partir de la fecha de origen. El día de la semana se especifica con el nombre completo, por ejemplo thursday (jueves) o una abreviatura de tres letras, por ejemplo thu. Los valores de desplazamiento pueden ser positivos, negativos o cero.
Sintaxis
ds.NthWeekdayFromDate(basedate (date), day_of_week (string), week_offset (int32))
devuelve: la fecha del desplazamiento del día de la semana especificado por semanas a partir de la fecha especificada.
Ejemplos
Si mylink.mydate contiene la fecha 2009-08-18 y el jueves se especifica con un desplazamiento de 1, las dos funciones siguientes son equivalentes y devuelven el valor 2009-08-20. Se devuelve la primera aparición de Thursday (jueves). En el ejemplo siguiente, Thursday aparece en la misma semana que en la fecha 2009-08-18. La fecha 2009-08-18 es un martes (Tuesday).
ds.NthWeekdayFromDate("2009-08-18", "thursday", 1)
ds.NthWeekdayFromDate(mylink.mydate, "thu", 1)
Si ' mylink.mydate ' contiene la fecha 2009-08-18 y se especifica jueves con un desplazamiento de -2, las dos funciones siguientes son equivalentes y devuelven el valor 2009-08-06. Se devuelve la aparición de Thursday, es decir pasados dos jueves.
ds.NthWeekdayFromDate("2009-08-18", "thursday", -2)
ds.NthWeekdayFromDate(mylink.mydate, "thu", -2)
PreviousWeekdayFromDate
Devuelve la fecha del día de la semana especificado que es el día más reciente antes de la fecha de origen. El día de la semana se especifica como nombre completo, por ejemplo, thursday, o como una abreviatura de tres letras, por ejemplo, "thu".
Sintaxis
ds.PreviousWeekdayFromDate(sourcedate (date), day_of_week (string))
devuelve: la fecha del día de la semana más reciente a partir de la fecha especificada.
Ejemplos
Si mylink.mysourcedate contiene la fecha 2008-08-18 y se especifica el jueves, las dos funciones siguientes son equivalentes y devuelven el valor 2008-08-14:
ds.PreviousWeekdayFromDate("2008-08-18", "thursday")
ds.PreviousWeekdayFromDate(mylink.mysourcedate, "thu")
SecondsFromTime
Devuelve la segunda parte de un tiempo.
Sintaxis
ds.SecondsFromTime(time (time))
devuelve: el segundo valor de la hora en formato dfloat.
Ejemplos
Si mylink.mytime contiene la hora 22:30:52, las dos funciones siguientes son equivalentes y devuelven el valor 52:
ds.SecondsFromTime("22:30:52")
ds.SecondsFromTime(mylink.mytime)
SecondsSinceFromTimestamp
Devuelve el número de segundos entre dos objetos de indicación de fecha y hora.
Sintaxis
ds.SecondsSinceFromTimestamp(timestamp (timestamp), timestamp_base_string (string))
devuelve: el segundo valor en formato dfloat.
Ejemplos
Si mylink.mytimestamp contiene la indicación de fecha y hora 2008-08-18 22:30:52, y mylink.mytimestamp_base contiene la indicación de fecha y hora 2008-08-19 22:30:52, las dos funciones siguientes son equivalentes y devuelven el valor -86400:
ds.SecondsSinceFromTimestamp("2008-08-18 22:30:52","2008-08-19 22:30:52")
ds.SecondsSinceFromTimestamp(mylink.mytimestamp, mylink.mytimestamp_base)
SecondsSinceFromTimestamp2
Devuelve el número de segundos entre dos objetos de indicación de fecha y hora.
Sintaxis
ds.SecondsSinceFromTimestamp2(timestamp (timestamp), timestamp_base_object (timestamp))
devuelve: el segundo valor en formato dfloat.
Ejemplos
Si mylink.mytimestamp contiene la indicación de fecha y hora 2008-08-18 22:30:52, y mylink.mytimestamp_base contiene la indicación de fecha y hora 2008-08-19 22:30:52, las dos funciones siguientes son equivalentes y devuelven el valor -86400:
ds.SecondsSinceFromTimestamp2("2008-08-18 22:30:52","2008-08-19 22:30:52")
ds.SecondsSinceFromTimestamp2(mylink.mytimestamp, mylink.mytimestamp_base)
Hora
Devuelve un valor de serie que expresa la hora interna del día. La hora interna es el número de segundos que han transcurrido desde la medianoche hasta la milésima de segundo más cercana (hora local).
Sintaxis
ds.Time()
devuelve: la hora resultante de la serie de formato.
Ejemplos
Si la hora actual es 11:17:43:19, el código siguiente devuelve 40663.842:
ds.Time()
TimeDate
Devuelve la hora y la fecha del sistema como una serie con formato.
Sintaxis
ds.TimeDate()
devuelve: la hora y la fecha del sistema en formato de serie.
TimeFromComponents
Devuelve una hora de tipo de fecha de las horas, minutos, segundos y microsegundos dados como int32.
Sintaxis
ds.TimeFromComponents(hours (int32), minutes (int32), seconds (int32), microseconds (int32))
devuelve: la hora del tipo de fecha.
Ejemplos
Si mylink.hourcol contiene el valor 10, mylink.mincol contiene el valor 12, mylink.seccol contiene el valor 2 y mylink.mseccol contiene 0, las dos funciones siguientes son equivalentes y devuelven la hora 10:12:02:
ds.TimeFromComponents(10, 12, 2, 0)
ds.TimeFromComponents(mylink.hourcol, mylink.mincol, mylink.seccol, mylink.mseccol)
TimeFromMidnightSeconds
Devuelve la hora del sistema en formato de hora.
Sintaxis
ds.TimeFromMidnightSeconds(seconds (time))
devuelve: los segundos desde la medianoche en formato de hora.
Ejemplos
Si mylink.mymidnightseconds contiene el valor 240, las dos funciones siguientes son equivalentes y devuelven el valor 00:04:00:
ds.TimeFromMidnightSeconds(240)
ds.TimeFromMidnightSeconds(mylink.mymidnightseconds)
TimeOffsetByComponents
Devuelve la hora con los desplazamientos aplicados a partir de la hora base con desplazamiento de hora, desplazamiento de minuto y desplazamiento de segundo, cada uno de ellos especificado como valores separados. El desplazamiento de segundos puede incluir segundos parciales.
Sintaxis
ds.TimeOffsetByComponents(basetime (time), hour_offset (int32), minute_offset (int32), second_offset (dfloat))
devuelve: el desplazamiento de hora por los valores especificados.
Ejemplos
Si mylink.basetime contiene 14:05:29 y mylink.houros contiene el valor 2, mylink.minos contiene el valor 0, mylink.secos contiene el valor 20, las dos funciones siguientes son equivalentes y devuelven la hora 16:05:49.
ds.TimeOffsetByComponents("14:05:29", 2, 0, 20)
ds.TimeOffsetByComponents(mylink.basetime, mylink.houros, mylink.minos, mylink.secos)
TimeOffsetBySeconds
Devuelve la hora dada, con los desplazamientos aplicados a partir de la hora base con desplazamiento de segundos. El desplazamiento de segundos puede incluir segundos parciales.
Sintaxis
ds.TimeOffsetBySeconds(basetime (time), second_offset (dfloat))
devuelve: el tiempo con desplazamiento de segundos por el valor especificado.
Ejemplos
Si mylink.basetime contiene 14:05:29.30 y mylink.secos contiene el valor 2.5, las dos funciones siguientes son equivalentes y devuelven la hora 14:05:31.
ds.TimeOffsetBySeconds("14:05:29.30", 2.5)
ds.TimeOffsetBySeconds(mylink.basetime, mylink.secos)
TimestampFromDateTime
Devuelve una indicación de fecha y hora a partir de la fecha y hora dadas.
Sintaxis
ds.TimestampFromDateTime(date (date), time (time))
devuelve: la indicación de fecha y hora de la fecha y hora especificadas.
Ejemplos
Si mylink.mydate contiene la fecha 2008-08-18 y mylink.mytime contiene la hora 22:30:52, las dos funciones siguientes son equivalentes y devuelven la indicación de fecha y hora 2008-08-18 22:30:52:
ds.TimestampFromDateTime("2008-08-18","22:30:52")
ds.TimestampFromDateTime(mylink.mydate, mylink.mytime)
TimestampFromSecondsSince
Devuelve una indicación de fecha y hora que se deriva del número de segundos del objeto de indicación de fecha y hora base.
Sintaxis
ds.TimestampFromSecondsSince(seconds (dfloat), [base_timestamp_object (string)])
devuelve: la indicación de fecha y hora que se deriva del valor especificado de segundos.
Ejemplos
Si mylink.myseconds contiene el valor 2563 y mylink.timestamp_base contiene la indicación de fecha y hora 2008-08-18 22:30:52, las dos funciones siguientes son equivalentes y devuelven la indicación de fecha y hora 2008-08-18 23:13:35:
ds.TimestampFromSecondsSince(2563,"2008-08-18 22:30:52")
ds.TimestampFromSecondsSince(mylink.myseconds,mylink.timestamp_base)
TimestampFromSecondsSince2
Devuelve una indicación de fecha y hora que se deriva del número de segundos del objeto de indicación de fecha y hora base.
Sintaxis
ds.TimestampFromSecondsSince2(seconds (dfloat), [base_timestamp_object (timestamp)])
devuelve: la indicación de fecha y hora que se deriva del valor especificado de segundos.
Ejemplos
Si mylink.myseconds contiene el valor 2563 y mylink.timestamp_base contiene la indicación de fecha y hora 2008-08-18 22:30:52, las dos funciones siguientes son equivalentes y devuelven la indicación de fecha y hora 2008-08-18 23:13:35:
ds.TimestampFromSecondsSince2(2563,"2008-08-18 22:30:52")
ds.TimestampFromSecondsSince2(mylink.myseconds, mylink.timestamp_base)
TimestampFromTimet
Devuelve una indicación de fecha y hora del valor de serie time_t de UNIX determinado.
Sintaxis
ds.TimestampFromTimet(timet_string (int32))
devuelve: la indicación de fecha y hora que se deriva del valor especificado de segundos.
Ejemplos
Si mylink.mytimet contiene el valor 1234567890, las dos funciones siguientes son equivalentes y devuelven la indicación de fecha y hora 2009-02-13 23:31:30:
ds.TimestampFromTimet(1234567890)
ds.TimestampFromTimet(mylink.mytimet)
TimestampFromTime2
Devuelve una indicación de fecha y hora a partir de los objetos de indicación de fecha y hora especificados. El valor del objeto de hora sobrescribe el valor de hora del objeto de indicación de fecha y hora para que solo se utilice la parte de fecha de la indicación de fecha y hora.
Sintaxis
ds.TimestampFromTime2(time (time), timestamp (timestamp))
devuelve: la indicación de fecha y hora de los objetos de hora e indicación de fecha y hora especificados.
Ejemplos
Si mylink.mytime contiene la hora 12:03:22 y mylink.mytimestamp contiene la indicación de fecha y hora 2008-08-18 22:30:52, las dos funciones siguientes son equivalentes y devuelven la indicación de fecha y 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
Devuelve la indicación de fecha y hora, con desplazamientos aplicados desde la indicación de fecha y hora base con desplazamiento de año, desplazamiento de mes, desplazamiento de día, desplazamiento de hora, desplazamiento de minuto y desplazamiento de segundo, cada uno dado como valor separado. El desplazamiento de segundos puede incluir microsegundos.
Sintaxis
ds.TimestampOffsetByComponents(basetimestamp (timestamp), year_offset (int32), month_offset (int32), dayofmonth_offset (int32), hour_offset (int32), minute_offset (int32), second_offset (dfloat))
devuelve: el desplazamiento de indicación de fecha y hora por los valores especificados
Ejemplos
Si ' mylink.basetimestamp ' contiene 2009-08-18 14:05:29 y ' mylink.yearos ' contiene 0, ' mylink.monthos ' contiene el valor 2, ' mylink.dayos ' contiene el valor -4, ' mylink.houros ' contiene el valor 2, ' mylink.minos ' contiene el valor 0, ' mylink.secos ' contiene el valor 20, entonces las dos funciones siguientes son equivalentes, y devuelven la marca de tiempo 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
Devuelve la indicación de fecha y hora con desplazamientos aplicados desde la indicación de fecha y hora base con desplazamiento de segundos. El desplazamiento de segundos puede incluir microsegundos.
Sintaxis
ds.TimestampOffsetBySeconds(basetimestamp (timestamp), second_offset (dfloat))
devuelve: el desplazamiento de indicación de fecha y hora por los valores especificados en formato de indicación de fecha y hora.
Ejemplos
Si mylink.basetimestamp contiene 2009-08-18 14:05:29 y mylink.secos contiene el valor 32760, las dos funciones siguientes son equivalentes y devuelven la indicación de fecha y hora 2009-08-18 23:11:29:
ds.TimestampOffsetBySeconds("2009-08-18 14:05:29", 32760)
ds.TimestampOffsetBySeconds(mylink.basetimestamp, mylink.secos)
TimetFromTimestamp
Devuelve el valor time_t de UNIX de la indicación de fecha y hora proporcionada.
Sintaxis
ds.TimetFromTimestamp(timestamp (timestamp))
devuelve: el UNIX time_t por indicación de fecha y hora determinada en formato int32 .
Ejemplos
Si mylink.mytimestamp contiene el valor 2009-02-13 23:31:30, las dos funciones siguientes son equivalentes y devuelven el valor 1234567890:
ds.TimetFromTimestamp("2009-02-13 23:31:30")
ds.TimetFromTimestamp(mylink.mytimestamp)
YeardayFromDate
Devuelve el número de día del año a partir de la fecha dada.
Sintaxis
ds.YeardayFromDate(date (date))
devuelve: el número de día en formato int16.
Ejemplos
Si mylink.mydate contiene la fecha 2008-08-18, las dos funciones siguientes son equivalentes y devuelven el valor 231:
ds.YeardayFromDate("2008-08-18")
ds.YeardayFromDate(mylink.mydate)
YearFromDate
Devuelve el año a partir de la fecha dada.
Sintaxis
ds.YearFromDate(date (date))
devuelve: el número de año en formato int16.
Ejemplos
Si mylink.mydate contiene la fecha 2008-08-18, las dos funciones siguientes son equivalentes y devuelven el valor 2008:
ds.YearFromDate("2008-08-18")
ds.YearFromDate(mylink.mydate)
YearweekFromDate
Devuelve el número de semana del año, a partir de la fecha dada.
Sintaxis
ds.YearweekFromDate(date (date))
devuelve: el número de semana en formato int16.
Ejemplos
Si mylink.mydate contiene la fecha 2008-08-18, las dos funciones siguientes son equivalentes y devuelven el valor 33:
ds.YearweekFromDate("2008-08-18")
ds.YearweekFromDate(mylink.mydate)
Mes
Devuelve el mes actual.
Sintaxis
ds.Month()
devuelve: el mes actual.
Ejemplos
El código siguiente devuelve el mes actual en formato int.
ds.Month()
Año
Devuelve el año actual.
Sintaxis
ds.Year()
devuelve: el año actual en formato int.
Ejemplos
El código siguiente devuelve el año actual.
ds.Year()
FUNCIONES DE OPERADOR
Las funciones de operador comparan dos objetos y devuelven un valor booleano (true o false):
Igual a
Compara si dos objetos son iguales.
Sintaxis
ds.EQ(object1 (any), object2 (any))
devuelve: true si el valor del objeto es igual, false en caso contrario.
Ejemplos
Las expresiones siguientes devuelven true:
ds.EQ(null,null)
ds.EQ(true,true)
ds.EQ("1",1)
ds.EQ("1",1.0)
Las expresiones siguientes devuelven false:
ds.EQ(1,null)
ds.EQ(false,true)
ds.EQ("a","b")
No es igual que
Compara si dos objetos no son iguales.
Sintaxis
ds.NE(object1 (any), object2 (any))
devuelve: true si el valor del objeto no es igual, false en caso contrario.
Ejemplos
Las expresiones siguientes devuelven true:
ds.NE(1,null)
ds.NE(true,false)
ds.NE(false,true)
ds.NE("a","b")
Las expresiones siguientes devuelven false:
ds.NE(null,null)
ds.NE(true,true)
ds.NE(false,false)
ds.NE("a","a")
Menor que
Toma dos objetos como parámetros y devuelve true si el primer objeto es menor que el segundo.
Sintaxis
ds.LT(object1 (any), object2 (any))
devuelve: true si el primer objeto es menor que el segundo, de lo contrario, devuelve false.
Ejemplos
Las expresiones siguientes devuelven true:
ds.LT("a","b")
Las expresiones siguientes devuelven false:
ds.LT("a","a")
ds.LT("a","b")
ds.LT("202310071855","20380727")
Mayor que
Toma dos objetos como parámetros y devuelve true si el primer objeto es mayor que el segundo.
Sintaxis
ds.GT(object1 (any), object2 (any))
devuelve: true si el primer objeto es mayor que el segundo, false en caso contrario.
Ejemplos
Las expresiones siguientes devuelven true:
ds.GT("b","a")
Las expresiones siguientes devuelven false:
ds.GT("a","a")
ds.GT("5.12","5.123")
Mayor o igual que
Toma dos objetos como parámetros y devuelve true si el primer objeto es mayor o igual que el segundo.
Sintaxis
ds.GE(object1 (any), object2 (any))
devuelve: true si el primer objeto es mayor o igual que el segundo, false en caso contrario.
Ejemplos
Las expresiones siguientes devuelven true:
ds.GE(2, 1)
ds.GE("a","a")
Menor o igual que
Toma dos objetos como parámetros y devuelve true si el primer objeto es menor o igual que el segundo.
Sintaxis
ds.LE(object1 (any), object2 (any))
devuelve: true si el primer objeto es menor o igual que el segundo, false en caso contrario.
Ejemplos
Las expresiones siguientes devuelven true:
ds.GE(1, 2)
ds.LE("a","a") == true
Funciones lógicas
Las funciones lógicas realizan operaciones de bits.
BitAnd
Devuelve el AND bit a bit de los dos argumentos enteros.
Sintaxis
ds.BitAnd(number1 (uint64), number2 (uint64))
devuelve: el AND bit a bit en formato uint64.
Ejemplos
Si mylink.mynumber1 contiene el número 352 y mylink.mynumber2 contiene el número 400, las dos funciones siguientes son equivalentes y devuelven el valor 256:
ds.BitAnd(352,400)
ds.BitAnd(mylink.mynumber1, mylink.mynumber2)
BitCompress
Devuelve el entero que se ha creado a partir del argumento de serie y que contiene una representación binaria de "1"s y "0"s.
Sintaxis
ds.BitCompress(string (string))
devuelve: el número resultante representado por binarios con el formato uint64.
Ejemplos
Si mylink.mynumber1 contiene la serie "0101100000", las dos funciones siguientes devuelven el número 352.
ds.BitCompress("0101100000")
ds.BitCompress(mylink.mynumber)
BitExpand
Devuelve una serie que contiene la representación binaria en "1"s y" 0"s del entero dado.
Sintaxis
ds.BitExpand(number (uint64))
devuelve: una serie que contiene la representación binaria del entero.
Ejemplos
Si mylink.mynumber1 contiene el número 352, las dos funciones siguientes son equivalentes y devuelven la serie "101100000".
ds.BitExpand(352)
ds.BitExpand(mylink.mynumber)
BitOr
Devuelve el OR bit a bit de los dos argumentos enteros.
Sintaxis
ds.BitOr(number1 (uint64), number2 (uint64))
devuelve: el OR bit a bit de los dos argumentos enteros.
Ejemplos
Si mylink.mynumber1 contiene el número 352 y mylink.mynumber2 contiene el número 400, las dos funciones siguientes son equivalentes y devuelven el valor 496:
ds.BitOr(352,400)
ds.BitOr(mylink.mynumber1, mylink.mynumber2)
BitXOr
Devuelve el Exclusive OR bit a bit de los dos argumentos enteros.
Sintaxis
ds.BitXOr(number1 (uint64), number2 (uint64))
devuelve: el Exclusive OR en formato uint64.
Ejemplos
Si mylink.mynumber1 contiene el número 352 y mylink.mynumber2 contiene el número 400, las dos funciones siguientes son equivalentes y devuelven el valor 240:
ds.BitXOr(352,400)
ds.BitXOr(mylink.mynumber1, mylink.mynumber2)
No
Devuelve el complemento del valor lógico de una expresión. Si el valor de la expresión es true, la función Not devuelve un valor de false (0). Si el valor de la expresión es false, la función NOT devuelve un valor de true (1). Una expresión numérica que se evalúa como 0 tiene el valor lógico falso. Una expresión numérica que se evalúa como cualquier otro valor, distinto del valor nulo, tiene el valor lógico verdadero. Una serie vacía tiene el valor lógico falso. Todas las demás expresiones de serie, incluidas las series que contienen una serie vacía, espacios o el número 0 y espacios, tienen el valor lógico verdadero.
Sintaxis
ds.Not()
devuelve: el valor de complement en formato int8.
Ejemplos
Si mylink.myexpression contiene la expresión 5-5, las dos funciones siguientes son equivalentes y devuelven el valor 1:
ds.Not(5-5)
ds.Not(mylink.myexpression)
Si mylink.myexpression contiene la expresión 5+5, las dos funciones siguientes son equivalentes y devuelven el valor 0:
ds.Not(5+5)
ds.Not(mylink.myexpression)
SetBit
Devuelve un entero con bits específicos establecidos en un estado específico, donde origfield es el valor de entrada sobre el que realizar la acción, bitlist es una serie que contiene una lista de números de bits separados por comas cuyo estado se debe establecer y bitstate es 1 o 0, lo que indica el estado en el que establecer esos bits.
Sintaxis
ds.SetBit(origfield (uint64), bitlist (string), bitstate (uint8))
devuelve: el número con los bits establecidos en el estado especificado en el forma uinnt64.
Ejemplos
Si mylink.origfield contiene el número 352, mylink.bitlist contiene la lista "2,4,8" y mylink.bitstate contiene el valor 1, las dos funciones siguientes son equivalentes y devuelven el valor 494:
ds.SetBit(356,"2,4,8",1)
ds.SetBit(mylink.origfield, mylink.bitlist, mylink.bitstate)
Sí
Devuelve el valor verdadero de 1.
Sintaxis
ds.True()
devuelve: el entero 1.
Ejemplos
El código siguiente devuelve 1:
ds.True()
No
Devuelve el valor falso de 0.
Sintaxis
ds.False()
devuelve: el entero 0.
Ejemplos
El código siguiente devuelve 0:
ds.False()
Funciones mathmaticales
Las funciones matemáticas realizan operaciones matemáticas.
Abs
Devuelve el valor absoluto de cualquier expresión numérica. El valor absoluto de una expresión es su magnitud sin signo.
Sintaxis
ds.Abs(numeric_expression (int32))
devuelve: el valor absoluto de la expresión numérica en formato dfloat.
Ejemplos
Si mylink.number1 contiene el número 12 y mylink.number2 contiene el número 34, las dos funciones siguientes son equivalentes y devuelven el número 22:
ds.Abs(12-34)
ds.Abs(mylink.mynumber1-mylink.mynumber2)
Si mylink.number1 contiene el número 34 y mylink.number2 contiene el número 12, las dos funciones siguientes son equivalentes y devuelven el número 22:
ds.Abs(34-12)
ds.Abs(mylink.mynumber1-mylink.mynumber2)
Acos
Calcula el arco coseno trigonométrico de una expresión. La expresión debe ser un valor numérico. El resultado se expresa en radianes.
Sintaxis
ds.Acos(numeric_expression (dfloat))
devuelve: el radian resultante en formato dfloat.
Ejemplos
Si mylink.number contiene el número 0.707106781, las dos funciones siguientes son equivalentes y devuelven el valor 0.7854:
ds.Acos(0.707106781)
ds.Acos(mylink.mynumber)
ACOS
Devuelve el arco coseno trigonométrico de la expresión. La entrada debe ser un valor numérico. El resultado se expresa en grados.
Sintaxis
ds.ACOS(expression (float64))
devuelve: el ángulo en grados, con formato float64 .
Ejemplos
El código siguiente devuelve el valor 45:
ds.ACOS(0.707106781)
Asin
Calcula el arco seno trigonométrico de una expresión. La expresión debe ser un valor numérico. El resultado se expresa en radianes.
Sintaxis
ds.Asin(numeric_expression (dfloat))
devuelve: el resultado del radian en formato dfloat.
Ejemplos
Si mylink.number contiene el número 0.707106781, las dos funciones siguientes son equivalentes y devuelven el valor 0.7854:
ds.Asin(0.707106781)
ds.Asin(mylink.mynumber)
ASENO
Devuelve el seno trigonométrico de una expresión. La entrada es el ángulo que se expresa en grados.
Sintaxis
ds.ASIN(expression(float64))
devuelve: el ángulo en grados, con formato float64 .
Ejemplos
El código siguiente devuelve el valor 45:
ds.ASIN(0.707106781)
Atan
Calcula el arco tangente trigonométrico de una expresión. La expresión debe ser un valor numérico. El resultado se expresa en radianes.
Sintaxis
ds.Atan(numeric_expression (dfloat))
devuelve: el resultado del radian en formato dfloat.
Ejemplos
Si mylink.number contiene el número 135, las dos funciones siguientes son equivalentes y devuelven el valor 1.5634, que es el ángulo que tiene un arco tangente de 135:
ds.Atan(135)
ds.Atan(mylink.mynumber)
ATAN
Devuelve el arco tangente trigonométrico de la expresión. La entrada debe ser un valor numérico. El resultado se expresa en grados.
Sintaxis
ds.ATAN(expression(float64))
devuelve: el ángulo en grados, en formato dfloat.
Ejemplos
El código siguiente devuelve el valor 45:
ds.ATAN(1)
Atan2
Calcula el arco-tangente trigonométrico de las dos entradas utilizando los signos de las dos entradas para determinar el cuadrante del resultado. Las entradas deben ser valores numéricos. El resultado se expresa en radianes.
Sintaxis
ds.Atan2(numeric_expression (dfloat, dfloat))
devuelve: el resultado del radian en formato dfloat.
Ejemplos
Si mylink.number1 contiene el número 10.0 y mylink.number2 contiene el número -10.0, las dos funciones siguientes son equivalentes y devuelven el valor 2.3562:
ds.Atan2(10.0, -10.0)
ds.Atan2(mylink.mynumber1, mylink.mynumber2)
Ceil
Calcula el valor entero más pequeño mayor o igual al valor decimal dado.
Sintaxis
ds.Ceil(number (dfloat))
devuelve: el valor de entero más pequeño en int32.
Ejemplos
Si mylink.number contiene el número 2355.66, las dos funciones siguientes son equivalentes y devuelven el valor 2356:
ds.Ceil(2355.66)
ds.Ceil(mylink.mynumber)
Cos
Calcula el coseno trigonométrico de una expresión. La expresión debe ser un valor numérico. La expresión debe generar un valor numérico que sea el ángulo en radianes.
Sintaxis
ds.Cos(radians (dfloat))
devuelve: el ángulo en radianes, de formato dfloat.
Ejemplos
Si mylink.number contiene el número 0.785398, las dos funciones siguientes son equivalentes y devuelven el valor 0.7071:
ds.Cos(0.785398)
ds.Cos(mylink.mynumber)
CDV
Devuelve el coseno trigonométrico de un ángulo. La expresión es un ángulo como un valor en grados.
Sintaxis
ds.COS(expression(float64))
devuelve: el ángulo en grados, con formato float64 .
Ejemplos
El código siguiente devuelve el valor 0.7071:
ds.COS(45)
Cosh
Calcula el coseno hiperbólico de una expresión. La expresión debe ser un valor numérico.
Sintaxis
ds.Cosh(number (dfloat))
devuelve: el coseno resultante en formato dfloat.
Ejemplos
Si mylink.number contiene el número 2, las dos funciones siguientes son equivalentes y devuelven el valor 3.7622:
ds.Cosh(2)
ds.Cosh(mylink.mynumber)
Div
Calcula el coseno hiperbólico de una expresión. La expresión debe ser un valor numérico.
Sintaxis
ds.Div(dividend (dfloat), divisor (dfloat))
devuelve: el coseno resultante en formato dfloat.
Ejemplos
Si mylink.dividend contiene el número 100, y mylink.divisor contiene el número 25, las dos funciones siguientes son equivalentes y devuelven el valor 4:
ds.Div(100,25)
ds.Div(mylink.dividend, mylink.divisor)
Exp
Calcula el resultado de base e elevado a la potencia indicada por el valor de la expresión. El valor de e es aproximadamente de 2.71828. La expresión se debe evaluar en un valor numérico.
Sintaxis
ds.Exp(number (dfloat))
devuelve: el e resultante elevado a la potencia especificada en formato dfloat.
Ejemplos
Si mylink.number contiene el número 5, las dos funciones siguientes son equivalentes y devuelven el valor 54.5982:
ds.Exp(5-1)
ds.Exp(mylink.number-1)
Fabs
Calcula el valor absoluto del valor flotante dado.
Sintaxis
ds.Fabs(number (dfloat))
devuelve: el valor absoluto del número flotante.
Ejemplos
Si mylink.number contiene el número -26.53, las dos funciones siguientes son equivalentes y devuelven el valor 26.53:
ds.Fabs(-26.53)
ds.Fabs(mylink.number)
Límite inferior
Calcula el valor entero más grande menor o igual al valor decimal dado.
Sintaxis
ds.Floor(number (dfloat))
devuelve: el entero más grande menor o igual que el valor decimal en el formato int32 .
Ejemplos
Si mylink.number contiene el número 203.25, las dos funciones siguientes son equivalentes y devuelven el valor 203:
ds.Floor(203.25)
ds.Floor(mylink.number)
Ldexp
Devuelve un valor dfloat de la multiplicación de la mantisa por 2, elevado a la potencia del exponente.
Sintaxis
ds.Ldexp(mantissa (dfloat), exponent (int32))
devuelve: la mantissa resultante en formato dfloat.
Ejemplos
Si mylink.mantissa contiene el número 2 y mylink.exponent contiene el número 3, las dos funciones siguientes son equivalentes y devuelven el valor 16:
ds.Ldexp(2,3)
ds.Ldexp(mylink.mantissa, mylink.exponent)
Llabs
Calcula el valor absoluto del valor de entero dado.
Sintaxis
ds.Llabs(number (integer))
devuelve: el valor absoluto del entero especificado como un entero sin signo.
Ejemplos
Si mylink.number contiene el número -26, las dos funciones siguientes son equivalentes y devuelven el valor 26.
ds.Llabs(-26)
ds.Llabs(mylink.number)
Li
Calcula el logaritmo natural de una expresión en la base e. El valor de e es aproximadamente de 2.71828. La expresión se debe evaluar en un valor numérico mayor que 0.
Sintaxis
ds.Ln(number (dfloat))
devuelve: el logaritmo resultante de la expresión en base e.
Ejemplos
Si mylink.number contiene el número 6, las dos funciones siguientes son equivalentes y devuelven el valor 1.7918:
ds.Ln(6)
ds.Ln(mylink.number)
Log10
Devuelve el logaritmo en la base 10 del valor dado.
Sintaxis
ds.Log10(number (dfloat))
devuelve: el logaritmo de base 10 resultante en formato dfloat.
Ejemplos
Si mylink.number contiene el número 6, las dos funciones siguientes son equivalentes y devuelven el valor 1.7782:
ds.Log10(6)
ds.Log10(mylink.number)
Máx
Devuelve el mayor de los dos valores del argumento.
Sintaxis
ds.Max(number1 (int32), number2(int32))
devuelve: el mayor de los dos enteros en formato int32 .
Ejemplos
Si mylink.number1 contiene el número 6 y mylink.number1 contiene el número 101, las dos funciones siguientes son equivalentes y devuelven el valor 101:
ds.Max(6,101)
ds.Max(mylink.number1, mylink.number2)
Mín
Devuelve el mínimo de los dos valores de argumento.
Sintaxis
ds.Min(number1 (int32), number2(int32))
devuelve: el menor de los dos enteros.
Ejemplos
Si mylink.number1 contiene el número 6 y mylink.number1 contiene el número 101, las dos funciones siguientes son equivalentes y devuelven el valor 6:
ds.Min(6,101)
ds.Min(mylink.number1, mylink.number2)
Mod
Calcula el módulo (el restante) de dos expresiones (dividendo, divisor).
Sintaxis
ds.Mod(dividend (int32), divisor (int32))
devuelve: el módulo resultante en formato int32.
Ejemplos
Si mylink.dividend contiene el número 115 y mylink.divisor contiene el número 25, las dos funciones siguientes son equivalentes y devuelven el valor 15:
ds.Mod(115,25)
ds.Mod(mylink.dividend, mylink.divisor)
Neg
Negación de un número.
Sintaxis
ds.Neg(number (dfloat))
devuelve: el número negado resultante en formato dfloat.
Ejemplos
Si mylink.number contiene el número 123, las dos funciones siguientes son equivalentes y devuelven el valor -123:
ds.Neg(123)
ds.Neg(mylink.number)
Pwr
Calcula el valor de una expresión cuando se eleva a una potencia especificada (expresión, potencia).
Sintaxis
ds.Pwr(expression (dfloat), power (dfloat))
devuelve: el número resultante que se eleva a la potencia especificada en formato dfloat.
Ejemplos
Si mylink.expression contiene el número 2 y mylink.power contiene el número 3, las dos funciones siguientes son equivalentes y devuelven el valor 8:
ds.Pwr(2,3)
ds.Pwr(mylink.expression, mylink.power)
Rand
Devuelve un entero pseudoaleatorio entre 0 y 232-1.
Sintaxis
ds.Rand()
devuelve: el entero aleatorio resultante en formato uint32.
Ejemplos
Utilice esta función para generar un número pseudoaleatorio:
ds.Rand()
Aleatoria
Devuelve un entero pseudoaleatorio entre 0 y 232-1.
Sintaxis
ds.Random()
devuelve: el entero aleatorio resultante en formato uint32.
Ejemplos
Utilice esta función para generar un número aleatorio:
ds.Random()
Rnd
Genera cualquier entero aleatorio positivo o negativo o 0. Toma el número total de enteros como entrada, incluido 0, del que se puede seleccionar el número aleatorio. Es decir, si n es el valor de numeric_expression, el número aleatorio se genera a partir de los números del 0 al (n-1).
Sintaxis
ds.Rnd(numeric_expression (int))
devuelve: un número aleatorio de 0 a (numeric_expression - 1) en formato int.
Ejemplos
El código siguiente devuelve un número aleatorio de 0-19.
ds.Rnd(20)
Sin
Calcula el seno trigonométrico de una expresión. La expresión debe ser un valor numérico. La expresión debe generar un valor numérico que sea el ángulo en radianes.
Sintaxis
ds.Sin(radians (dfloat))
devuelve: el ángulo resultante en formato dfloat.
Ejemplos
Si mylink.number contiene el número 0.785398, las dos funciones siguientes son equivalentes y devuelven el valor 0.7071:
ds.Sin(0.785398)
ds.Sin(mylink.mynumber)
SENO
Devuelve el seno trigonométrico de una expresión. La entrada es el ángulo que se expresa en grados.
Sintaxis
ds.SIN(expression(float64))
devuelve: el ángulo en grados, en formato dfloat.
Ejemplos
El código siguiente devuelve el valor 0.7071:
ds.SIN(45)
Sinh
Calcula el seno hiperbólico de una expresión. La expresión debe ser un valor numérico.
Sintaxis
ds.Sinh(number (dfloat))
devuelve: el seno resultante en formato dfloat.
Ejemplos
Si mylink.number contiene el número 2, las dos funciones siguientes son equivalentes y devuelven el valor 3.6269:
ds.Sinh(2)
ds.Sinh(mylink.mynumber)
Sqrt
Calcula la raíz cuadrada de un número.
Sintaxis
ds.Sqrt(number (dfloat))
devuelve: la raíz cuadrada resultante del número en formato dfloat.
Ejemplos
Si mylink.number contiene el número 450, las dos funciones siguientes son equivalentes y devuelven el valor 21.2132:
ds.Sqrt(450)
ds.Sqrt(mylink.mynumber)
Tan
Calcula la tangente trigonométrica de una expresión. La expresión debe generar un valor numérico que sea el ángulo en radianes.
Sintaxis
ds.Tan(radians (dfloat))
devuelve: la tangente resultante en formato dfloat.
Ejemplos
Si mylink.number contiene el número 0.7853981, las dos funciones siguientes son equivalentes y devuelven el valor 1:
ds.Tan(0.7853981)
ds.Tan(mylink.mynumber)
TAN
Devuelve la función TAN para devolver la tangente trigonométrica de la entrada. La entrada representa un ángulo expresado en grados.
Sintaxis
ds.TAN(expression(float64))
devuelve: el ángulo en grados, con formato float64 .
Ejemplos
El código siguiente devuelve el valor 1:
ds.TAN(45)
ATAN
Devuelve el arco tangente trigonométrico de la expresión. La entrada debe ser un valor numérico. El resultado se expresa en grados.
Sintaxis
ds.ATAN(expression(float64))
devuelve: el ángulo en grados, con formato float64 .
Ejemplos
El código siguiente devuelve el valor 45:
ds.ATAN(1)
Tanh
Calcula la tangente hiperbólica de una expresión. La expresión debe ser un valor numérico.
Sintaxis
ds.Tanh(number (dfloat))
devuelve: la tangente resultante en formato dfloat.
Ejemplos
Si mylink.number contiene el número 2, las dos funciones siguientes son equivalentes y devuelven el valor 0.964028:
ds.Tanh(2)
ds.Tanh(mylink.mynumber)
Funciones de números
Utilice las funciones de número para extraer la mantissa de un número de coma flotante o decimal. La categoría Número del editor de expresiones también contiene las funciones de conversión de tipos, que puede utilizar para convertir números como tipos de datos dobles, flotantes o enteros.
Las funciones de transformador AsDouble(), AsFloat()y AsInteger() se comportan de forma diferente que otras funciones de conversión de datos de transformador cuando se utilizan en derivaciones donde el resultado es una serie. El comportamiento se debe a que el compilador de transformadores no convierte los resultados de la función para estas funciones en una serie.
AsDouble
Tratar el número dado como doble.
Sintaxis
ds.AsDouble(number (int, float and so on))
devuelve: el número en formato doble.
Ejemplos
En la expresión siguiente, la entrada mynumber contiene un entero, pero la función genera un doble. Si mylink.mynumber contiene el valor 56, las dos funciones siguientes son equivalentes y devuelven el valor 12.963:
ds.AsDouble(56/4.32)
ds.AsDouble(mylink.mynumber/4.32)
AsFloat
Tratar el número dado como flotante.
Sintaxis
ds.AsFloat(number (int, double and so on))
devuelve: el número en formato flotante.
Ejemplos
En la expresión siguiente, la entrada mynumber contiene un entero, pero la función genera un flotante. Si mylink.mynumber contiene el valor 56, las dos funciones siguientes son equivalentes y devuelven el valor 12.963:
ds.AsFloat(56/4.32)
ds.AsFloat(mylink.mynumber/4.32)
AsInteger
Tratar el número dado como un entero. Pero hay una diferencia en el comportamiento cuando un decimal se asigna a un entero frente a un flotante o un doble que se asigna a un entero. Si la conversión es de flotante o de doble a un entero, es una asignación simple a un entero. En el caso de AsInteger()decimal, la función se inicia y redondea la salida hacia el valor más cercano.
Sintaxis
ds.AsInteger(number (float, double and so on))
devuelve: el número en formato de entero.
Ejemplos
En la expresión siguiente, el valor de entrada 12.962963 tiene un tipo Double. Aunque el valor es de tipo Double, la función genera un entero. Por lo tanto, es una asignación simple a una función de entero y devuelve el valor 12:
ds.AsInteger(12.962963)
En la expresión siguiente, los cálculos como (56/4.32) se tratan como un tipo Decimal y la llamada de función AsInteger() se redondea hacia el valor más cercano y devuelve el valor 13:
ds.AsInteger(56/4.32)
fix
Convierte un valor numérico en un número de coma flotante con un número de precisión especificado. Si el número se evalúa en el valor nulo, se devuelve un valor nulo. El valor de precisión es un valor numérico que corresponde al número de dígitos de precisión en el número de coma flotante. La precisión predeterminada es 4. El valor de modalidad es un distintivo que especifica cómo se manejan los dígitos excesivos. Si la modalidad es 0 o no se especifica, el exceso de dígitos se redondea. Si la modalidad es distinta de 0, el exceso de dígitos se trunca.
Sintaxis
ds.FIX(numeric_expression (string), precision (int8), mode (int32))
devuelve: el número convertido de formato dfloat.
Ejemplos
El código siguiente devuelve el número 37.7363.
ds.FIX("37.73629273")
MantissaFromDecimal
Devuelve la mantissa del decimal dado.
Sintaxis
ds.MantissaFromDecimal(number (decimal))
devuelve: la mantissa en formato dfloat.
Ejemplos
Si mylink.number contiene el número 243.7675, las dos funciones siguientes son equivalentes y devuelven el valor 7675:
ds.MantissaFromDecimal(243.7675)
ds.MantissaFromDecimal(mylink.mynumber)
MantissaFromDFloat
Devuelve la mantissa del dfloat dado.
Sintaxis
ds.MantissaFromDFloat(number (dfloat))
devuelve: la mantissa en formato dfloat.
Ejemplos
Si mylink.number contiene el número 1.234412000000000010E+4, la función siguiente devuelve el valor 1:
ds.MantissaFromDFloat(mylink.mynumber)
Real
Convierte un número en una serie para escribir coma flotante sin pérdida de precisión.
Sintaxis
ds.Real(numeric_expression (string))
devuelve: el número convertido de formato dfloat.
Ejemplos
El código siguiente devuelve el número 1.23.
ds.Real("1.23")
Funciones Raw
Utilice la función Sin formato para obtener la longitud de los datos de una columna que contiene datos sin formato.
RawLength
Devuelve la longitud de una serie sin formato.
Sintaxis
ds.RawLength(input string (string))
devuelve: la longitud de la serie sin formato en formato int32.
Ejemplos
Si mylink.rawdata contiene los datos en bruto de un mapa de bits, la función siguiente devuelve el tamaño del mapa de bits en bytes:
ds.RawLength(mylink.rawdata)
Funciones de cadena
Utilice estas funciones para las funciones relacionadas con la serie en una expresión.
AlNum
Comprueba si la serie dada solo contiene caracteres alfanuméricos.
Sintaxis
ds.AlNum(string (string))
devuelve: un resultado de tipo int8, 1 si la entrada es válida para el tipo dado y de lo contrario 0.
Ejemplo
Si mylink.mystring1 contiene la serie "OED_75_9*E", la siguiente función devolverá el valor 0 (false).
ds.AlNum(mylink.mystring1)
Si mylink.mystring2 contiene la serie "12redross", la siguiente función devolverá el valor 1 (true).
ds.AlNum(mylink.mystring2)
Alfa
Comprueba si la serie dada solo contiene caracteres alfabéticos.
Sintaxis
ds.Alpha(string (string))
devuelve: un resultado de tipo int8, 1 si la entrada es válida para el tipo dado y de lo contrario 0.
Ejemplos
Si mylink.mystring1 contiene la serie "12redroses", la función siguiente devolverá el valor 0 (false).
ds.Alpha(mylink.mystring1)
Si mylink.mystring2 contiene la serie "twelveredroses", la función siguiente devolverá el valor 1 (true).
ds.Alpha(mylink.mystring2)
Cats
Concatena dos series.
Sintaxis
ds.Cats(str1 (string), str2 (string))
devuelve: la serie concatenada resultante.
Ejemplos
El código siguiente devuelve "ABC123".
ds.Cats("ABC", "123")
Cambiar
Sustituye la subserie de una expresión dada por una serie de sustitución.
Si el argumento de subserie es una serie vacía, se devuelve el valor del argumento de la expresión.
Si el valor del argumento de sustitución es una serie vacía, se eliminan todas las apariciones de la subserie que empiezan desde la posición indicada por el valor del argumento de inicio. Si el valor del argumento de aparición es menor o igual que 0, se sustituyen todas las apariciones que empiezan desde la posición indicada por el valor del argumento de inicio. De lo contrario, el número de apariciones que se sustituyen se indica mediante el valor del argumento de aparición, empezando por la posición que se indica mediante el valor del argumento de inicio. Si el valor del argumento de inicio es menor o igual a 1, la sustitución se inicia a partir de la primera aparición. De lo contrario, la sustitución comienza desde la posición indicada por el valor del argumento de inicio.
Sintaxis
ds.Change(expression (string), substring (string), replacement (string), [occurrence (int32), [begin (int32)]])
devuelve: la nueva serie con todas las subseries sustituidas.
Ejemplos
Si mylink.mystring contiene la expresión "aaabbbcccbbb", la siguiente función devuelve la serie "aaaZZZcccZZZ".
ds.Change(mylink.mystring,"bbb","ZZZ")
Si mylink.mystring contiene la expresión "ABC" y la subserie está vacía, la función siguiente devuelve la serie "ABC".
ds.Change(mylink.mystring,"","ZZZ")
Si mylink.mystring contiene la expresión "aaabbbcccbbb" y la sustitución está vacía, la siguiente función devuelve la serie "aaaccc".
ds.Change(mylink.mystring, "bbb", "")
CompactWhiteSpace
Devuelve la serie después de reducir todo el espacio en blanco consecutivo a un solo espacio.
Sintaxis
ds.CompactWhiteSpace(string (string))
devuelve: la serie resultante con espacios en blanco reducidos.
Ejemplos
Si mylink.mystring contiene la serie "demasiados espacios", la siguiente función devuelve la serie "demasiados espacios":
ds.CompactWhiteSpace(mylink.mystring)
Comparar
Compara dos series para la ordenación. La comparación se puede estar alineada a la izquierda (valor predeterminado) o alineada a la derecha. Una comparación alineada a la derecha compara las subseries numéricas dentro de las series especificadas como números.
Las series numéricas deben ocupar la misma posición de caracteres en cada serie. Por ejemplo, una comparación alineada a la derecha de las series AB100 y AB99 indica que AB100 es mayor que AB99, ya que 100 es mayor que 99. Una comparación alineada a la izquierda de las series AC99 y AB100 indica que AC99 es mayor, ya que C es mayor que B.
Sintaxis
ds.Compare(string1 (string), string2 (string), [justification ("L" or "R")])
devuelve: un resultado de tipo int8, -1 si string1 es menor que string2, 0 si ambas series son iguales, 1 si string1 es mayor que string2.
Ejemplos
Si mylink.mystring1 contiene la serie "AB99" y mylink.mystring2 contiene la serie "AB100", la función siguiente devuelve el resultado 1.
ds.Compare(mylink.mystring1, mylink.mystring2, "L")
Si mylink.mystring1 contiene la serie "AB99" y mylink.mystring2 contiene la serie "AB100", la función siguiente devuelve el resultado -1.
ds.Compare(mylink.mystring1, mylink.mystring2, "R")
CompareNoCase
Compara dos series para la ordenación, ignorando las mayúsculas/minúsculas.
Sintaxis
ds.CompareNoCase(string1 (string), string2 (string))
devuelve: un resultado de tipo int8, -1 si string1 es inferior a string2, 0 si ambas series son iguales y 1 si string1 es mayor que string2.
Ejemplos
Si mylink.mystring1 contiene la serie "Chocolate Cake" y mylink.mystring2 contiene la serie "chocolate cake", la función siguiente devuelve el resultado 0.
ds.CompareNoCase(mylink.mystring1, mylink.mystring2)
CompareNum
Compara los n primeros caracteres de dos series, n es un valor que especifica el usuario.
Sintaxis
ds.CompareNum(string1 (string), string2 (string), length (int16))
devuelve: un resultado de tipo int8, -1 si string1 es menor que string2, 0 si ambas series son iguales, 1 si string1 es mayor que string2.
Ejemplos
Si mylink.mystring1 contiene la serie "Chocolate" y mylink.mystring2 contiene la serie "Choccy Treat", la función siguiente devuelve el resultado 0.
ds.CompareNum(mylink.mystring1, mylink.mystring2,4)
CompareNumNoCase
Compara los n primeros caracteres de dos series, ignorando si está en mayúsculas o minúsculas, n es un valor que especifica el usuario.
Sintaxis
ds.CompareNumNoCase(string1 (string), string2 (string), length (int16))
devuelve: un resultado de tipo int8, -1 si string1 es menor que string2, 0 si ambas series son iguales, 1 si string1 es mayor que string2.
Ejemplos
Si mylink.myraw contiene la serie "chocolate" y mylink.mystring2 contiene la serie "Choccy Treat", la función siguiente devuelve el resultado 0.
ds.CompareNumNoCase(mylink.mystring1, mylink.mystring2,4)
Conversión
Convierte una serie en un formato de almacenamiento interno o externo especificado. La expresión de serie evalúa la serie que se va a convertir.
En la tabla siguiente se muestran los valores que puede especificar para la conversión. conv_code especifica los tipos de formatos de almacenamiento implicados en la conversión, y conv_mode especifica qué formato se utiliza para la entrada o la salida. Si especifica "I" para conv_mode, se utiliza la función ICONV() para la conversión. Si especifica "O" para conv_mode, se utiliza la función OCONV() para la conversión.
Tabla para valores de conversión
conv_code |
conv_mode |
Descripción |
|---|---|---|
| MX | I | Convierte la serie de entrada de hexadecimal a decimal. |
| MB | I | Convierte la serie de entrada de binaria a decimal. |
| MX0C | I | Convierte la serie de entrada de hexadecimal a una serie de caracteres ASCII. |
| MB0C | I | Convierte la serie de entrada de serie de caracteres binaria a ASCII. |
| MX | O | Convierte la serie de entrada de decimal a hexadecimal. |
| MB | O | Convierte la serie de entrada de decimal a binaria. |
| MX0C | O | Convierte la serie de entrada de serie de caracteres ASCII a hexadecimal. |
| MB0C | O | Convierte la serie de entrada de serie de caracteres ASCII a binaria. |
Sintaxis
ds.Conversion(string (string), conv_code (string), conv_mode (string))
devuelve: la serie convertida.
Ejemplos
Si mylink.mystring contiene la serie "1111", la función siguiente devuelve el valor 15.
ds.Conversion(mylink.mystring,"MB", "I")
Si mylink.mystring contiene la serie "CDE", la función siguiente devuelve el valor 434445.
ds.Conversion(mylink.mystring,"MX0C", "O")
Convertir
Convierte los caracteres de la serie que se ha designado en la expresión dada. Convierte los caracteres especificados en una lista en los caracteres especificados en otra lista.
Sintaxis
ds.Convert(fromlist (string), tolist (string), expression (string))
devuelve: la serie con los caracteres designados convertidos.
Ejemplos
Si mylink.mystring1 contiene la serie "NOW IS THE TIME", la siguiente función devuelve la serie "NOW YS XHE XYME".
ds.Convert("TI","XY", mylink.mystring1)
Recuento
Cuenta el número de veces que aparece una subserie en una serie.
Sintaxis
ds.Count(string (string), substring (string))
devuelve: el número de apariciones de subserie en formato int32 .
Ejemplos
Si mylink.mystring1 contiene la serie "chocolate drops, chocolate ice cream, chocolate bars", la siguiente función devuelve 3.
ds.Count(mylink.mystring1, "choc")
Dcount
Cuenta el número de campos delimitados de un serie.
Sintaxis
ds.Dcount(string (string), delimiter (string))
devuelve: el número de campos delimitados en formato int32 .
Ejemplos
Si mylink.mystring1 contiene la serie "chocolate drops, chocolate ice cream, chocolate bars", la siguiente función devuelve 3.
ds.Dcount(mylink.mystring1,",")
DownCase
Cambia todas las letras en mayúsculas de una serie por minúsculas.
Sintaxis
ds.DownCase(string (string))
devuelve: la serie resultante en minúsculas.
Ejemplos
Si mylink.mystring1 contiene la serie "CaMel cAsE", la función siguiente devuelve la serie "camel case".
ds.DownCase(mylink.mystring1)
DQuote
Encierra una serie entre comillas dobles.
Sintaxis
ds.DQuote(string (string))
devuelve: la serie resultante entre comillas dobles.
Ejemplos
Si mylink.mystring1 contiene la serie necesita comillas, la siguiente función devuelve la serie "necesita comillas".
ds.DQuote(mylink.mystring1)
Ereplace
Sustituye una subserie de una expresión por una serie de sustitución.
Si el argumento de la subserie es una serie vacía, el valor del argumento de sustitución tiene como prefijo el valor del argumento de expresión. Si el argumento de sustitución es una serie vacía, se eliminan todas las apariciones de la subserie que empiezan desde la posición indicada por el valor del argumento de inicio. Si el valor del argumento de aparición es menor o igual que 0, se sustituyen todas las apariciones que empiezan desde el valor del argumento de inicio. De lo contrario, el número de apariciones que se sustituyen se indica mediante el valor del argumento de aparición, a partir de la posición indicada por el valor del argumento de inicio. Si el valor del argumento de inicio es menor o igual a 1, la sustitución se inicia a partir de la primera aparición. De lo contrario, la sustitución empieza desde la posición indicada por el valor del argumento de inicio.
Sintaxis
ds.Ereplace(expression (string), substring (string), replacement (string), [occurrence (int32), [begin (int32)]])
devuelve: la serie resultante con todas las apariciones de la subserie sustituida.
Ejemplos
Si mylink.mystring contiene la expresión "ABC" y la subserie está vacía, la función siguiente devuelve el valor "ZZZABC".
ds.Ereplace(mylink.mystring,"","ZZZ")
Si mylink.mystring contiene la expresión "aaabbbcccbbb" y la sustitución está vacía, la función siguiente devuelve el valor "aaaccc".
ds.Ereplace(mylink.mystring, "bbb", "")
Intercambiar
Sustituye un carácter en una serie.
Sintaxis
ds.Exchange(str (string), findStr (string), replaceStr (string))
devuelve: la serie resultante con caracteres sustituidos.
Ejemplos
El código siguiente devuelve: ".B.BC".
ds.Exchange("ABABC", "41", "2E")
EXTRACT
Acceder al contenido de datos de un campo, valor o subvalor especificado desde una matriz dinámica. La función de forma similar a REMOVE.
La matriz dinámica de entrada sólo debe tener CHAR (254), CHAR (253), CHAR (252) como delimitadores y su jerarquía debe estar escrita antes. Respectivamente, se pueden recuperar mediante las funciones AM o FM, VM, SM o SVM. FM es delimitador de los campos de las series, VM es delimitador de los valores de las series y SM es delimitador de los subvalores de las series.
Para saber más sobre ' EXTRACT, consulte la función EXTRACT.
Sintaxis
ds.EXTRACT(str (string), field (int64), [value (int64), subvalue (int64)])
devuelve: la serie extraída resultante de la serie de formato.
Ejemplos
Los códigos siguientes devuelven ambos: "9ü3ü5". La matriz dinámica contiene 3 campos separados por FM/AM, 2 valores en el primer campo, 1 subvalor en el primer valor, etc.
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)
El código siguiente devuelve una serie vacía, ya que sólo hay 3 campos y no 10 o más.
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
Devuelve una o más subseries ubicadas entre delimitadores especificados en una serie. La aparición del argumento especifica qué aparición del delimitador se utilizará como terminador. El número de argumento especifica opcionalmente el número de subseries que se devolverán.
Sintaxis
ds.Field(string (string), delimiter (string), occurrence (int32), [number (int32)])
devuelve: la serie correspondiente entre los delimitadores.
Ejemplos
Si mylink.mystring1 contiene la serie "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers", la función siguiente devuelve la serie "chocolate ice cream".
ds.Field(mylink.mystring1,",",2)
Si mylink.mystring1 contiene la serie "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers", la función siguiente devuelve la serie "chocolate ice cream, chocolate bars".
ds.Field(mylink.mystring1,",",2,2)
FieldStore
Modifica series de caracteres insertando, suprimiendo o sustituyendo campos separados por una serie de delimitadores especificada. La serie de delimitadores indica la serie que se va a modificar y puede ser cualquier carácter ASCII único. La función también toma los parámetros start (la posición de la serie de entrada donde se inicia la modificación) y number , que es el número de veces que se inserta una serie nueva en la serie de entrada.
Sintaxis
ds.FieldStore(str (string), delimiter (string), start (int8), number (int8), new_fields (string))
devuelve: la serie modificada de la serie de formato.
Ejemplos
El código siguiente devuelve la serie A#B#C#D#5:
ds.FieldStore("1#2#3#4#5", "#", 1, 4, "A#B#C#D")
Fmt
Utiliza la función FMT o una expresión de formato para formatear datos para salida. Cualquier expresión BASIC se puede formatear para la salida siguiéndolo con una expresión de formato. Para obtener detalles sobre la sintaxis de la función Fmt, consulte Función FMT.
Sintaxis
ds.Fmt(string (string), format (string))
devuelve: los datos formateados resultantes de la serie de formato.
Ejemplos
El código siguiente devuelve la serie "23-69-86":
ds.Fmt("236986","R##-##-##")
El código siguiente devuelve el número "***** $555,666,898.00":
ds.Fmt("555666898","20*R2$,")
FmtDP
Convierte un juego de caracteres de varios bytes de tipo serie al formato de destino. Si la globalización (globalización) no está habilitada, la función FmtDP funciona como una función Fmt equivalente. Para obtener detalles sobre la sintaxis de la función FmtDP , consulte FunciónFmtDP.
Sintaxis
ds.FmtDP(string (string), format (string), [mapname (string)])
devuelve: la serie convertida de la serie de formato.
Ejemplos
El código siguiente devuelve el número 56789:
ds.FmtDP("123456789","R#5")
Plegar
Dobla las cadenas para crear subseries. string es la serie que se va a doblar. longitud es la longitud de las subseries en caracteres.
ds.Fold(str (string), length (int8))
devuelve: la serie plegada resultante.
El código siguiente devuelve "THISþIS AþTESTþFOLDEþD STRþING".
ds.Fold("THIS IS A TEST FOLDED STRING", 5)
Folddp
En la modalidad de globalización (globalización), dobla las series para crear subseries que utilizan posiciones de visualización de caracteres.
Sintaxis
ds.Folddp(str (string), length (int), opmap (string))
devuelve: la serie plegada resultante.
Ejemplos
El código siguiente devuelve: "CADENA DE VALORES".
ds.Folddp("这里需要 UNICODE STRING", 5, "0")
Índice
Busca la posición del carácter de inicio de una subserie. La aparición del argumento especifica qué aparición de la subserie se ha de localizar.
Sintaxis
ds.Index(string (string), substring (string), occurrence (int32))
devuelve: el resultado en formato int32 del número de apariciones.
Ejemplos
Si mylink.mystring1 contiene la serie "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers", la función siguiente devuelve el valor 18.
ds.Index(mylink.mystring1,"chocolate",2)
Izquierda
Devuelve los n caracteres situados más a la izquierda de una serie.
Sintaxis
ds.Left(string (string) number (int32))
devuelve: los n caracteres situados más a la izquierda de la serie.
Ejemplos
Si mylink.mystring1 contiene la serie "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers", la función siguiente devuelve la serie "chocolate".
ds.Left(mylink.mystring1,9)
Lon
Devuelve la longitud de una serie en caracteres.
Sintaxis
ds.Len(string (string))
devuelve: la longitud de la serie en formato int32 .
Ejemplos
Si mylink.mystring1 contiene la serie "chocolate", la función siguiente devuelve el valor 9.
ds.Len(mylink.mystring1)
Lendp
En la modalidad de globalización (globalización), devuelve la longitud de una serie con sus posiciones de visualización totales.
Sintaxis
ds.Lendp(str (string), opmap (string))
devuelve: la longitud de la serie de formato int64.
Ejemplos
Se devuelve el código siguiente: 19.
ds.Lendp("这里需要 UNICODE STRING", "0")
Coincidencia
Sinónimo de MATCHES. Se utiliza para comparar una expresión de serie con un patrón. Para obtener más información sobre la sintaxis de ' Match ', consulte Operador de coincidencia.
Sintaxis
ds.Match(str (string), pattern (string))
devuelve: el resultado de si el patrón coincide con la serie de entrada, de formato booleano.
Ejemplos
El código siguiente devuelve false:
ds.Match("XYZ123AB", "3X3N")
El código siguiente devuelve true:
ds.Match("XYZ123AB", "3X3N...")
MatchField
Busca una serie y devuelve la parte de la misma que coincide con el parámetro pattern de entrada. Para obtener más información sobre la sintaxis de ' MatchField ', consulte Operador MATCH.
Sintaxis
ds.MatchField(str (string), pattern (string), field (int))
devuelve: el resultado de la serie de formato.
Ejemplos
El código siguiente devuelve la serie "XYZ":
ds.MatchField("XYZ123AB", "3X3N...", 1)
Num
Devuelve 1 si la serie se puede convertir en un número, de lo contrario devuelve 0.
Sintaxis
ds.Num(string (string))
devuelve: 1 si la serie se puede convertir a un número, o devuelve 0 de lo contrario, en formato int32 .
Ejemplos
Si mylink.mystring1 contiene la serie "22", la función siguiente devuelve el valor 1.
ds.Num(mylink.mystring1)
Si mylink.mystring1 contiene la serie "twenty two", la función siguiente devuelve el valor 0.
ds.Num(mylink.mystring1)
PadString
Devuelve la serie de caracteres rellenada con el número de caracteres de relleno especificado.
Sintaxis
ds.PadString(string (string) padstring (string) padlength (int32))
devuelve: la serie rellenada resultante.
Ejemplos
Si mylink.mystring1 contiene la serie "AB175", la siguiente función devuelve la serie "AB17500000".
ds.PadString(mylink.mystring1,"0",5)
REMOVE
Extrae y devuelve elementos de matriz dinámica separados por delimitadores del sistema, y para indicar qué delimitador del sistema se ha encontrado. Acepta un CHAR como delimitador y devuelve el número correspondiente en cuanto a qué delimitador se encuentra.
| Número | Tipo de delimitador |
|---|---|
| 0 | Fin de serie |
| 1 | Marca de elemento 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) (No disponible en el tipo PIOPEN) |
| 7 | ASCII CHAR (249) (No disponible en el tipo PIOPEN) |
| 8 | ASCII CHAR (248) (No disponible en el tipo PIOPEN) |
Para más información sobre la función ELIMINAR, consulte Función ELIMINAR.
Sintaxis
ds.REMOVE(str (string))
devuelve: la serie resultante con delimitadores eliminados de la lista de series de formato y el número que corresponde al delimitador encontrado.
Ejemplos
El código siguiente devuelve ["3", "12"].
ds.REMOVE("12" + ds.VM() + "12" + ds.VM())
Derecha
Devuelve los n caracteres situados más a la derecha de una serie.
Sintaxis
ds.Right(string (string) number (int32))
devuelve: los n caracteres situados más a la derecha de una serie.
Ejemplos
Si mylink.mystring1 contiene la serie "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers", la función siguiente devuelve la serie "dippers".
ds.Right(mylink.mystring1,7)
Soundex
Devuelve un código que identifica un conjunto de palabras que son (aproximadamente) fonéticamente similares basándose en el algoritmo abierto estándar para la evaluación de SOUNDEX .
Sintaxis
ds.Soundex(string (string))
devuelve: el código que identifica un conjunto de palabras fonéticamente similares.
Ejemplos
Si mylink.mystring1 contiene la serie "Griffin", la siguiente función devuelve el código "G615".
ds.Soundex(mylink.mystring1)
Si mylink.mystring1 contiene la serie "Griphin", la siguiente función también devuelve el código "G615".
ds.Soundex(mylink.mystring1)
Espacio
Devuelve una serie de n caracteres de espacio.
Sintaxis
ds.Space(length (int32))
devuelve: una serie de espacios en blanco con longitud especificada.
Ejemplos
Si mylink.mylength contiene el número 100, la función siguiente devuelve una serie que contiene 100 caracteres de espacio.
ds.Space(mylink.mylength)
SQuote
Encierra una serie con comillas simples.
Sintaxis
ds.SQuote(string (string))
devuelve: la serie entre comillas simples.
Ejemplos
Si mylink.mystring1 contiene la serie necesita comillas, la siguiente función devuelve la serie 'necesita comillas'.
ds.SQuote(mylink.mystring1)
Str
Repite una serie el número de veces especificado.
Sintaxis
ds.Str(string (string), repeats (int32))
devuelve: la serie resultante repetida n veces.
Ejemplos
Si mylink.mystring1 contiene la serie necesita "choc", la función siguiente devuelve la serie "chocchocchocchocchoc".
ds.Str(mylink.mystring1,5)
StripWhiteSpace
Devuelve la serie después de eliminar todos los caracteres de espacio en blanco de la misma.
Sintaxis
ds.StripWhiteSpace(string (string))
devuelve: la serie sin espacios en blanco.
Ejemplos
Si mylink.mystring contiene la serie "too many spaces", la función siguiente devuelve la serie "toomanyspaces":
ds.StripWhiteSpace(mylink.mystring)
Subcadena
Devuelve la subserie especificada.
Cuando se especifica n , la función obtiene los últimos n caracteres de una serie.
Cuando se especifica start y length , la función obtiene los caracteres con una longitud igual a length empezando desde la posición start de una serie.
Cuando se especifica un delimitador , la función obtiene una o más subseries que se encuentran entre delimitadores especificados en una serie. occu es el número de delimitadores y num es la longitud de la subserie entre delimitadores en la subserie resultante.
Sintaxis
ds.Substring(string (string), n (int8))
ds.Substring(string (string), start (int8), length (int8))
ds.Substring(string (string), delimiter (string), occu (int8), num (int8))
devuelve: la matriz de subseries resultante de la serie de formato.
Ejemplos
El código siguiente devuelve "ab.cd".
ds.Substring("ab.cd", ".", 1, 2)
subseries
Crea una matriz dinámica, de la que todos los elementos son subseries de los elementos correspondientes de la matriz dinámica de entrada.
Sintaxis
ds.Substrings(str (string), start (int8), length (int8))
devuelve: la matriz dinámica resultante con subseries correspondientes a la matriz de entrada, de formato de serie.
Ejemplos
El código siguiente devuelve "NESýITHþ23üý50ü".
ds.Substrings("JONESýSMITHþ1.23ü20ý2.50ü10", 3, 20)
Recortar
Elimina todos los espacios y tabuladores iniciales y finales. La función también reduce las apariciones de espacios o tabuladores internos a una.
El argumento stripchar especifica opcionalmente un carácter que no sea un espacio o un separador. El argumento options especifica el tipo de operación de recorte que se va a realizar y contiene uno o varios de los valores siguientes:
A: Elimina todas las apariciones de stripchar.
B Elimina las apariciones inicial y final de stripchar.
D Elimina caracteres de espacio en blanco iniciales, finales y redundantes.
E Elimina los caracteres de espacio en blanco finales.
F Elimina los caracteres de espacio en blanco iniciales.
L Elimina todas las apariciones iniciales de stripchar.
R Elimina las apariciones iniciales, finales y redundantes de stripchar.
T Elimina todas las apariciones finales de stripchar.
Sintaxis
ds.Trim(string (string), [stripchar (string)], [options (string)])
devuelve: la serie recortada.
Ejemplos
Si mylink.mystring contiene la serie " Serie con espacio en blanco ", a continuación, la siguiente función devuelve la serie" Serie con espacio en blanco ":
ds.Trim(mylink.mystring)
Si mylink.mystring contiene la serie " ..Eliminar .. redundante .. puntos .... ", la función siguiente devuelve la serie "Eliminar.puntos.redundantes":
ds.Trim(mylink.mystring,".")
Si mylink.mystring contiene la serie "Remove .. all.. dots....", la función siguiente devuelve la serie ""Eliminartodoslospuntos":
ds.Trim(mylink.mystring,".","A")
Si mylink.mystring contiene la serie "Remove .. trailing.. dots....", la función siguiente devuelve la serie ""Eliminar..todos..los..puntos..de..cola":
ds.Trim(mylink.mystring,".","T")
TrimB
Elimina todos los espacios y tabuladores finales de una serie.
Sintaxis
ds.TrimB(string (string))
devuelve: la serie recortada.
Ejemplos
Si mylink.mystring contiene la serie "too many trailing spaces ", la siguiente función devuelve la serie ""too many trailing spaces":
ds.TrimB(mylink.mystring)
TrimF
Elimina todos los espacios y tabuladores iniciales de una serie.
Sintaxis
ds.TrimF(string (string))
devuelve: la serie recortada.
Ejemplos
Si mylink.mystring contiene la serie " too many leading spaces", entonces la siguiente función devuelve la serie "too many leading spaces":
ds.TrimF(mylink.mystring)
TrimLeadingTrailing
Elimina todos los espacios y tabuladores finales de una serie.
Sintaxis
ds.TrimLeadingTrailing(string (string))
devuelve: la serie recortada.
Ejemplos
Si mylink.mystring contiene la serie " too many spaces ", entonces la siguiente función devuelve la serie "too many spaces":
ds.TrimLeadingTrailing(mylink.mystring)
UpCase
Cambia todas las letras en minúsculas de una serie por mayúsculas.
Sintaxis
ds.UpCase(string (string))
devuelve: la serie resultante en mayúsculas.
Ejemplos
Si ' mylink.mystring1 ' contiene la cadena "CaMel cAsE",, la siguiente función devuelve la cadena "CAMEL CASE":
ds.UpCase(mylink.mystring1)
Mensajería instantánea
Devuelve CHAR (255). Funciona igual que AM.
Sintaxis
ds.IM()
devuelve: el CHAR (255) resultante.
Ejemplos
El código siguiente devuelve 'ß'.
ds.IM()
FM
Devuelve CHAR (254).
Sintaxis
ds.FM()
devuelve: el CHAR (254) resultante.
Ejemplos
El código siguiente devuelve '~'.
ds.FM()
AM
Devuelve CHAR (254). Funciona igual que FM.
Sintaxis
ds.AM()
devuelve: el CHAR (254) resultante.
Ejemplos
El código siguiente devuelve '~'.
ds.AM()
Máquina virtual
Devuelve CHAR (253).
Sintaxis
ds.VM()
devuelve: el CHAR (253) resultante.
Ejemplos
El código siguiente devuelve "ý".
ds.VM()
SM
Devuelve CHAR (252). Funciona igual que SVM.
Sintaxis
ds.SM()
devuelve: el CHAR (252) resultante.
Ejemplos
El código siguiente devuelve 'ü'.
ds.SM()
SVM
Devuelve CHAR (252). Funciona igual que SM.
Sintaxis
ds.SVM()
devuelve: el CHAR (252) resultante.
Ejemplos
El código siguiente devuelve 'ü'.
ds.SVM()
TM
Devuelve CHAR (251).
Sintaxis
ds.TM()
devuelve: el CHAR (251) resultante.
Ejemplos
El código siguiente devuelve '-'.
ds.TM()
Funciones de utilidad
Las funciones de programa de utilidad especifican varios propósitos que están relacionados con la recuperación de información sobre funciones específicas de DataStage .
ElementAt
Devuelve el elemento de la lista especificado por el índice.
Sintaxis
ds.ElementAt(list (object))
devuelve: el índice de elemento del objeto de formato.
Ejemplos
El código siguiente devuelve 'b':
ds.ElementAt(["a","b","c"], 1)
El código siguiente devuelve 2:
ds.ElementAt([1,2,3], 1)
GetCommandName
Obtiene el ID de nodo de una "actividad Ejecutar script de Bash" y recupera el nombre de mandato de la actividad Ejecutar script bash.
Sintaxis
ds.GetCommandName(tasks.activity_id (string))
devuelve: el nombre de mandato de la serie de formato.
Ejemplos
El código siguiente devuelve el nombre de mandato de la tarea run_bash_script_5:
ds.GetCommandName(tasks.run_bash_script_5)
GetCommandOutput
Obtiene el ID de nodo de una "actividad Ejecutar script de Bash" y recupera su salida estándar. Es equivalente a la expresión CEL:
tasks.<activity_id>.results.standard_output
Sintaxis
ds.GetCommandOutput(tasks.activity_id (string))
devuelve: la salida estándar de la serie de formato.
Ejemplos
El código siguiente devuelve la salida estándar de la tarea run_bash_script_5:
ds.GetCommandOutput(tasks.run_bash_script_5)
GetErrorMessage
Utilizado en la tarea sólo en un manejador de excepciones, la salida es el texto del mensaje que se registra como aviso cuando se genera la excepción.
Sintaxis
ds.GetErrorMessage()
devuelve: el mensaje resultante de la serie de formato.
Ejemplos
El código siguiente devuelve el mensaje de error de una tarea anómala:
ds.GetErrorMessage()
GetErrorNumber
Se utiliza en la tarea sólo en un manejador de excepciones, la salida es el entero, que indica el tipo de error que se inicia. 1 o -1.
1 indica que la tarea ha ejecutado un trabajo que se ha cancelado y que no se ha configurado ningún manejador específico.
--1 indica que la tarea no se ejecutó por otros motivos.
Sintaxis
ds.GetErrorNumber()
devuelve: el entero resultante del formato int.
Ejemplos
El código siguiente devuelve el número de error del tipo de actividad del manejador de excepciones:
ds.GetErrorNumber()
GetErrorSource
Utilizada en la tarea sólo en un manejador de excepciones, la salida es el nombre de etapa de la etapa de actividad que ha generado la excepción.
Sintaxis
ds.GetErrorSource()
devuelve: el valor resultante de la tarea de serie de formato.
Ejemplos
El código siguiente devuelve la tarea que ha fallado:
ds.GetErrorSource()
GetJobName
Devuelve el nombre de trabajo de la actividad Ejecutar DataStage en el momento en que se ejecuta la función. Es equivalente a la expresión CEL:
tasks.<activity_id>.results.job_name
Sintaxis
ds.GetJobName(tasks.activity_id (string))
devuelve: el nombre de trabajo de la serie de formato.
Ejemplos
El código siguiente devuelve el nombre de trabajo de la tarea run_datastage_flow_1:
ds.GetJobName(tasks.run_datastage_flow_1)
GetJobNameWithInvocationId
Devuelve el nombre de trabajo de la actividad Ejecutar DataStage en el momento en que se ejecuta la función con un ID de invocación de sufijo si el trabajo se ha ejecutado en varias instancias y el ID de invocación de trabajo no está vacío.
Sintaxis
ds.GetJobNameWithInvocationId(tasks.nodeId)
devuelve: el nombre de trabajo de la serie de formato, con el sufijo del ID de invocación si está disponible.
Ejemplos
El código siguiente devuelve rowGenPeekJob.bigloop1 con el nombre de tarea rowGenPeekJob y el ID de invocación de bigloop1:
ds.GetJobNameWithInvocationId(tasks.rowGenPeekJob)
GetJobStatus
Toma el ID de nodo de una "Ejecutar actividad de DataStage " y recupera su estado de trabajo para <activity_name>.$JobStatus. Es equivalente a la siguiente expresión cel:
((tasks.<activity_id>.results.status == 'Completed') ? 1 : ((tasks.<activity_id>.results.status == 'CompletedWithWarnings') ? 2 : ((tasks.<activity_id>.results.status == 'Cancelled') ? 96 : 3)))
Sintaxis
ds.GetJobStatus(tasks.activity_id (string))
devuelve: el estado de trabajo del formato int.
Ejemplos
El código siguiente devuelve el estado de la tarea run_datastage_flow_1:
ds.GetJobStatus(tasks.run_datastage_flow_1)
GetListCounter
Utilizado en la tarea en un bucle sólo con un contador de lista, la salida es el valor actual de la variable de contador.
Sintaxis
ds.GetListCounter()
devuelve: el valor resultante del contador de cadena de formato.
Ejemplos
El código siguiente devuelve el valor actual del bucle.
ds.GetListCounter()
GetNumericCounter
Utilizado en la tarea en un bucle sólo con un contador numérico, la salida es el valor actual de la variable de contador del bucle.
Sintaxis
ds.GetNumericCounter()
devuelve: el valor resultante del contador de formato int.
Ejemplos
El código siguiente devuelve el valor actual del bucle.
ds.GetNumericCounter()
GetOutputArg
Devuelve el valor especificado de una clave de una entrada de JSON de tipo serie.
Sintaxis
ds.GetOutputArg(JSON (string), key_value (string))
devuelve: el valor del campo de propiedad.
Ejemplos
El código siguiente devuelve el valor de serie "tom":
ds.GetOutputArg("{"name":"tom"}", "name")
GetReturnValue
Obtiene el ID de nodo de una "actividad Ejecutar script de Bash" y devuelve el valor de la actividad Ejecutar script de Bash. Es equivalente a la siguiente expresión CEL:
tasks.<activity_id>.results.return_value
Sintaxis
ds.GetReturnValue(tasks.activity_id (string))
devuelve: el valor resultante de la tarea de formato int.
Ejemplos
El código siguiente devuelve el valor de la tarea tasks.run_bash_script_5:
ds.GetReturnValue(tasks.run_bash_script_5)
GetUserStatus
Obtiene el ID de una tarea de flujo de DataStage y devuelve el estado de la tarea de flujo de DataStage en el trabajo de secuencia. La función no funciona si se ejecuta en un trabajo paralelo. Es equivalente a la expresión CEL:
tasks.<activity_id>.results.user_status
Sintaxis
ds.GetUserStatus(tasks.run_datastage_id (string))
devuelve: el estado del ID de tarea de flujo de DataStage de la serie de formato.
Ejemplos
El código siguiente devuelve el valor del ID de tarea run_datastage_5:
ds.GetUserStatus(tasks.run_datastage_5)
LogName
Devuelve el nombre de inicio de sesión del usuario actual.
Sintaxis
ds.LogName()
devuelve: el nombre de inicio de sesión del usuario actual de la serie de formato.
Ejemplos
El código siguiente devuelve el nombre de inicio de sesión del usuario actual.
ds.LogName()
Vía de acceso
Devuelve el nombre de vía de acceso del usuario actual.
Sintaxis
ds.Path()
devuelve: el nombre de vía de acceso del usuario actual de la serie de formato.
Ejemplos
El código siguiente devuelve el nombre de vía de acceso del usuario actual.
ds.Path()
Esquema
Devuelve el nombre de esquema del usuario actual.
Sintaxis
ds.Schema()
devuelve: el nombre de esquema del usuario actual de la serie de formato.
Ejemplos
El código siguiente devuelve el nombre de esquema del usuario actual.
ds.Schema()
UserNo
Devuelve el número de usuario del usuario actual.
Sintaxis
ds.UserNo()
devuelve: la información de usuario del usuario actual de formato int.
Ejemplos
El código siguiente devuelve el número de usuario del usuario actual.
ds.UserNo()
Quién
Devuelve el usuario actual.
Sintaxis
ds.Who()
devuelve: el usuario actual de la serie de formato.
Ejemplos
El código siguiente devuelve el usuario actual.
ds.Who()
Funciones de manejo de nulos
Funciones que manejan nulos.
IsNull
Devuelve true cuando la expresión de entrada se evalúa en el valor nulo.
Sintaxis
ds.IsNull(input (any))
devuelve: el resultado de si la expresión se evalúa como nula, con el formato booleano.
Ejemplos
El código siguiente devuelve true.
ds.IsNull(null)
El código siguiente devuelve false.
ds.IsNull(0)
IsNotNull
Devuelve true cuando la expresión de entrada no se evalúa en el valor nulo.
Sintaxis
ds.IsNotNull(input (any))
devuelve: el resultado de si la expresión no se evalúa como nula, de formato booleano.
Ejemplos
El código siguiente devuelve false.
ds.IsNotNull(null)
El código siguiente devuelve true.
ds.IsNotNull(0)
Nulo
Devuelve el valor nulo.
Sintaxis
ds.Null()
devuelve: el valor nulo.
Ejemplos
El código siguiente devuelve nulo.
ds.Null()
NullToEmpty
Devuelve una serie vacía si la entrada es nula; de lo contrario, devuelve el valor de la columna de entrada.
Sintaxis
ds.NullToEmpty(input (any))
devuelve: una serie vacía o el valor de entrada.
Ejemplos
El código siguiente devuelve "AA".
ds.NullToEmpty("AA")
El código siguiente devuelve "".
ds.NullToEmpty(null)
NullStr
Devuelve la serie nula CHAR (128).
Sintaxis
ds.NullStr()
devuelve: la serie nula CHAR (128).
Ejemplos
El código siguiente devuelve €.
ds.NullStr()
NullToValue
Devuelve el valor especificado si la entrada es nula; de lo contrario, devuelve el valor de columna de entrada.
Sintaxis
ds.NullToValue(input (any), default (any))
devuelve: el valor especificado o el valor de entrada.
Ejemplos
El código siguiente devuelve "test".
ds.NullToValue("test", "default")
El código siguiente devuelve "default".
ds.NullToValue(null, "default")
El código siguiente devuelve 1.
ds.NullToValue(null, 1)
NullToZero
Devuelve 0 si la entrada es nula; de lo contrario, devuelve el valor de la columna de entrada.
Sintaxis
ds.NullToZero(input (any))
devuelve: 0 o el valor de entrada.
Ejemplos
El código siguiente devuelve 88.
ds.NullToZero(88)
El código siguiente devuelve 0.
ds.NullToZero(null)
SetNull
Asigna un valor nulo a la columna de destino.
Sintaxis
ds.SetNull()
devuelve: establece el destino en el valor nulo.
Ejemplos
El código siguiente devuelve nulo.
ds.SetNull()
Funciones de macros
Funciones que manejan la recuperación de un conjunto de metadatos de proyecto relacionados con trabajos de secuencia de DataStage .
JobName
Devuelve el nombre del trabajo secuenciador.
Sintaxis
ds.JobName
devuelve: el nombre de trabajo secuenciador de la serie de formato.
Ejemplos
El código siguiente devuelve el nombre del trabajo secuenciador.
ds.JobName
JobStartDate
Devuelve la fecha de inicio del trabajo secuenciador.
Sintaxis
ds.JobStartDate
devuelve: la fecha de inicio del trabajo secuenciador de la serie de formato.
Ejemplos
El código siguiente devuelve la fecha de inicio del trabajo secuenciador.
ds.JobStartDate
JobStartTime
Devuelve la hora de inicio del trabajo secuenciador.
Sintaxis
ds.JobStartTime
devuelve: la hora de inicio del trabajo secuenciador de la serie de formato.
Ejemplos
El código siguiente devuelve la hora de inicio del trabajo secuenciador.
ds.JobStartTime
JobStartTimestamp
Devuelve la indicación de fecha y hora de inicio del trabajo secuenciador.
Sintaxis
ds.JobStartTimestamp
devuelve: la indicación de fecha y hora de inicio del trabajo secuenciador de indicación de fecha y hora de formato.
Ejemplos
El código siguiente devuelve la indicación de fecha y hora de inicio del trabajo secuenciador.
ds.JobStartTimestamp
HostName
Devuelve el nombre de host del servidor DataStage .
Sintaxis
ds.HostName
devuelve: el trabajo secuenciador InvocationId de la serie de formato.
Ejemplos
El código siguiente devuelve el trabajo secuenciador InvocationId.
ds.HostName
ProjectName
Devuelve el nombre de proyecto del trabajo secuenciador en ejecución
Sintaxis
ds.ProjectName
devuelve: el nombre de proyecto del trabajo secuenciador en ejecución.
Ejemplos
El código siguiente devuelve el nombre de proyecto del trabajo secuenciador en ejecución.
ds.ProjectName
ProjectId
Devuelve el ID de proyecto del trabajo secuenciador en ejecución.
Sintaxis
ds.ProjectId
devuelve: el ID de proyecto del trabajo secuenciador en ejecución.
Ejemplos
El código siguiente devuelve el ID de proyecto del trabajo secuenciador en ejecución.
ds.ProjectId
JobId
Devuelve el ID de trabajo del trabajo secuenciador en ejecución.
Sintaxis
ds.JobId
devuelve: el ID de trabajo del trabajo secuenciador en ejecución.
Ejemplos
Los mandatos siguientes devuelven el ID de trabajo del trabajo secuenciador en ejecución.
ds.JobId
JobController
Devuelve el nombre de flujo de interconexión del trabajo secuenciador en ejecución.
Sintaxis
ds.JobController
devuelve: el nombre de flujo de interconexión del trabajo secuenciador en ejecución.
Ejemplos
Los mandatos siguientes devuelven el nombre de flujo de interconexión del trabajo secuenciador en ejecución.
ds.JobController
Tema padre: Adición de condiciones a un conducto