Translation not up to date
Tych funkcji produktu DataStage należy używać w edytorach kodu Watson Pipelines , na przykład w celu zdefiniowania zmiennej użytkownika lub zbudowania warunku zaawansowanego.
Składnia funkcji programu budującego wyrażenia
W składni argumentów kwadratowych nawiasy kwadratowe wskazują, że argument jest opcjonalny.
Parametr może akceptować dane dowolnego typu. Oznacza to, że można wprowadzić argument typu string, int, float, null itd. Na przykład funkcja IsNull(input (any)) akceptuje następujące typy parametrów, ale nie jest wyłączna dla następujących typów:
ds.IsNull(1)
ds.IsNull("try null")
ds.IsNull(1.78)
ds.IsNull(null)
Program budujący wyrażenia używa tych katagories do obsługi funkcji kodowania:
funkcje przekształcania
Przekształca pojedynczy format elementu danych w inny.
ASCII
Przekształca wartości znaków w łańcuchu z formatu EBCDIC na format ASCII.
Składnia
ds.Ascii(input (string))
zwroty: łańcuch EDBCDI przekształcony w wynikowy łańcuch ASCII łańcucha formatu.
Przykład
Następujący kod zwróci "65 66 67":
ds.Ascii("193 194 195")
Char
Zwraca znak ASCII z wartości kodu liczbowego.
Składnia
ds.Char(code (uint8))
zwraca: odpowiedni znak formatu typu char.
Przykład
W poniższym przykładzie przedstawiono kod ASCII o kodzie 65 jako znak A.
ds.Char(65)
Suma kontrolna
Zwraca cykliczną wartość kodu nadmiarowości dla łańcucha.
Składnia
ds.Checksum(input (string))
zwraca: wartość sumy kontrolnej łańcucha formatu, który jest cyklicznym kodem nadmiarowości.
Przykład
Następujący kod zwróci wartość 57158:
ds.Checksum("This is any arbitrary string value")
CRC32
Używa funkcji CRC32 do zwracania 16-bitowego kodu nadmiarowości cyklicznego.
Składnia
ds.CRC32(input (string))
zwroty: wynik formatu dziesiętnego.
Przykład
Następujący kod zwróci wartość 57158:
ds.CRC32("This is any arbitrary string value")
Łańcuch DateTo
Zwraca łańcuchową reprezentację podanej daty. Domyślny łańcuch formatu dla dat to "%yyyy%mm%dd", tak więc na przykład data 2009-08-25 jest przechowywana jako liczba dziesiętna 20090825. Można jednak opcjonalnie określić łańcuch formatu, który określa, w jaki sposób data jest przechowywana w liczbie dziesiętnej. Łańcuchy formatu mogą określać tylko format, który zawiera liczby. Na przykład nie można określić łańcucha formatu, takiego jak "%rrrr-%mm-%dd", ponieważ znak łącznika (-) nie może być zapisany w upakowanej wartości dziesiętnej. Następujące tokeny są poprawne dla konwersji do lub z wartości dziesiętnych:
%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)
Literałowe cyfry od 0 do 9 są również poprawne.
Składnia
ds.DateToString(date (date), [format (string)])
zwroty: data w formacie łańcucha.
Przykład
Jeśli mylink.mydate zawiera datę 18th sierpnia 2009, wówczas następujący kod zwraca łańcuch "2009-08-18":
ds.DateToString(mylink.mydate)
Poniższy przykład przedstawia datę zawartą w kolumnie mylink.mydate na łańcuch o formacie dd:mm:yyyy. Jeśli mylink.mydate zawiera datę 18th sierpnia 2009, wówczas następujący kod zwraca łańcuch "18:08:2009":
ds.DateToString(mylink.mydate, "%dd:%mm:%yyyy")
DateToLiczba dziesiętna
Zwraca podaną datę jako upakowaną wartość dziesiętną. Domyślny łańcuch formatu dla dat to "%yyyy%mm%dd", tak więc na przykład data 2009-08-25 jest przechowywana jako liczba dziesiętna 20090825. Można jednak opcjonalnie określić łańcuch formatu, który określa, w jaki sposób data jest przechowywana w liczbie dziesiętnej. Łańcuchy formatu mogą określać tylko format, który zawiera liczby. Na przykład nie można określić łańcucha formatu, takiego jak "%rrrr-%mm-%dd", ponieważ znak łącznika (-) nie może być zapisany w upakowanej wartości dziesiętnej. Następujące tokeny są poprawne dla konwersji do lub z wartości dziesiętnych:
%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)
Literałowe cyfry od 0 do 9 są również poprawne.
Składnia
ds.DateToDecimal(basedate (date), [format (string)])
zwroty: data w formacie liczby dziesiętnej.
Przykład
Jeśli mylink.basedate zawiera datę 2012-08-18, wówczas następująca funkcja zapisuje datę jako liczbę dziesiętną 18082012:
ds.DateToDecimal(mylink.basedate, "%dd%mm%yyyy")
Jeśli mylink.basedate zawiera datę 2012-08-18, wówczas następująca funkcja zapisuje datę jako liczbę dziesiętną 20120818:
ds.DateToDecimal(mylink.basedate)
Data DecimalTo
Zwraca podaną upakowaną liczbę dziesiętną jako datę. Zarówno znak, jak i skala liczby dziesiętnej są ignorowane, gdy jest przekształcana na datę. Domyślny łańcuch formatu to "%yyyy%mm%dd", tak więc na przykład data 2009-08-25 jest przechowywana jako liczba dziesiętna 20090825. Można jednak opcjonalnie określić łańcuch formatu, który określa, w jaki sposób data jest przechowywana w liczbie dziesiętnej. Łańcuchy formatu mogą określać tylko format, który zawiera liczby. Na przykład nie można określić łańcucha formatu, takiego jak "%rrrr-%mm-%dd", ponieważ znak łącznika (-) nie może być zapisany w upakowanej wartości dziesiętnej. Następujące tokeny są poprawne dla konwersji do lub z wartości dziesiętnych:
%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)
Literałowe cyfry od 0 do 9 są również poprawne.
Składnia
ds.DecimalToDate(basedec (decimal), [format (string)])
zwraca: liczbę dziesiętną w formacie daty.
Przykład
Jeśli mylink.mydecdata zawiera wartość 18082012, wówczas następująca funkcja zwraca datę 2012-08-18:
ds.DecimalToDate(mylink.basedate, "%dd%mm%yyyy")
Jeśli parametr mylink.mydecdata zawiera wartość -201208.18, to następująca funkcja zwraca datę 2012-08-18:
ds.DecimalToDate(mylink.basedate)
DecimalToLiczba dziesiętna
Zwraca podaną liczbę dziesiętną w postaci dziesiętnej. Argument rtype (opcjonalnie) określa typ zaokrąglania i jest ustawiony na jedną z następujących wartości:
ceil: zaokrągla pole źródłowe w kierunku dodatniego nieskończoności. Na przykład: 1.4 -> 2, -1.6 -> -1.
floor: zaokrągla pole źródłowe w kierunku nieskończoności ujemnej. Na przykład: 1.6 -> 1, -1.4 -> -2.
round_inf: Rounds lub obetnij pole źródłowe w kierunku najbliższej wartości, która może być tłumiona, przełamując wartości, zaokrąglając wartości dodatnie w kierunku dodatniej nieskończoności i ujemnych wartości w kierunku ujemnej nieskończoności. Na przykład: 1.4 -> 1, 1.5 -> 2, -1.4 -> -1, -1.5 -> -2.
trunc_zero: Odrzuć dowolne cyfry ułamkowe po prawej stronie prawej najbardziej frakcyjnej cyfry obsługiwanej w miejscu docelowym, niezależnie od znaku. Na przykład, jeśli miejscem docelowym jest liczba całkowita, wszystkie cyfry ułamkowe są obcinane. Jeśli miejsce docelowe jest inną wartością dziesiętną z mniejszą skalą, zaokrągla lub obcina do wielkości skali miejsca docelowego dziesiętnego. Na przykład: 1.6 -> 1, -1.6 -> -1.
Składnia
ds.DecimalToDecimal(decimal (decimal), [rtype (string)])
zwroty: wynikowa liczba dziesiętna.
Przykład
Jeśli mylink.mydec zawiera liczbę dziesiętną 2.5345 , następująca funkcja zwraca liczbę dziesiętną 2.54:
ds.DecimalToDecimal(mylink.mydec,"ceil")
Jeśli parametr mylink.mydec zawiera liczbę dziesiętną 2.5345 , następująca funkcja zwraca liczbę dziesiętną 2.53.
ds.DecimalToDecimal(mylink.mydec,"floor")
Jeśli parametr mylink.mydec zawiera liczbę dziesiętną 2.5345 , następująca funkcja zwraca liczbę dziesiętną 2.53.
ds.DecimalToDecimal(mylink.mydec,"trunc_zero")
Jeśli parametr mylink.mydec zawiera liczbę dziesiętną 2.5345 , następująca funkcja zwraca liczbę dziesiętną 2.53.
ds.DecimalToDecimal(mylink.mydec,"round_inf")
DecimalToDFloat
Zwraca podaną liczbę dziesiętną w reprezentacji dfloat . Argument opcjonalny fix_zero określa, że wszystkie zerowe wartości dziesiętne są traktowane jako poprawne (domyślnie liczby dziesiętne zawierające wszystkie zera są traktowane jako niepoprawne).
Składnia
ds.DecimalToDFloat(decimal (decimal), ["fix_zero"])
zwraca: liczbę dziesiętną w formacie dfloat .
Przykłady
Jeśli mylink.mydec zawiera liczbę dziesiętną 00000004.00 , następująca funkcja zwraca dfloat numer 4.
ds.DecimalToDFloat(mylink.mydec,"fix_zero")
Jeśli mylink.mydec zawiera liczbę dziesiętną 00012344.00 , następująca funkcja zwraca numer dfloat 12344.
ds.DecimalToDFloat(mylink.mydec,"fix_zero")
Jeśli parametr mylink.mydec zawiera liczbę dziesiętną 00012344.120 , następująca funkcja zwraca numer dfloat 12344.12.
ds.DecimalToDFloat(mylink.mydec,"fix_zero")
Jeśli parametr mylink.mydec zawiera liczbę dziesiętną 00012344.120 , następująca funkcja zwraca wartość dfloat 12344.12.
ds.DecimalToDFloat(mylink.mydec)
Jeśli parametr mylink.mydec zawiera liczbę dziesiętną 00012344.000 , następująca funkcja zwraca wartość dfloat 12344.
ds.DecimalToDFloat(mylink.mydec)
Łańcuch DecimalTo
Zwraca podaną liczbę dziesiętną jako łańcuch. Argument fix_zero (opcjonalnie) określa, że wszystkie zerowe wartości dziesiętne są traktowane jako poprawne (domyślnie liczby dziesiętne składające się ze wszystkich zer są traktowane jako niepoprawne). Obejmuje to przypadek, w którym bity znaków w upakowanej reprezentacji dziesiętnej to 0, a także wszystkie cyfry treści. Rzutowanie to nie jest uznawane za poprawne, chyba że parametr fix_zero ma wartość true.
Składnia
ds.DecimalToString(decimal (decimal), ["fix_zero"])
zwraca: liczbę dziesiętną w formacie łańcucha.
Przykłady
Jeśli parametr mylink.mydec zawiera liczbę dziesiętną 00000004.00, następująca funkcja zwraca łańcuch "4":
ds.DecimalToString(mylink.mydec,"suppress_zero")
Jeśli parametr mylink.mydec zawiera liczbę dziesiętną o numerze 00000004.00, następująca funkcja zwraca łańcuch "0000000000000000000000000004.0000000000":
ds.DecimalToString(mylink.mydec,"fix_zero")
Jeśli parametr mylink.mydec zawiera liczbę dziesiętną 00000004.00, następująca funkcja zwraca łańcuch "4":
ds.DecimalToString(mylink.mydec)
Czas DecimalTo
Zwraca podaną upakowaną liczbę dziesiętną jako godzinę. Opcjonalnie można określić łańcuch formatu, który określa, w jaki sposób czas jest przechowywany w liczbie dziesiętnej. Domyślnym łańcuchem formatu jest "%hh%nn%ss", tak więc na przykład godzina 14:03:22 jest przechowywana jako liczba dziesiętna 140322. Łańcuchy formatu mogą określać tylko format, który zawiera liczby. Na przykład nie można określić łańcucha formatu, takiego jak "%hh: %nn:%ss", ponieważ znak dwukropka (:) nie może być zapisany w upakowanej liczbie dziesiętnej. Następujące tokeny są poprawne dla konwersji do lub z wartości dziesiętnych:
%hh (two-digit hours using 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 one to six inclusive).
Literałowe cyfry od 0 do 9 są również poprawne.
Jeśli podany format zawiera mikrosekundy (na przykład %ss.4), to pozycja separatora dziesiętnego jest wywnioskowana w wartości dziesiętnej. Pozycja separatora dziesiętnego nie musi pokrywać się z określoną skalą liczby dziesiętnej (na przykład skala = 4).
Składnia
ds.DecimalToTime(decimal (decimal), [format (string)])
zwroty: dziesiętne w formacie czasu.
Przykład
Jeśli parametr mylink.mytimedec zawiera wartość dziesiętną 200658, wówczas następująca funkcja zwraca godzinę 20:06:58:
ds.DecimalToTime(mylink.mytimedec)
Jeśli kolumna mylink.mytimedec zawiera wartość dziesiętną 580620, wówczas następująca funkcja zwraca godzinę 20:06:58:
ds.DecimalToTime(mylink.mytimedec, "%ss%nn%hh")
DecimalToDatownik
Zwraca podaną upakowaną liczbę dziesiętną jako znacznik czasu. Opcjonalnie można określić łańcuch formatu określający, w jaki sposób znacznik czasu ma być przechowywany w postaci dziesiętnej. Domyślny łańcuch formatu to "%hh%nn%ss", tak więc na przykład datownik 2009-08-25 14:03:22 jest zapisany jako liczba dziesiętna 20090825140322. Łańcuchy formatu mogą określać tylko format, który zawiera liczby. Na przykład nie można określić łańcucha formatu, takiego jak "%yyyy/%mm/%dd%hh: %nn:%ss", ponieważ ukośnik (/) i dwukropek (:) nie mogą być zapisane w upakowanej liczbie dziesiętnej. Następujące tokeny są poprawne dla konwersji do lub z wartości dziesiętnych:
%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 using 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 one to six inclusive).
Literałowe cyfry od 0 do 9 są również poprawne.
Jeśli podany format zawiera mikrosekundy (na przykład %ss.4), to pozycja separatora dziesiętnego jest wywnioskowana w wartości dziesiętnej. Pozycja separatora dziesiętnego nie musi pokrywać się z określoną skalą liczby dziesiętnej (na przykład skala = 4).
Składnia
ds.DecimalToTimestamp(decimal (decimal), [format (string)])
zwroty: dziesiętne w formacie datownika.
Przykład
Jeśli mylink.mytimestampdec zawiera wartość 19580818200658, to następująca funkcja zwraca znacznik czasu 1958-08-18 20:06:58:
ds.DecimalToTimestamp(mylink.mytimestampdec)
Jeśli parametr link.mytimestampdec zawiera wartość dziesiętną 200658220818, wówczas następująca funkcja zwraca znacznik czasu 2022-08-18 20:06:58:
ds.DecimalToTimestamp(mylink.mytimestampdec, "%hh%nn%ss%yy%mm%dd")
DFloatToLiczba dziesiętna
Zwraca podaną wartość dfloat w reprezentacji dziesiętnej. Argument rtype (opcjonalnie) określa typ zaokrąglania i jest ustawiony na jedną z następujących wartości:
ceil: zaokrągla pole źródłowe w kierunku dodatniego nieskończoności. Na przykład: 1.4 -> 2, -1.6 -> -1.
floor: zaokrągla pole źródłowe w kierunku nieskończoności ujemnej. Na przykład: 1.6 -> 1, -1.4 -> -2.
round_inf: Rounds lub obetnij pole źródłowe w kierunku najbliższej wartości, która może być tłumiona, przełamując wartości, zaokrąglając wartości dodatnie w kierunku dodatniej nieskończoności i ujemnych wartości w kierunku ujemnej nieskończoności. Na przykład: 1.4 -> 1, 1.5 -> 2, -1.4 -> -1, -1.5 -> -2.
trunc_zero: Odrzuć dowolne cyfry ułamkowe po prawej stronie prawej najbardziej frakcyjnej cyfry obsługiwanej w miejscu docelowym, niezależnie od znaku. Na przykład, jeśli miejscem docelowym jest liczba całkowita, wszystkie cyfry ułamkowe są obcinane. Jeśli miejsce docelowe jest inną wartością dziesiętną z mniejszą skalą, zaokrągla lub obcina do wielkości skali miejsca docelowego dziesiętnego. Na przykład: 1.6 -> 1, -1.6 -> -1.
Składnia
ds.DFloatToDecimal(number (dfloat), [rtype (string)])
zwroty: dziesiętne w formacie dfloat.
Przykłady
Jeśli mylink.myfloat zawiera dfloat o numerze 2.534, następująca funkcja zwraca liczbę dziesiętną 2.54:
ds.DFloatToDecimal(mylink.mydec,"ceil")
Jeśli mylink.myfloat zawiera dfloat o numerze 2.534, następująca funkcja zwraca liczbę dziesiętną 2.53:
ds.DFloatToDecimal(mylink.mydec,"floor")
Jeśli mylink.myfloat zawiera dfloat o numerze 2.534, następująca funkcja zwraca liczbę dziesiętną 2.53:
ds.DFloatToDecimal(mylink.mydec,"trunc_zero")
Jeśli mylink.myfloat zawiera dfloat o numerze 2.534, następująca funkcja zwraca liczbę dziesiętną 2.53:
ds.DFloatToDecimal(mylink.mydec,"round_inf")
DfloatToStringNoExp
Zwraca daną wartość dfloat w reprezentacji łańcuchowej bez wykładnika przy użyciu określonej skali.
Składnia
ds.DfloatToStringNoExp(number (dfloat), scale (string))
zwraca: wartość dfloat w formacie łańcucha.
Przykłady
Jeśli parametr mylink.myfloat zawiera wartość dfloat 2.534, wówczas następująca funkcja zwraca łańcuch "2.5":
ds.DfloatToStringNoExp(mylink.myfloat, "2")
Dtx
Przekształca liczbę dziesiętną w liczbę szesnastkową.
Składnia
ds.Dtx(number (int32), size(int8))
zwraca: wynik łańcucha formatu.
Przykład
Następujący kod zwróci wartość "002F":
ds.Dtx(47,4)
EBCDIC
Przekształca każdy znak wyrażenia z jego wartości reprezentacji ASCII na wartość reprezentacji EBCDIC.
Składnia
ds.Ebcdic(input (string))
zwroty: łańcuch ASCII przekształcony w wynikowy łańcuch EDBCDII.
Przykład
Poniższy kod powróci "193 194 195 64 241 242 243":
ds.Ebcdic("ABC 123")
Iconv
Przekształca łańcuch w wewnętrzny format pamięci masowej.
Składnia
ds.Iconv(string (string), code (string))
zwraca: wewnętrzny format pamięci w formacie łańcucha.
Przykład
Następujący kod zwróci 10740:
ds.Iconv("27 MAY 97", "D2")
Następujący kod zwróci 10740:
ds.Iconv("1997 5 27", "D YMD")
IntToBool
Przekształca liczbę całkowitą w typ bool. Zwraca wartość true dla dowolnej wartości niezerowej, a wartość false dla 0.
Składnia
ds.IntToBool(integer (int))
zwroty: wartość boolowska true lub false.
Przykład
Wartość 2 zwróci wartość true.
ds.IntToBool(2)
IsValid
Zwraca informację o tym, czy dany łańcuch jest poprawny dla danego typu.
Poprawne typy to: date, decimal, dfloat, sfloat,int8,uint8,int16,uint16,int32,uint32, "int64","uint64"," string "," time "," timestamp ".
W przypadku typów danych daty, godziny i znacznika czasu można opcjonalnie określić łańcuch formatu. Łańcuch formatu opisuje format używany przez dane wejściowe, gdy różni się on od domyślnych formatów daty, godziny lub datownika. Domyślny format daty to "%rrrr-%mm-%dd". Domyślny format czasu to "%hh: %mm:%ss". Domyślnym formatem znacznika czasu jest "%yyyy-%mm-%dd %hh: %mm:%ss". Ta funkcja nie powoduje rejestrowania ostrzeżeń.
Składnia
ds.IsValid(type (string), teststring (string), [format (string)])
zwroty: wynik typu int8 , 1, jeśli dane wejściowe są poprawne dla danego typu, a 0 w przeciwnym razie.
Przykład
Jeśli mylink.mystring zawiera łańcuch "1", to następująca funkcja zwraca wartość 1:
ds.IsValid("int8", mylink.mystring)
Jeśli łańcuch mylink.mystring zawiera łańcuch "380096.06", wówczas następująca funkcja zwraca wartość 0:
ds.IsValid("int8", mylink.mystring)
IsValidData
Zwraca informację o tym, czy dana wartość jest poprawna dla typu daty. Ta funkcja protokołuje ostrzeżenia.
Składnia
ds.IsValidDate(testdate (date))
zwroty: wynik typu int8 , 1, jeśli dane wejściowe są poprawne dla danego typu, a 0 w przeciwnym razie.
Jeśli mylink.mydate zawiera datę 2011-09-13, wówczas następująca funkcja zwraca wartość 1.
ds.IsValidDate(mylink.mydate)
Jeśli łańcuch mylink.mydate zawiera łańcuch "380096.06", to następująca funkcja zwraca wartość 0, ponieważ przekształcony łańcuch nie jest poprawną datą.
ds.IsValidDate(mylink.mydate)
IsValidLiczba dziesiętna
Zwraca informację o tym, czy dana wartość jest poprawna dla typu dziesiętnego. Jeśli wartość allzerosflag jest ustawiona na 0, reprezentacja all-zeroes jest niepoprawna. Wartość allzerosflag jest domyślnie ustawiona na wartość 0.
Składnia
ds.IsValidDecimal(testvalue (decimal), [allzerosflag (uint8)])
zwroty: wynik typu int8 , 1, jeśli dane wejściowe są poprawne dla danego typu, a 0 w przeciwnym razie.
Przykłady
Jeśli parametr mylink.mynum zawiera wartość 310007.65, to następująca funkcja zwraca wartość 1.
ds.IsValidDecimal(mylink.mynum)
Czas IsValid
Zwraca informację o tym, czy dany czas jest poprawny dla danego typu czasu.
Składnia
ds.IsValidTime(testtime (time))
zwroty: wynik typu int8 , 1, jeśli dane wejściowe są poprawne dla danego typu, a 0 w przeciwnym razie.
Przykłady
Jeśli mylink.mytime zawiera godzinę 23:09:22, wówczas następująca funkcja zwraca wartość 1:
ds.IsValidTime(mylink.mytime)
IsValidDatownik
Zwraca informację o tym, czy dany znacznik czasu jest poprawny dla typu znacznika czasu.
Składnia
ds.IsValidTimestamp(testtimestamp (timestamp))
zwroty: wynik typu int8 , 1, jeśli dane wejściowe są poprawne dla danego typu, a 0 w przeciwnym razie.
Przykłady
Jeśli mylink.mytimestamp zawiera godzinę 2011-09-13 23:09:22, to następująca funkcja zwraca wartość 1:
ds.IsValidTimestamp(mylink.mytimestamp)
Oconv
Przekształca wyrażenie w format wyjściowy.
Składnia
ds.Oconv(expression (string), conversion (string))
zwraca: wynik do formatu wyjściowego łańcucha formatu.
Przykład
Kod powrotu 1997-147 zostanie zwrócony następujący kod:
ds.Oconv(10740, "D-YJ")
Poniższy kod zwróci 27 MAJ 97:
ds.Oconv(10740, "D DMY, [A3,2]")
RawNumW
Zwraca liczbę całkowitą o określonej wartości indeksu w określonym polu surowym. Indeks zaczyna się od 0.
Składnia
ds.RawNumAt(rawfield (string), index (int32))
zwroty: liczba całkowita w indeksie w formacie int32 .
Przykłady
Jeśli column mylink.myraw zawiera wartość surowa pochodząca z łańcucha "hello" (co jest "{ 0x68 0x65 0x6C 0x6C 0x6F }"), a następnie następująca funkcja zwraca liczbę całkowitą 104 (kod ASCII dla znaku h):
ds.RawNumAt(mylink.myraw, 0)
Jeśli mylink.myraw zawiera wartość surowa pochodząca z łańcucha "hello" (co jest "{ 0x68 0x65 0x6C 0x6C 0x6F }"), a następnie następująca funkcja zwraca 0, ponieważ podany indeks jest poza zakresem:
ds.RawNumAt(mylink.myraw, 12)
Łańcuch RawTo
Zwraca daną wartość surowa jako reprezentację łańcuchową. Należy upewnić się, że surowa wartość wejściowa zawiera sekwencję bajtów, które są poprawne jako znaki w docelowym zestawie znaków, w którym używany jest łańcuch wyjściowy.
Na przykład wartość surowa { 0xE0 0x41 0x42 } nie jest poprawną sekwencją znaków UTF-8 , ponieważ znak bajtu wiodącej, 0xE0, powinien następować po bajcie z zakresu [0x80..0xBF].
Jeśli wartość surowa { xE0 x41 x42 } jest przekazywana do funkcji łańcuchowej RawTo, może wystąpić błąd, jeśli do łańcucha wyjściowego jest uzyskiwany dostęp tak, jakby był zakodowany w UTF-8.
Składnia
ds.RawToString(rawfield (string))
zwraca: wartość surowa jako łańcuch.
Przykłady
Jeśli mylink.myraw zawiera wartość { 0x31 0x31 0x30 0x35 0x32 0x32 0x30 0x39 }, wówczas następująca funkcja zwraca łańcuch "11052209".
ds.RawToString(mylink.myraw)
Sekw
Generuje numeryczną wartość kodu z znaku ASCII. Opcjonalnie można określić argument allow8bits w celu przekształcenia 8-bitowych wartości ASCII.
Składnia
ds.Seq(seq (char))
zwroty: kod liczbowy ASCII.
Przykłady
W poniższym przykładzie przedstawiono znak A jako kod ASCII 65.
ds.Seq("A")
SeqAt
Zwraca numeryczną wartość punktu kodowego znaku na określonej pozycji w danym łańcuchu. Indeks zaczyna się od 0. Jeśli określony indeks jest poza zakresem, funkcja zwraca 0.
Składnia
ds.SeqAt(basestring (string), index (int32))
zwroty: numeryczna wartość punktu kodowego znaku na określonej pozycji w danym łańcuchu w formacie int32 .
Przykłady
Jeśli łańcuch mylink.mystring zawiera łańcuch "koń", to następująca funkcja zwraca wartość 0x6F (czyli wartość ASCII znaku o).
ds.SeqAt(mylink.mystring, 1)
StringToBool
Przekształca łańcuch w typ bool. Zwraca wartość false dla pustego łańcucha, zwracając wartość true dla każdej innej wartości.
Składnia
ds.StringToBool(string (string))
zwroty: wartość boolowska true lub false.
Przykład
Pusty łańcuch zwraca wartość false.
ds.StringToBool("")
StringToData
Zwraca datę z podanego łańcucha w określonym formacie. Jeśli łańcuch zawiera datę w formacie domyślnym rrrr-mm-dd, nie trzeba określać łańcucha formatu.
Składnia
ds.StringToDate(string (string), [format (string)])
zwraca: łańcuch do daty w określonym formacie.
Przykłady
Jeśli mylink.mystring zawiera łańcuch "1958-08-18", to następująca funkcja zwraca datę 1958-08-18.
ds.StringToDate(mylink.mystring)
Jeśli łańcuch mylink.mystring zawiera łańcuch "18:08:1958", to następująca funkcja zwraca datę 1958-08-18.
ds.StringToDate(mylink.mystring,"%dd:%mm:%yyyy")
StringToLiczba dziesiętna
Zwraca podany łańcuch w postaci dziesiętnej. Argument rtype (opcjonalnie) określa typ zaokrąglania i jest ustawiony na jedną z następujących wartości:
ceil: zaokrągla pole źródłowe w kierunku dodatniego nieskończoności. Na przykład: 1.4 -> 2, -1.6 -> -1.
floor: zaokrągla pole źródłowe w kierunku nieskończoności ujemnej. Na przykład: 1.6 -> 1, -1.4 -> -2.
round_inf: Rounds lub obetnij pole źródłowe w kierunku najbliższej wartości, która może być tłumiona, przełamując wartości, zaokrąglając wartości dodatnie w kierunku dodatniej nieskończoności i ujemnych wartości w kierunku ujemnej nieskończoności. Na przykład: 1.4 -> 1, 1.5 -> 2, -1.4 -> -1, -1.5 -> -2.
trunc_zero: Odrzuć dowolne cyfry ułamkowe po prawej stronie prawej najbardziej frakcyjnej cyfry obsługiwanej w miejscu docelowym, niezależnie od znaku. Na przykład, jeśli miejscem docelowym jest liczba całkowita, wszystkie cyfry ułamkowe są obcinane. Jeśli miejsce docelowe jest inną wartością dziesiętną z mniejszą skalą, zaokrągla lub obcina do wielkości skali miejsca docelowego dziesiętnego. Na przykład: 1.6 -> 1, -1.6 -> -1.
Składnia
ds.StringToDecimal(string (string), [rtype (string)])
zwraca: łańcuch w formacie dziesiętnym.
Przykłady
Jeśli łańcuch mylink.mystring zawiera łańcuch "19982.22", to następująca funkcja zwraca liczbę dziesiętną 19982.22.
ds.StringToDecimal(mylink.mystring)
Jeśli łańcuch mylink.mystring zawiera łańcuch "19982.2276", to następująca funkcja zwraca liczbę dziesiętną 19982.23.
ds.StringToDecimal(mylink.mystring,"ceil")
StringToSurowy
Zwraca łańcuch jako wartość kodu surowego.
Składnia
ds.StringToRaw(string (string))
zwraca: wartość odpowiedniego kodu surowego łańcucha.
Przykłady
Jeśli łańcuch mylink.mystring zawiera łańcuch "hello", to następująca funkcja zwraca wartość "{0x68 0x65 0x6C 0x6C 0x6F}".
ds.StringToRaw(mylink.mystring)
StringToCzas
Zwraca reprezentację czasu dla danego łańcucha.
Składnia
ds.StringToTime(string (string), [format (string)])
zwraca: łańcuch w wartości czasu.
Przykłady
Jeśli mylink.mystring zawiera łańcuch "20:06:58", funkcja zwraca czas o godzinie 20:06:58.
ds.StringToTime(mylink.mystring)
Jeśli mylink.mystring zawiera łańcuch "20: 6:58", funkcja zwraca czas o godzinie 20:06:58.
ds.StringToTime(mylink.mystring,"%(h,s):%(n,s):%(s,s)")
StringToDatownik
Zwraca podany łańcuch w formacie datownika.
Składnia
ds.StringToTimestamp(string (string), [format (string)])
zwroty: łańcuch w formacie datownika.
Przykłady
Jeśli mylink.mystring zawiera łańcuch "1958-08-08 20:06:58", to funkcja zwraca znacznik czasu 1958-08-08 20:06:58.
ds.StringToTimestamp(mylink.mystring)
Jeśli mylink.mystring zawiera łańcuch "8/ 8/1958 20: 6:58", to funkcja zwraca znacznik czasu 1958-08-08 20:06:58.
ds.StringToTimestamp(mylink.mystring, "%(d,s)/%(m,s)/%yyyy%(h,s):%(n,s):%(s,s)")
StringToUstring
Zwraca wartość ustring z podanego łańcucha, opcjonalnie przy użyciu podanej mapy (w przeciwnym razie korzysta z wartości domyślnej projektu).
Składnia
ds.StringToUstring(string (string), [mapname (string)])
zwroty: łańcuch w formacie ustring.
Przykłady
Jeśli łańcuch mylink.mystring zawiera łańcuch "11052009", to następująca funkcja zwraca łańcuch ułańcuch "11052009".
ds.StringToUstring(mylink.mystring)
Data TimestampTo
Zwraca datę z danego datownika.
Składnia
ds.TimestampToDate(timestamp (timestamp))
zwraca: wynikowa data znacznika czasu.
Przykłady
Jeśli mylink.mytimestamp zawiera znacznik czasu 1958-08-18 20:06:58, wówczas następująca funkcja zwraca datę 1958-08-18:
ds.TimestampToDate(mylink.mytimestamp)
TimestampToLiczba dziesiętna
Zwraca podany znacznik czasu jako upakowaną liczbę dziesiętną. Domyślny łańcuch formatu to " %yyyy%mm%dd%gg%nn%ss ". Na przykład znacznik czasu 2009-08-25 14:03:22 jest zapisany jako liczba dziesiętna 20090825140322. Można jednak opcjonalnie określić łańcuch formatu, który określa, w jaki sposób data jest przechowywana w liczbie dziesiętnej. Łańcuchy formatu mogą określać tylko format, który zawiera liczby. Na przykład nie można określić łańcucha formatu, takiego jak "%yyyy/%mm/%dd%hh: %nn:%ss", ponieważ ukośnik (/) i dwukropek (:) nie mogą być zapisane w upakowanej liczbie dziesiętnej. Następujące tokeny są poprawne dla konwersji do lub z wartości dziesiętnych:
%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 using 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 one to six inclusive).
Literałowe cyfry od 0 do 9 są również poprawne.
Jeśli podany format zawiera mikrosekundy (na przykład %ss.4), to pozycja separatora dziesiętnego jest wywnioskowana w wartości dziesiętnej. Pozycja separatora dziesiętnego nie musi pokrywać się z określoną skalą liczby dziesiętnej (na przykład skala = 4).
Składnia
ds.TimestampToDecimal(timestamp (timestamp), [format (string)])
zwraca: wynikowy znacznik czasu w formacie dziesiętnym.
Przykłady
Jeśli parametr mylink.mytimestamp zawiera znacznik czasu 1958-08-18 20:06:58, wówczas następująca funkcja zwraca wartość dziesiętną 19580818200658:
ds.TimestampToDecimal(mylink.mytimestamp)
Jeśli parametr mylink.mytimestamp zawiera znacznik czasu 1958-08-18 20:06:58, wówczas następująca funkcja zwraca wartość dziesiętną 200658580818:
ds.TimestampToDecimal(mylink.mytimestamp, "%hh%nn%ss%yy%mm%dd")
Łańcuch TimestampTo
Zwraca podany znacznik czasu jako format łańcucha.
Składnia
ds.TimestampToString(timestamp (timestamp), [format (string)])
zwraca: wynikowy znacznik czasu w formacie łańcucha.
Przykłady
Jeśli mylink.mytimestamp zawiera znacznik czasu 1958-08-18 20:06:58, to funkcja zwraca łańcuch "1958-08-18 20:06:58".
ds.TimestampToString(mylink.mytimestamp)
Jeśli mylink.mytimestamp zawiera znacznik czasu 1958-08-18 20:06:58, wówczas funkcja zwraca łańcuch "1 8/0 8/1 9 5 8 20:06:58":
ds.TimestampToString(mylink.mytimestamp, "%dd/%mm/%yyyy %hh:%nn:%ss")
Czas TimestampTo
Zwraca dany znacznik czasu jako format godziny.
Składnia
ds.TimestampToTime(timestamp (timestamp), [format (string)])
zwraca: wynikowy znacznik czasu w formacie czasu.
Przykłady
Jeśli mylink.mytimestamp zawiera znacznik czasu 1958-08-18 20:06:58, wówczas funkcja zwraca godzinę 20:06:58:
ds.TimestampToTime(mylink.mytimestamp)
Łańcuch TimeTo
Zwraca łańcuch z podanego czasu.
Składnia
ds.TimeToString(timestamp (timestamp), [format (string)])
zwroty: wynik w formacie czasu.
Przykłady
Jeśli mylink.mytime zawiera godzinę 20:06:58, wówczas następująca funkcja zwraca łańcuch "20:06:58":
ds.TimeToString(mylink.mytime)
Jeśli mylink.mytime zawiera godzinę 20:06:58, wówczas następująca funkcja zwraca łańcuch "58:06:20":
ds.TimeToString(mylink.mytime, "%ss:%nn:%hh")
TimeToLiczba dziesiętna
Zwraca podany czas w postaci upakowanej liczby dziesiętnej. Domyślny łańcuch formatu to " %gg%nn%ss ", tak więc na przykład godzina 14:03:22 jest przechowywana jako liczba dziesiętna 140322. Można jednak opcjonalnie określić łańcuch formatu, który określa, w jaki sposób czas jest przechowywany w liczbie dziesiętnej. Łańcuchy formatu mogą określać tylko format, który zawiera liczby. Na przykład nie można określić łańcucha formatu, takiego jak "%hh: %nn:%ss", ponieważ znak dwukropka (:) nie może być zapisany w upakowanej liczbie dziesiętnej. Następujące tokeny są poprawne dla konwersji do lub z wartości dziesiętnych:
%hh (two-digit hours using 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 one to six inclusive).
Literałowe cyfry od 0 do 9 są również poprawne.
Jeśli podany format zawiera mikrosekundy (na przykład %ss.4), to pozycja separatora dziesiętnego jest wywnioskowana w wartości dziesiętnej. Pozycja separatora dziesiętnego nie musi pokrywać się z określoną skalą liczby dziesiętnej (na przykład skala = 4).
Składnia
ds.TimeToDecimal(time (time), [format (string)])
zwraca: czas w formacie dziesiętnym.
Przykłady
Jeśli parametr mylink.mytime zawiera godzinę 20:06:58, wówczas następująca funkcja zwraca wartość dziesiętną 200658:
ds.TimeToDecimal(mylink.mytime)
Jeśli parametr mylink.mytime zawiera godzinę 20:06:58, wówczas następująca funkcja zwraca wartość dziesiętną 580620:
ds.TimeToDecimal(mylink.mytime, "%ss%nn%hh")
UniChar
Generuje pojedynczy znak Unicode w oparciu o wartość dziesiętną z zakresu od 0 do 65535.
Składnia
ds.UniChar(expression (int32))
zwraca: wynik łańcucha formatu.
Przykład
Poniższy kod zwróci "õ":
ds.UniChar(0x00F5)
UniSeq
Generuje wartość dziesiętną w oparciu o jeden znak Unicode.
Składnia
ds.UniSeq(expression (string))
zwroty: odpowiadająca mu liczba dziesiętna do znaku Unicode w formacie int32.
Przykład
Następujący kod zwróci 195:
ds.UniSeq("ä")
Łańcuch UstringTo
Zwraca łańcuch z podanego łańcucha ustring, opcjonalnie przy użyciu podanej mapy (w przeciwnym razie korzysta z mapy domyślnej projektu).
Składnia
ds.UstringToString(string (ustring), [mapname(string)])
zwroty: wynik w formacie łańcucha.
Przykłady
Jeśli mylink.myustring zawiera łańcuch ułańcuch "11052009", to następująca funkcja zwraca łańcuch "11052009":
ds.UstringToString(mylink.myustring)
Xtd
Przekształca łańcuch szesnastkowy w liczbę dziesiętną.
Składnia
ds.Xtd(hexadecimal (string))
zwraca: odpowiadającą mu wartość dziesiętną w postaci łańcucha szesnastego.
Przykład
Poniższy kod zwróci 48879:
ds.Xtd("beef")
Wew.
Zwraca część całkowitą wyrażenia. Wszystkie określone operacje arytmetyczne są obliczane przy użyciu pełnej dokładności systemu. Część ułamkowa tej wartości jest obcinana, a nie zaokrąglona, a pozostała część jest zwracana.
Składnia
ds.Int(expression (dfloat))
zwroty: wartość dziesiętna zaokrąglona i przekształcona w typ int64.
Przykład
Następujący kod zwróci wartość 454:
ds.Int(454.95)
Następujący kod zwróci 2:
ds.Int(2.35)
Funkcje daty i godziny
Te funkcje można wykorzystać w celu uzyskania danych i funkcji czasu w wyrażeniu.
Funkcje, które określają daty, godziny lub znaczniki czasu w argumentach, używają łańcuchów z konkretnymi formatami:
- W przypadku daty format jest następujący:
%yyyy-%mm-%dd - W danym momencie formatem jest
%hh:%nn:%ss. Jeśli rozszerzono o mikrosekundy, format jest następujący:%hh:%nn:%ss.x, gdzie x podaje liczbę miejsc po przecinku, do których jest podana liczba sekund. - W przypadku znacznika czasu format jest formatem daty, po którym następuje format godziny.
Funkcje, które mają dni tygodnia w argumencie, przyjmują łańcuch, który określa dzień tygodnia. Dzień jest określany jako trzyliterowy skrót lub pełna nazwa. Na przykład łańcuchy "thu" i "thursday" są poprawne.
CurrentDate
Zwraca datę uruchomienia zadania.
Składnia
ds.CurrentDate()
zwraca: bieżącą datę w formacie daty.
Przykłady
Użyj tej funkcji, aby uzyskać bieżącą datę.
ds.CurrentDate()
CurrentTime
Zwraca czas, w którym zadanie jest uruchamiane.
Składnia
ds.CurrentTime()
zwroty: bieżąca godzina w formacie czasu.
Przykłady
Użyj tej funkcji, aby uzyskać bieżący czas.
ds.CurrentTime()
CurrentTimeMS
Zwraca czas (w tym mikrosekundy), w którym uruchamiane jest zadanie.
Składnia
ds.CurrentTimeMS()
zwraca: bieżącą godzinę w formacie czasu, w tym mikrosekundy.
Przykłady
Ta funkcja służy do pobierania bieżącego czasu do danych wyjściowych.
ds.CurrentTimeMS()
CurrentTimestamp
Zwraca znacznik czasu, który określa datę i godzinę wykonania zadania.
Składnia
ds.CurrentTimestamp()
zwraca: bieżący znacznik czasu w formacie datownika.
Przykłady
Użyj tej funkcji, aby pobrać bieżący znacznik czasu do danych wyjściowych.
ds.CurrentTimestamp()
CurrentTimestampMS
Zwraca znacznik czasu (w tym mikrosekundy), który określa datę i godzinę wykonania zadania.
Składnia
ds.CurrentTimestampMS()
zwraca: bieżący znacznik czasu w formacie datownika.
Przykłady
Użyj tej funkcji, aby pobrać bieżący znacznik czasu do danych wyjściowych.
ds.CurrentTimestampMS()
Data
Zwraca pojedynczą wartość liczbową dni, jaka upłynęła między datą systemową wewnętrzną a datą 31 grudnia 1967 roku, która jest dniem 0. Wszystkie daty po numerach dodatnich reprezentują liczbę dni, które upłynęły od 0. Wszystkie daty przed dniem są liczbami ujemnymi reprezentującymi liczbę dni przed dniem 0.
Składnia
ds.Date()
zwraca: wynikowa data w formacie int.
Przykłady
Jeśli bieżąca data to 15 listopada 1967, poniższy kod zwraca wartość -46. Jeśli bieżąca data to 15 lutego 1968, poniższy kod zwraca wartość 46:
ds.Date()
DateFromDaysSince
Zwraca datę, dodając liczbę całkowitą do daty bazowej. Liczba całkowita może być ujemna w celu zwrócenia daty, która jest wcześniejsza niż data planu bazowego.
Składnia
ds.DateFromDaysSince(number (int32), [baseline_date_object (string)])
zwroty: data, przez dodanie liczby całkowitej do daty bazowej wprowadzonej przez użytkownika.
Przykłady
Jeśli mylink.myintcol zawiera liczbę całkowitą 18250, a mylink.mydatecol zawiera datę 1958-08-18, to trzy następujące funkcje są równoważne, a data zwraca datę 2008-08-05:
ds.DateFromDaysSince(18250,"1958-08-18")
ds.DateFromDaysSince(mylink.myintcol,"1958-08-18")
ds.DateFromDaysSince(mylink.myintcol,mylink.mydatecol)
Jeśli mylink.mynegintcol zawiera liczbę całkowitą -1, a mylink.mydatecol zawiera datę 1958-08-18, to następujące trzy funkcje są równoważne, a następnie zwróć datę 1958-08-17:
ds.DateFromDaysSince(-1,"1958-08-18")
ds.DateFromDaysSince(mylink.mynegintcol,"1958-08-18")
ds.DateFromDaysSince(mylink.mynegintcol,mylink.mydatecol)
DateFromDaysSince2
Zwraca datę, dodając liczbę całkowitą do daty bazowej. Liczba całkowita może być ujemna w celu zwrócenia daty, która jest wcześniejsza niż data planu bazowego.
Składnia
ds.DateFromDaysSince2(number (int32), [baseline_date_object (date)])
zwroty: data, przez dodanie liczby całkowitej do daty bazowej wprowadzonej przez użytkownika.
Przykłady
Jeśli mylink.myint zawiera liczbę całkowitą 18250, a mylink.mydate zawiera datę 1958-08-18, to trzy następujące funkcje są równoważne, a data zwraca datę 2008-08-05:
ds.DateFromDaysSince2(18250,"1958-08-18")
ds.DateFromDaysSince2(mylink.myint,"1958-08-18")
ds.DateFromDaysSince2(mylink.myint, mylink.mydate)
Jeśli mylink.mynegint zawiera liczbę całkowitą -1, a mylink.mydate zawiera datę 1958-08-18, to następujące trzy funkcje są równoważne, a następnie zwróć datę 1958-08-17:
ds.DateFromDaysSince2(-1,"1958-08-18")
ds.DateFromDaysSince2(mylink.mynegint,"1958-08-18")
ds.DateFromDaysSince2(mylink.mynegint, mylink.mydate)
Komponenty DateFrom
Zwraca datę z podanych lat, miesięcy i dnia miesiąca, która jest podana jako trzy oddzielne wartości.
Składnia
ds.DateFromComponents(years (int32), months (int32), dayofmonth (int32))
zwraca: pojedynczą datę z podanymi wartościami.
Przykłady
Jeśli mylink.year zawiera wartość 2010, mylink.month zawiera wartość 12, a mylink.dayofmonth zawiera wartość 2, wówczas dwie następujące funkcje są równoważne, a następnie zwróć datę 2010-12-02.
ds.DateFromComponents(2010, 12, 2)
ds.DateFromComponents(mylink.year, mylink.month, mylink.dayofmonth)
DateFromJulianDay
Zwraca datę z podanego numeru dnia juliańskiego.
Składnia
ds.DateFromJulianDay(julianday (uint32))
zwroty: data podana w dacie juliańskiej.
Przykłady
Jeśli wartość mylink.myjul zawiera wartość 2454614, to dwie następujące funkcje są równoważne i zwróć datę 2008-05-27.
ds.DateFromJulianDay(2454614)
ds.DateFromJulianDay(mylink.myjul)
DateOffsetByComponents
Zwraca podaną datę, z przesuniętymi przesuniętami z danego przesunięcia roku, przesunięcia miesiąca i przesunięcia dnia miesiąca, podane jako trzy oddzielne wartości. Wartości przesunięcia mogą być dodatnie, zerowe lub ujemne.
Składnia
ds.DateOffsetByComponents(basedate (date), year_offset (int32), month_offset (int32), dayofmonth_offset (int32))
zwroty: Dany przesunięcie daty w formacie daty.
Przykłady
Jeśli mylink.basedate zawiera 2011-08-18, a mylink.yearos zawiera wartość 2, mylink.monthos zawiera wartość 0, a mylink.dayofmonthosol zawiera wartość 0, wówczas dwie następujące funkcje są równoważne, a następnie zwróć datę 2013-08-18.
ds.DateOffsetByComponents("2011-08-18", 2, 0, 0)
ds.DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos)
Jeśli mylink.basedate zawiera wartości 2011-08-18, a mylink.yearos zawiera wartość -2, mylink.monthos zawiera wartość 0, a mylink.dayofmonthosol zawiera wartość 0, wówczas dwie następujące funkcje są równoważne, a następnie zwróć datę 2009-08-18.
ds.DateOffsetByComponents("2011-08-18", -2, 0, 0)
ds.DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos)
Dzień
Zwraca dzień miesiąca od daty systemowej.
Składnia
ds.Day()
zwroty: dzień miesiąca w formacie int.
Przykłady
Jeśli bieżąca data to 1967-12-31, następujący kod zwraca wartość 31.
ds.Day()
DaysSinceFromDate
Pobiera datę typu i datę źródłową typu łańcuchowego, a zwraca liczbę dni od daty źródłowej do podanej daty.
Składnia
ds.DaysSinceFromDate(given_date (date), source_date_string (string))
zwroty: różnica w dniach między dwoma datami podanymi w typie int32.
Przykłady
Jeśli mylink.mysourcedate zawiera datę 1958-08-18, a mylink.mygivendate zawiera datę 2008-08-18, to dwie następujące funkcje są równoważne, a następnie zwróć wartość całkowitą 18263.
ds.DaysSinceFromDate(mylink.mygivendate, mylink.mysourcedate)
ds.DaysSinceFromDate("2008-08-18","1958-08-18")
DaysSinceFromDate2
Pobiera datę typu daty i daty źródłowej typu date i zwraca liczbę dni od daty źródłowej do podanej daty.
Składnia
ds.DaysSinceFromDate2(given_date (date), source_date_object (date))
zwroty: różnica dni między dwoma podanymi datami w formacie int32 .
Przykłady
Jeśli mylink.mysourcedate zawiera datę 1958-08-18, a mylink.mygivendate zawiera datę 2008-08-18, to dwie następujące funkcje są równoważne, a następnie zwróć wartość całkowitą 18263.
ds.DaysSinceFromDate2(mylink.mygivendate, mylink.mysourcedate)
ds.DaysSinceFromDate2("2008-08-18","1958-08-18")
DaysInMiesiąc
Zwraca liczbę dni w miesiącu w danym dniu podstawowym.
Składnia
ds.DaysInMonth(basedate (date))
zwroty: liczba dni w miesiącu w formacie int32 .
Przykłady
Jeśli mylink.mysourcedate zawiera datę 1958-08-18, to dwie następujące funkcje są równoważne, a następnie zwracana jest wartość całkowita 31.
ds.DaysInMonth(mylink.mysourcedate)
ds.DaysInMonth("1958-08-18")
Rok DaysIn
Zwraca liczbę dni w roku w podanej dacie bazowej.
Składnia
ds.DaysInYear(basedate (date))
zwroty: liczba dni w roku w formacie int32 .
Przykłady
Jeśli właściwość mylink.mysourcedate zawiera datę 2012-08-18, to dwie następujące funkcje są równoważne i zwracają wartość całkowitą 366.
ds.DaysInYear(mylink.mysourcedate)
ds.DaysInYear("2012-08-18")
Jeśli właściwość mylink.mysourcedate zawiera datę 2011-08-18, to dwie następujące funkcje są równoważne i zwracają wartość całkowitą 365.
ds.DaysInYear(mylink.mysourcedate)
ds.DaysInYear("2011-08-18")
DateOffsetByDays
Zwraca podaną wartość przesunięcia daty o podaną liczbę dni. Wartość przesunięcia może być dodatnia, zerowa lub ujemna.
Składnia
ds.DateOffsetByDays(basedate (date), dayoffset (int32))
zwraca: obiekt daty z odpowiednim przesuniętym.
Przykłady
Jeśli mylink.basedate zawiera 2011-08-18, a mylink.dayoffset zawiera wartość 2, to dwie następujące funkcje są równoważne i zwróć datę 2011-08-20.
ds.DateOffsetByDays("2011-08-18", 2)
ds.DateOffsetByDays(mylink.basedate, mylink.dayoffset)
Jeśli właściwość mylink.basedate zawiera 2011-08-18, a mylink.dayoffset zawiera wartość -31, to dwie następujące funkcje są równoważne i zwracają datę 2011-07-18.
ds.DateOffsetByDays("2011-08-18", -31)
ds.DateOffsetByDays(mylink.basedate, mylink.dayoffset)
Czas HoursFrom
Zwraca porcję godzin w czasie.
Składnia
ds.HoursFromTime(time (time))
zwroty: wartość godziny w formacie int8 .
Przykłady
Jeśli parametr mylink.mytime zawiera godzinę 22:30:00, to następujące dwie funkcje są równoważne, a zwracana jest liczba całkowita 22.
ds.HoursFromTime(mylink.mytime)
ds.HoursFromTime("22:30:00")
JulianDayFromDate
Zwraca numer dnia juliańskiego od podanej daty.
Składnia
ds.JulianDayFromDate(time (time))
zwroty: numer dnia juliańskiego w formacie int32 , o podanej dacie.
Przykłady
Jeśli mylink.mydate zawiera datę 2008-05-27, to dwie następujące funkcje są równoważne, a następnie zwróć wartość 2454614.
ds.JulianDayFromDate("2008-05-27")
ds.JulianDayFromDate(mylink.mydate)
MicroSecondsFromTime
Zwraca mikrosekunda porcję czasu.
Składnia
ds.MicroSecondsFromTime(time (time))
zwroty: wartość mikrosekunda czasu w formacie int32 .
Przykłady
Jeśli serwer mylink.mytime zawiera godzinę 22:30:00.32, wówczas następująca funkcja zwraca wartość 320000:
ds.MicroSecondsFromTime(mylink.mytime)
MidnightSecondsFromTime
Zwraca liczbę sekund od północy do danego czasu.
Składnia
ds.MidnightSecondsFromTime(time (time))
zwraca: wartość sekund od północy do czasu, w formacie int8 .
Przykłady
Jeśli mylink.mytime zawiera godzinę 00:30:52, to dwie następujące funkcje są równoważne i zwróć wartość 1852:
ds.MidnightSecondsFromTime("00:30:52")
ds.MidnightSecondsFromTime(mylink.mytime)
MinutesFromCzas
Zwraca część czasu w minutach.
Składnia
ds.MinutesFromTime(time (time))
Zwraca: wartość minut czasu, w formacie int8 .
Przykłady
Jeśli parametr mylink.mytime zawiera godzinę 22:30:52, to dwie następujące funkcje są równoważne i zwracają wartość 30:
ds.MinutesFromTime("22:30:52")
ds.MinutesFromTime(mylink.mytime)
MonthDayFromDate
Zwraca dzień miesiąca od podanej daty.
Składnia
ds.MonthDayFromDate(date (date))
zwraca: dzień miesiąca od podanej daty w formacie int8 .
Przykłady
Jeśli mylink.mydate zawiera datę 2008-08-18, to dwie następujące funkcje są równoważne, a następnie zwróć wartość 18:
ds.MonthDayFromDate("2008-08-18")
ds.MonthDayFromDate(mylink.mydate)
Data MonthFrom
Zwraca numer miesiąca z podanej daty.
Składnia
ds.MonthFromDate(date (date))
zwroty: numer miesiąca w formacie int8.
Przykłady
Jeśli mylink.mydate zawiera datę 2008-08-18, to obie następujące funkcje zwracają wartość 8:
ds.MonthFromDate("2008-08-18")
ds.MonthFromDate(mylink.mydate)
Data WeekdayFrom
Zwraca liczbę dni tygodnia od podanej daty. Może określać dzień, który jest traktowany jako pierwszy w tygodniu, a jeśli nie zostanie podany, domyślnie jest to niedziela.
Składnia
ds.WeekdayFromDate(date (date), [origin_day (string)])
zwraca: dzień tygodnia od podanej daty w formacie int8 .
Przykłady
Jeśli mylink.mydate zawiera datę 2008-08-18, to dwie następujące funkcje są równoważne, a następnie zwróć wartość 1:
ds.WeekdayFromDate("2008-08-18")
ds.WeekdayFromDate(mylink.mydate)
Jeśli mylink.mydate zawiera datę 2008-08-18, a mylink.origin_day zawiera "soboty", to następujące funkcje są równoważne, a następnie zwróć wartość 2:
ds.WeekdayFromDate("2008-08-18", "saturday")
ds.WeekdayFromDate("2008-08-18", "sat")
ds.WeekdayFromDate(mylink.mydate, mylink.origin_day)
NextWeekdayFromDate
Zwraca datę określonego dnia tygodnia, która jest najwcześniejsza po dacie źródłowej. Dzień tygodnia jest określany jako pełna nazwa, na przykład czwartek, lub trzyliterowy skrót, na przykład "thu".
Składnia
ds.NextWeekdayFromDate(sourcedate (date), day_of_week (string))
zwroty: dzień miesiąca od podanej daty.
Przykłady
Jeśli mylink.mysourcedate zawiera datę 2008-08-18, a podano dzień tygodnia to czwartek, to dwie następujące funkcje są równoważne, a następnie zwróć wartość 2008-08-21:
ds.NextWeekdayFromDate("2008-08-18", "thursday")
ds.NextWeekdayFromDate(mylink.mysourcedate, "thu")
NthWeekdayFromDate
Zwraca datę określonego dnia tygodnia z przesuniętym o określoną liczbę tygodni od daty źródłowej. Dzień tygodnia jest określany jako pełna nazwa, na przykład czwartek, lub trzyliterowy skrót, na przykład thu. Wartości przesunięcia mogą być dodatnie, ujemne lub zerowe.
Składnia
ds.NthWeekdayFromDate(basedate (date), day_of_week (string), week_offset (int32))
zwraca: datę określonego przesunięcia w dzień powszedni według tygodni od podanej daty.
Przykłady
Jeśli mylink.mydate zawiera datę 2009-08-18, a w czwartek określono przesunięcie 1, to dwie następujące funkcje są równoważne, a następnie zwróć wartość 2009-08-20. Zwracane jest pierwsze wystąpienie czwartku. W przykładowym przykładzie czwartek występuje w tym samym tygodniu, co data 2009-08-18. Data 2009-08-18 to wtorek.
ds.NthWeekdayFromDate("2009-08-18", "thursday", 1)
ds.NthWeekdayFromDate(mylink.mydate, "thu", 1)
Jeśli mylink.mydate zawiera datę 2009-08-18, a w czwartek określono przesunięcie -2, to dwie następujące funkcje są równoważne, a następnie zwróć wartość 2009-08-06. Zwrócono uwagę w czwartek, czyli dwa czwartki z przeszłości.
ds.NthWeekdayFromDate("2009-08-18", "thursday", -2)
ds.NthWeekdayFromDate(mylink.mydate, "thu", -2)
PreviousWeekdayFromDate
Zwraca datę określonego dnia tygodnia, która jest najświeższą datą sprzed daty źródłowej. Dzień tygodnia jest określany jako pełna nazwa, na przykład czwartek, lub trzyliterowy skrót, na przykład "thu".
Składnia
ds.PreviousWeekdayFromDate(sourcedate (date), day_of_week (string))
zwroty: data ostatniego dnia powszedniego od podanej daty.
Przykłady
Jeśli parametr mylink.mysourcedate zawiera datę 2008-08-18 i czwartek, to dwie następujące funkcje są równoważne i zwracają wartość 2008-08-14:
ds.PreviousWeekdayFromDate("2008-08-18", "thursday")
ds.PreviousWeekdayFromDate(mylink.mysourcedate, "thu")
Czas SecondsFrom
Zwraca część czasu w sekundach.
Składnia
ds.SecondsFromTime(time (time))
zwraca: wartość sekundy w formacie dfloat.
Przykłady
Jeśli parametr mylink.mytime zawiera godzinę 22:30:52, to dwie następujące funkcje są równoważne i zwracają wartość 52:
ds.SecondsFromTime("22:30:52")
ds.SecondsFromTime(mylink.mytime)
SecondsSinceFromTimestamp
Zwraca liczbę sekund między dwoma obiektami znacznika czasu.
Składnia
ds.SecondsSinceFromTimestamp(timestamp (timestamp), timestamp_base_string (string))
zwroty: wartość sekund w formacie dfloat.
Przykłady
Jeśli mylink.mytimestamp zawiera znacznik czasu 2008-08-18 22:30:52, a mylink.mytimestamp_base zawiera znacznik czasu 2008-08-19 22:30:52, to dwie następujące funkcje są równoważne, a następnie zwróć wartość -86400:
ds.SecondsSinceFromTimestamp("2008-08-18 22:30:52","2008-08-19 22:30:52")
ds.SecondsSinceFromTimestamp(mylink.mytimestamp, mylink.mytimestamp_base)
SecondsSinceFromTimestamp2
Zwraca liczbę sekund między dwoma obiektami znacznika czasu.
Składnia
ds.SecondsSinceFromTimestamp2(time stamp (timestamp), timestamp_base_object (timestamp))
zwroty: wartość sekund w formacie dfloat.
Przykłady
Jeśli mylink.mytimestamp zawiera znacznik czasu 2008-08-18 22:30:52, a mylink.mytimestamp_base zawiera znacznik czasu 2008-08-19 22:30:52, to dwie następujące funkcje są równoważne, a następnie zwróć wartość -86400:
ds.SecondsSinceFromTimestamp2("2008-08-18 22:30:52","2008-08-19 22:30:52")
ds.SecondsSinceFromTimestamp2(mylink.mytimestamp, mylink.mytimestamp_base)
Czas
Zwraca wartość łańcuchową wyrażającą wewnętrzną porę dnia. Czas wewnętrzny to liczba sekund, które upłynęła od północy do najbliższej tysięcznej sekundy (czasu lokalnego).
Składnia
ds.Time()
zwraca: wynikowy czas łańcucha formatu.
Przykłady
Jeśli bieżąca godzina to 11:17:43:19, poniższy kod zwraca wartość 40663.842:
ds.Time()
TimeDate
Zwraca systemowy czas i datę jako sformatowany łańcuch.
Składnia
ds.TimeDate()
zwraca: czas systemowy i datę w formacie łańcucha.
Komponenty TimeFrom
Zwraca czas typu daty z podanych godzin, minut, sekund i mikrosekund jako int32.
Składnia
ds.TimeFromComponents(hours (int32), minutes (int32), seconds (int32), microseconds (int32))
zwraca: czas w typie daty.
Przykłady
Jeśli mylink.hourcol zawiera wartość 10, mylink.mincol zawiera wartość 12, mylink.seccol zawiera wartość 2, a mylink.mseccol zawiera wartość 0, to dwie następujące funkcje są równoważne i zwracają godzinę 10:12:02:
ds.TimeFromComponents(10, 12, 2, 0)
ds.TimeFromComponents(mylink.hourcol, mylink.mincol, mylink.seccol, mylink.mseccol)
TimeFromMidnightSeconds
Zwraca czas systemowy w formacie czasu.
Składnia
ds.TimeFromMidnightSeconds(seconds (time))
zwroty: sekundy od północy w formacie czasu.
Przykłady
Jeśli mylink.mymidnightseconds zawiera wartość 240, to dwie następujące funkcje są równoważne i zwróć wartość 00:04:00:
ds.TimeFromMidnightSeconds(240)
ds.TimeFromMidnightSeconds(mylink.mymidnightseconds)
TimeOffsetByComponents
Zwraca czas z przesunięciami zastosowanego od czasu podstawowego z przesuniętym godzinnym przesuniętym, minutowym przesunięciom i drugim przesunięciom, z których każda jest podana jako osobne wartości. Przesunięcie sekund może obejmować częściowe sekundy.
Składnia
ds.TimeOffsetByComponents(basetime (time), hour_offset (int32), minute_offset (int32), second_offset (dfloat))
zwraca: przesunięcie czasu wg określonych wartości.
Przykłady
Jeśli mylink.basetime zawiera wartość 14:05:29, a mylink.houros zawiera wartość 2, mylink.minos zawiera wartość 0, mylink.secos zawiera wartość 20, wówczas dwie następujące funkcje są równoważne, a następnie zwracaj godzinę 16:05:49.
ds.TimeOffsetByComponents("14:05:29", 2, 0, 20)
ds.TimeOffsetByComponents(mylink.basetime, mylink.houros, mylink.minos, mylink.secos)
TimeOffsetBySeconds
Zwraca podany czas z przesunięciami zastosowanego względem czasu podstawowego z przesuniętą w sekundach. Przesunięcie sekund może obejmować częściowe sekundy.
Składnia
ds.TimeOffsetBySeconds(basetime (time), second_offset (dfloat))
zwraca: czas z przesuniętą liczbą sekund określoną wartością.
Przykłady
Jeśli mylink.basetime zawiera 14:05:29.30 , a mylink.secos zawiera wartość 2.5, to dwie następujące funkcje są równoważne, a następnie zwracaj czas 14:05:31.
ds.TimeOffsetBySeconds("14:05:29.30", 2.5)
ds.TimeOffsetBySeconds(mylink.basetime, mylink.secos)
TimestampFromDateTime
Zwraca znacznik czasu z podanej daty i godziny.
Składnia
ds.TimestampFromDateTime(date (date), time (time))
zwraca: znacznik czasu danej daty i godziny.
Przykłady
Jeśli parametr mylink.mydate zawiera datę 2008-08-18, a mylink.mytime zawiera godzinę 22:30:52, to dwie następujące funkcje są równoważne i zwracają znacznik czasu 2008-08-18 22:30:52:
ds.TimestampFromDateTime("2008-08-18","22:30:52")
ds.TimestampFromDateTime(mylink.mydate, mylink.mytime)
TimestampFromSecondsSince
Zwraca znacznik czasu, który jest pochodną liczby sekund od podstawowego obiektu znacznika czasu.
Składnia
ds.TimestampFromSecondsSince(seconds (dfloat), [base_timestamp_object (string)])
zwraca: znacznik czasu obliczony na podstawie podanej wartości sekund.
Przykłady
Jeśli mylink.myseconds zawiera wartość 2563, a mylink.timestamp_base zawiera znacznik czasu 2008-08-18 22:30:52, to dwie następujące funkcje są równoważne i zwracają znacznik czasu 2008-08-18 23:13:35:
ds.TimestampFromSecondsSince(2563,"2008-08-18 22:30:52")
ds.TimestampFromSecondsSince(mylink.myseconds,mylink.timestamp_base)
TimestampFromSecondsSince2
Zwraca znacznik czasu, który jest pochodną liczby sekund od podstawowego obiektu znacznika czasu.
Składnia
ds.TimestampFromSecondsSince2(seconds (dfloat), [base_timestamp_object (timestamp)])
zwraca: znacznik czasu obliczony na podstawie podanej wartości sekund.
Przykłady
Jeśli mylink.myseconds zawiera wartość 2563, a mylink.timestamp_base zawiera znacznik czasu 2008-08-18 22:30:52, to dwie następujące funkcje są równoważne i zwracają znacznik czasu 2008-08-18 23:13:35:
ds.TimestampFromSecondsSince2(2563,"2008-08-18 22:30:52")
ds.TimestampFromSecondsSince2(mylink.myseconds, mylink.timestamp_base)
TimestampFrom-czas
Zwraca znacznik czasu z podanej wartości łańcuchowej systemu UNIX time_t .
Składnia
ds.TimestampFromTimet(timet_string (int32))
zwraca: znacznik czasu obliczony na podstawie podanej wartości sekund.
Przykłady
Jeśli parametr mylink.mytimet zawiera wartość 1234567890, to dwie następujące funkcje są równoważne i zwracają znacznik czasu 2009-02-13 23:31:30:
ds.TimestampFromTimet(1234567890)
ds.TimestampFromTimet(mylink.mytimet)
TimestampFromTime2
Zwraca znacznik czasu z podanych obiektów czasu i datownika. Wartość w obiekcie czasu nadpisuje wartość czasu w obiekcie znacznika czasu, tak aby od znacznika czasu używana była tylko część daty.
Składnia
ds.TimestampFromTime2(time (time), timestamp (timestamp))
zwraca: znacznik czasu z podanych obiektów czasu i datownika.
Przykłady
Jeśli mylink.mytime zawiera godzinę 12:03:22, a mylink.mytimestamp zawiera znacznik czasu 2008-08-18 22:30:52, to dwie następujące funkcje są równoważne i zwracają znacznik czasu 2008-08-18 12:03:22:
ds.TimestampFromTime2("12:03:22", "2008-08-18 22:30:52")
ds.TimestampFromTime2(mylink.mytime, mylink.mytimestamp)
TimestampOffsetByComponents
Zwraca znacznik czasu wraz z przesuniętami stosowanymi od podstawowego znacznika czasu z przesuniętym rokiem, przesunięcie miesiąca, przesunięcie dnia, przesunięcie godziny, przesunięcie minut i drugie przesunięcie, każde podane jako osobne wartości. Przesunięcie sekund może zawierać mikrosekundy.
Składnia
ds.TimestampOffsetByComponents(basetimestamp (timestamp), year_offset (int32), month_offset (int32), dayofmonth_offset (int32), hour_offset (int32), minute_offset (int32), second_offset (dfloat))
zwraca: przesunięcie znacznika czasu według określonych wartości.
Przykłady
Jeśli mylink.basetimestamp zawiera daty 2009-08-18 14:05:29, a mylink.yearos zawiera 0, mylink.monthos zawiera wartość 2, mylink.dayos zawiera wartość -4, mylink.houros zawiera wartość 2, mylink.minos zawiera wartość 0, mylink.secos zawiera wartość 20, a następnie dwie następujące funkcje są równoważne, a następnie zwraca znacznik czasu 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
Zwraca znacznik czasu z przesunięciami zastosowanego od podstawowego znacznika czasu z przesuniętą w sekundach. Przesunięcie sekund może zawierać mikrosekundy.
Składnia
ds.TimestampOffsetBySeconds(basetimestamp (timestamp), second_offset (dfloat))
zwraca: przesunięcie znacznika czasu wg określonych wartości w formacie znacznika czasu.
Przykłady
Jeśli parametr mylink.basetimestamp zawiera daty 2009-08-18 14:05:29, a mylink.secos zawiera wartość 32760, to dwie następujące funkcje są równoważne i zwracają znacznik czasu 2009-08-18 23:11:29:
ds.TimestampOffsetBySeconds("2009-08-18 14:05:29", 32760)
ds.TimestampOffsetBySeconds(mylink.basetimestamp, mylink.secos)
TimetFromDatownik
Zwraca wartość parametru time_t w systemie UNIX z podanego znacznika czasu.
Składnia
ds.TimetFromTimestamp(timestamp (timestamp))
zwroty: UNIX time_t przy użyciu znacznika czasu w formacie int32 .
Przykłady
Jeśli mylink.mytimestamp zawiera wartość 2009-02-13 23:31:30, to dwie następujące funkcje są równoważne, a następnie zwróć wartość 1234567890:
ds.TimetFromTimestamp("2009-02-13 23:31:30")
ds.TimetFromTimestamp(mylink.mytimestamp)
YeardayFromData
Zwraca liczbę dni w roku od podanej daty.
Składnia
ds.YeardayFromDate(date (date))
zwroty: numer dnia w formacie int16 .
Przykłady
Jeśli mylink.mydate zawiera datę 2008-08-18, to dwie następujące funkcje są równoważne i zwracają wartość 231:
ds.YeardayFromDate("2008-08-18")
ds.YeardayFromDate(mylink.mydate)
Data YearFrom
Zwraca rok z podanej daty.
Składnia
ds.YearFromDate(date (date))
zwroty: numer roku w formacie int16 .
Przykłady
Jeśli mylink.mydate zawiera datę 2008-08-18, to dwie następujące funkcje są równoważne, a następnie zwróć wartość 2008:
ds.YearFromDate("2008-08-18")
ds.YearFromDate(mylink.mydate)
YearweekFromData
Zwraca numer tygodnia w danym roku od podanej daty.
Składnia
ds.YearweekFromDate(date (date))
zwroty: numer tygodnia w formacie int16 .
Przykłady
Jeśli mylink.mydate zawiera datę 2008-08-18, to dwie następujące funkcje są równoważne, a następnie zwróć wartość 33:
ds.YearweekFromDate("2008-08-18")
ds.YearweekFromDate(mylink.mydate)
Miesiąc
Zwraca bieżący miesiąc.
Składnia
ds.Month()
zwroty: bieżący miesiąc.
Przykłady
Poniższy kod zwraca bieżący miesiąc w formacie int.
ds.Month()
Rok
Zwraca bieżący rok.
Składnia
ds.Year()
zwroty: bieżący rok w formacie int.
Przykłady
Poniższy kod zwraca bieżący rok.
ds.Year()
Funkcje logiczne
Funkcje logiczne wykonują operacje bitowe.
BitAnd
Zwraca bitowe AND z dwóch liczb całkowitych.
Składnia
ds.BitAnd(number1 (uint64), number2 (uint64))
zwraca: bitowe AND w formacie uint64 .
Przykłady
Jeśli parametr mylink.mynumber1 zawiera liczbę 352, a mylink.mynumber2 zawiera liczbę 400, to następujące dwie funkcje są równoważne, a następnie zwróć wartość 256:
ds.BitAnd(352,400)
ds.BitAnd(mylink.mynumber1, mylink.mynumber2)
BitCompress
Zwraca liczbę całkowitą wykonanego z argumentu łańcuchowego, który zawiera binarną reprezentację "1"s i" 0"s.
Składnia
ds.BitCompress(string (string))
zwraca: wynikowa liczba reprezentowana przez pliki binarne o formacie uint64.
Przykłady
Jeśli łańcuch mylink.mynumber1 zawiera łańcuch "0101100000", to oba poniższe funkcje zwracają liczbę 352.
ds.BitCompress("0101100000")
ds.BitCompress(mylink.mynumber)
BitExpand
Zwraca łańcuch zawierający binarną reprezentację w "1"s i" 0"s podanej liczby całkowitej.
Składnia
ds.BitExpand(number (uint64))
zwraca: łańcuch zawierający binarną reprezentację liczby całkowitej.
Przykłady
Jeśli parametr mylink.mynumber1 zawiera numer 352, to następujące dwie funkcje są równoważne, a następnie zwraca łańcuch "101100000".
ds.BitExpand(352)
ds.BitExpand(mylink.mynumber)
BitOr
Zwraca bitowe OR z dwóch liczb całkowitych.
Składnia
ds.BitOr(number1 (uint64), number2 (uint64))
zwraca: bitowe OR dwóch liczb całkowitych.
Przykłady
Jeśli parametr mylink.mynumber1 zawiera liczbę 352, a mylink.mynumber2 zawiera liczbę 400, to następujące dwie funkcje są równoważne, a następnie zwróć wartość 496:
ds.BitOr(352,400)
ds.BitOr(mylink.mynumber1, mylink.mynumber2)
BitXOr
Zwraca bitowe Exclusive OR z dwóch liczb całkowitych.
Składnia
ds.BitXOr(number1 (uint64), number2 (uint64))
zwraca: wartość Exclusive OR w formacie uint64 .
Przykłady
Jeśli mylink.mynumber1 zawiera liczbę 352, a mylink.mynumber2 zawiera liczbę 400, to następujące dwie funkcje są równoważne, a następnie zwracana jest wartość 240:
ds.BitXOr(352,400)
ds.BitXOr(mylink.mynumber1, mylink.mynumber2)
Nie
Zwraca dopełnienie logicznej wartości wyrażenia. Jeśli wartość wyrażenia ma wartość true, funkcja Not zwraca wartość false (0). Jeśli wartość wyrażenia ma wartość false (fałsz), funkcja NOT zwraca wartość true (1). Wyrażenie liczbowe, które jest wartościowane do wartości 0, jest wartością logiczną fałsz. Wyrażenie liczbowe, które jest wartościowane do innej wartości innej niż wartość NULL, jest logiczną prawdą. Pusty łańcuch jest logicznie fałszywy. Wszystkie pozostałe wyrażenia łańcuchowe, w tym łańcuchy, które zawierają pusty łańcuch, spacje lub liczbę 0 i spacje, są logicznie prawdziwe.
Składnia
ds.Not()
zwraca: wartość complement w formacie int8 .
Przykłady
Jeśli mylink.myexpression zawiera wyrażenie 5-5, to następujące dwie funkcje są równoważne, a następnie zwracają wartość 1:
ds.Not(5-5)
ds.Not(mylink.myexpression)
Jeśli mylink.myexpression zawiera wyrażenie 5 + 5, to następujące dwie funkcje są równoważne, a następnie zwróć wartość 0:
ds.Not(5+5)
ds.Not(mylink.myexpression)
SetBit
Zwraca liczbę całkowitą z konkretnymi bitami ustawionych do konkretnego stanu, gdzie origfield jest wartością wejściową do wykonania działania, bitlist jest łańcuchem zawierającym listę oddzielonych przecinkami numerów bitowych w celu ustawienia stanu, a bitstate ma wartość 1 lub 0, co wskazuje, który stan ma zostać ustawiony w tych bitach.
Składnia
ds.SetBit(origfield (uint64), bitlist (string), bitstate (uint8))
zwroty: liczba z bitami ustawionym na podany stan w formacie uint64 .
Przykłady
Jeśli mylink.origfield zawiera numer 352, mylink.bitlist zawiera listę "2,4,8", a mylink.bitstate zawiera wartość 1, to następujące dwie funkcje są równoważne, a następnie zwróć wartość 494:
ds.SetBit(356,"2,4,8",1)
ds.SetBit(mylink.origfield, mylink.bitlist, mylink.bitstate)
Prawdziwe
Zwraca wartość rzeczywistą 1.
Składnia
ds.True()
zwroty: liczba całkowita 1.
Przykłady
Następujący kod zwróci 1:
ds.True()
Fałszywe
Zwraca wartość false równą 0.
Składnia
ds.False()
zwroty: liczba całkowita 0.
Przykłady
Następujący kod zwróci wartość 0:
ds.False()
Funkcje mathmatical
Funkcje matematyczne wykonują operacje matematyczne.
ABS
Zwraca wartość bezwzględną dowolnego wyrażenia liczbowego. Wartość bezwzględna wyrażenia jest jego niepodpisaną wielkością.
Składnia
ds.Abs(numeric_expression (int32))
zwraca: wartość bezwzględną wyrażenia liczbowego w formacie dfloat.
Przykłady
Jeśli parametr mylink.number1 zawiera liczbę 12, a mylink.number2 zawiera liczbę 34, to następujące dwie funkcje są równoważne, a następnie zwraca liczbę 22:
ds.Abs(12-34)
ds.Abs(mylink.mynumber1-mylink.mynumber2)
Jeśli parametr mylink.number1 zawiera liczbę 34, a mylink.number2 zawiera liczbę 12, to następujące dwie funkcje są równoważne, a następnie zwraca liczbę 22:
ds.Abs(34-12)
ds.Abs(mylink.mynumber1-mylink.mynumber2)
ACOS
Służy do obliczania wartości trygonometrycznej arc-cosinus wyrażenia. Wyrażenie musi być wartością liczbową. Wynik jest wyrażony w radianach.
Składnia
ds.Acos(numeric_expression (dfloat))
zwroty: otrzymany radian w formacie dfloat.
Przykłady
Jeśli mylink.number zawiera liczbę 0.707106781, to dwie następujące funkcje są równoważne i zwróć wartość 0.7854:
ds.Acos(0.707106781)
ds.Acos(mylink.mynumber)
ACOS
Zwraca arcus cosinus trygonometryczny wyrażenia. Wartość wejściowa musi być wartością liczbową. Wynik jest wyrażony w stopniach.
Składnia
ds.ACOS(expression (float64))
zwraca: kąt w stopniach, format float64 .
Przykłady
Poniższy kod zwraca wartość 45:
ds.ACOS(0.707106781)
ASIN
Służy do obliczania wartości trigonometrycznej arc-sinus wyrażenia. Wyrażenie musi być wartością liczbową. Wynik jest wyrażony w radianach.
Składnia
ds.Asin(numeric_expression (dfloat))
zwroty: wynik radiany w formacie dfloat.
Przykłady
Jeśli mylink.number zawiera liczbę 0.707106781, to dwie następujące funkcje są równoważne i zwróć wartość 0.7854:
ds.Asin(0.707106781)
ds.Asin(mylink.mynumber)
ASIN
Zwraca trygonometryczny sinus wyrażenia. Wartość wejściowa jest kątem wyrażonym w stopniach.
Składnia
ds.ASIN(expression(float64))
zwraca: kąt w stopniach, format float64 .
Przykłady
Poniższy kod zwraca wartość 45:
ds.ASIN(0.707106781)
ATAN
Oblicza trygonometryczny arc-tangens wyrażenia. Wyrażenie musi być wartością liczbową. Wynik jest wyrażony w radianach.
Składnia
ds.Atan(numeric_expression (dfloat))
zwroty: wynik radiany w formacie dfloat.
Przykłady
Jeśli mylink.number zawiera liczbę 135, to następujące dwie funkcje są równoważne i zwracają wartość 1.5634, która jest kątem, który ma arcus tangens z 135:
ds.Atan(135)
ds.Atan(mylink.mynumber)
ATAN
Zwraca trigonometryczny arc-tangens wyrażenia. Wartość wejściowa musi być wartością liczbową. Wynik jest wyrażony w stopniach.
Składnia
ds.ATAN(expression(float64))
zwroty: kąt w stopniach, format dfloat.
Przykłady
Poniższy kod zwraca wartość 45:
ds.ATAN(1)
Atan2
Oblicza trygonometryczny arc-tangens dwóch zmiennych wejściowych, używając znaków dwóch wejść w celu określenia kwadrantu wyniku. Dane wejściowe muszą być wartościami liczbowymi. Wynik jest wyrażony w radianach.
Składnia
ds.Atan2(numeric_expression (dfloat, dfloat))
zwroty: wynik radiany w formacie dfloat.
Przykłady
Jeśli mylink.number1 zawiera liczbę 10.0 , a mylink.number2 zawiera numer -10.0, to następujące dwie funkcje są równoważne i zwróć wartość 2.3562:
ds.Atan2(10.0, -10.0)
ds.Atan2(mylink.mynumber1, mylink.mynumber2)
Ceil
Oblicza najmniejszą liczbę całkowitą większą lub równą podanej wartości dziesiętnej.
Składnia
ds.Ceil(number (dfloat))
zwroty: najmniejsza liczba całkowita w int32.
Przykłady
Jeśli parametr mylink.number zawiera numer 2355.66, to następujące dwie funkcje są równoważne, a następnie zwracana jest wartość 2356:
ds.Ceil(2355.66)
ds.Ceil(mylink.mynumber)
COS
Służy do obliczania wartości trygonometrycznej cosinus wyrażenia. Wyrażenie musi być wartością liczbową. Wyrażenie musi generować wartość liczbową, która jest kątem w radianach.
Składnia
ds.Cos(radians (dfloat))
zwroty: kąt w radianach, format dfloat.
Przykłady
Jeśli mylink.number zawiera liczbę 0.785398, to dwie następujące funkcje są równoważne i zwróć wartość 0.7071:
ds.Cos(0.785398)
ds.Cos(mylink.mynumber)
COS
Zwraca trygonometryczny cosinus kąta. Wyrażenie jest kątem wyrażonym jako wartość liczbowa w stopniach.
Składnia
ds.COS(expression(float64))
zwraca: kąt w stopniach, format float64 .
Przykłady
Poniższy kod zwraca wartość 0.7071:
ds.COS(45)
COSH
Służy do obliczania cosinusa hiperbolicznego wyrażenia. Wyrażenie musi być wartością liczbową.
Składnia
ds.Cosh(number (dfloat))
zwroty: otrzymana cosinus w formacie dfloat.
Przykłady
Jeśli mylink.number zawiera numer 2, to dwie następujące funkcje są równoważne i zwracają wartość 3.7622:
ds.Cosh(2)
ds.Cosh(mylink.mynumber)
Div
Służy do obliczania cosinusa hiperbolicznego wyrażenia. Wyrażenie musi być wartością liczbową.
Składnia
ds.Div(dividend (dfloat), divisor (dfloat))
zwroty: otrzymana cosinus w formacie dfloat.
Przykłady
Jeśli mylink.dividend zawiera liczbę 100, a mylink.divisor zawiera liczbę 25, to następujące dwie funkcje są równoważne, a następnie zwróć wartość 4:
ds.Div(100,25)
ds.Div(mylink.dividend, mylink.divisor)
Wyg.
Oblicza wynik podstawy e podniesiony do potęgi wyznaczonej przez wartość wyrażenia. Wartość e wynosi około 2.71828. Wyrażenie musi być wartościowane do wartości liczbowej.
Składnia
ds.Exp(number (dfloat))
zwraca: wynikowa wartość e podniesiona do podanej mocy w formacie dfloat.
Przykłady
Jeśli parametr mylink.number zawiera liczbę 5, to następujące dwie funkcje są równoważne i zwracają wartość 54.5982:
ds.Exp(5-1)
ds.Exp(mylink.number-1)
Fabs
Oblicza wartość bezwzględną danej wartości zmiennopozycyjnej.
Składnia
ds.Fabs(number (dfloat))
zwraca: wartość bezwzględną liczby zmiennopozycyjnej.
Przykłady
Jeśli parametr mylink.number zawiera numer -26.53, to następujące dwie funkcje są równoważne i zwracają wartość 26.53:
ds.Fabs(-26.53)
ds.Fabs(mylink.number)
Podstawa
Oblicza największą liczbę całkowitą mniejszą lub równą podanej wartości dziesiętnej.
Składnia
ds.Floor(number (dfloat))
zwraca: największą liczbę całkowitą mniejszą lub równą wartości dziesiętnej w formacie int32 .
Przykłady
Jeśli parametr mylink.number zawiera numer 203.25, to następujące dwie funkcje są równoważne i zwracają wartość 203:
ds.Floor(203.25)
ds.Floor(mylink.number)
Ldexp
Zwraca wartość dfloat z mnożenia mantysy przez 2 podniesione do potęgi wykładnika.
Składnia
ds.Ldexp(mantissa (dfloat), exponent (int32))
zwroty: otrzymany mantysa w formacie dfloat.
Przykłady
Jeśli mylink.mantissa zawiera liczbę 2, a mylink.exponent zawiera liczbę 3, to następujące dwie funkcje są równoważne, a następnie zwracają wartość 16:
ds.Ldexp(2,3)
ds.Ldexp(mylink.mantissa, mylink.exponent)
Llabs
Oblicza wartość bezwzględną podanej liczby całkowitej.
Składnia
ds.Llabs(number (integer))
zwraca: wartość bezwzględną podanej liczby całkowitej jako liczbę całkowitą bez znaku.
Przykłady
Jeśli parametr mylink.number zawiera liczbę -26, to następujące dwie funkcje są równoważne, a następnie zwraca wartość 26.
ds.Llabs(-26)
ds.Llabs(mylink.number)
Linia
Oblicza logarytm naturalny wyrażenia w bazie e. Wartość e wynosi około 2.71828. Wyrażenie musi być wartościowane do wartości liczbowej większej niż 0.
Składnia
ds.Ln(number (dfloat))
zwraca: wynikowa logarytm wyrażenia opartego na e .
Przykłady
Jeśli parametr mylink.number zawiera numer 6, to następujące dwie funkcje są równoważne i zwracają wartość 1.7918:
ds.Ln(6)
ds.Ln(mylink.number)
Log10
Zwraca logarytm w podstawie 10 z podanej wartości.
Składnia
ds.Log10(number (dfloat))
zwroty: wynikowa logarytm 10 logarytmu w formacie dfloat.
Przykłady
Jeśli mylink.number zawiera numer 6, to następujące dwie funkcje są równoważne, a następnie zwróć wartość 1.7782:
ds.Log10(6)
ds.Log10(mylink.number)
Maks.
Zwraca większą z dwóch wartości argumentów.
Składnia
ds.Max(number1 (int32), number2(int32))
zwraca: większą z dwóch liczb całkowitych w formacie int32 .
Przykłady
Jeśli mylink.number1 zawiera numer 6, a mylink.number1 zawiera numer 101, to następujące dwie funkcje są równoważne, a następnie zwróć wartość 101:
ds.Max(6,101)
ds.Max(mylink.number1, mylink.number2)
Min.
Zwraca niższą z dwóch wartości argumentów.
Składnia
ds.Min(number1 (int32), number2(int32))
zwraca: mniejszą z dwóch liczb całkowitych.
Przykłady
Jeśli mylink.number1 zawiera numer 6, a mylink.number1 zawiera numer 101, to następujące dwie funkcje są równoważne, a następnie zwróć wartość 6:
ds.Min(6,101)
ds.Min(mylink.number1, mylink.number2)
MOD
Oblicza modulo (pozostałą część) dwóch wyrażeń (dywidenda, dzielnik).
Składnia
ds.Mod(dividend (int32), divisor (int32))
zwroty: wynikowy modulo w formacie int32 .
Przykłady
Jeśli mylink.dividend zawiera liczbę 115, a mylink.divisor zawiera liczbę 25, to następujące dwie funkcje są równoważne, a następnie zwracają wartość 15:
ds.Mod(115,25)
ds.Mod(mylink.dividend, mylink.divisor)
Neg
Neguje liczbę.
Składnia
ds.Neg(number (dfloat))
zwroty: wynikowa liczba negowana w formacie dfloat.
Przykłady
Jeśli parametr mylink.number zawiera liczbę 123, to następujące dwie funkcje są równoważne, a następnie zwraca wartość -123:
ds.Neg(123)
ds.Neg(mylink.number)
Pwr
Oblicza wartość wyrażenia, gdy jest podniesiona do określonej potęgi (wyrażenie, potęga).
Składnia
ds.Pwr(expression (dfloat), power (dfloat))
zwraca: wynikowa liczba podniesiona do podanej mocy w formacie dfloat.
Przykłady
Jeśli parametr mylink.expression zawiera liczbę 2, a parametr mylink.power zawiera liczbę 3, to następujące dwie funkcje są równoważne i zwracają wartość 8:
ds.Pwr(2,3)
ds.Pwr(mylink.expression, mylink.power)
Rand
Zwraca pseudolosową liczbę całkowitą z zakresu od 0 do 232-1.
Składnia
ds.Rand()
zwroty: wynikowa losowa liczba całkowita w formacie uint32 .
Przykłady
Użyj tej funkcji, aby wygenerować pseudorandom numer:
ds.Rand()
Losowe
Zwraca pseudolosową liczbę całkowitą z zakresu od 0 do 232-1.
Składnia
ds.Random()
zwroty: wynikowa losowa liczba całkowita w formacie uint32 .
Przykłady
Użyj tej funkcji, aby wygenerować losową liczbę:
ds.Random()
Rnd
Generuje dowolną dodatnią lub ujemną losową liczbę całkowitą lub wartość 0. Pobiera jako dane wejściowe łączną liczbę liczb całkowitych, w tym 0, z których można wybrać liczbę losową. Oznacza to, że jeśli n jest wartością parametru numeric_expression, to liczba losowa jest generowana z liczby od 0 do (n-1).
Składnia
ds.Rnd(numeric_expression (int))
zwroty: losowy numer z zakresu od 0 do (numeric_expression - 1) w formacie int.
Przykłady
Poniższy kod zwraca liczbę losową z zakresu od 0 do 19.
ds.Rnd(20)
SIN
Służy do obliczania trygonometrycznej sinus wyrażenia. Wyrażenie musi być wartością liczbową. Wyrażenie musi generować wartość liczbową, która jest kątem w radianach.
Składnia
ds.Sin(radians (dfloat))
zwraca: wynikowy kąt w formacie dfloat.
Przykłady
Jeśli mylink.number zawiera liczbę 0.785398, to dwie następujące funkcje są równoważne i zwróć wartość 0.7071:
ds.Sin(0.785398)
ds.Sin(mylink.mynumber)
SIN
Zwraca trygonometryczny sinus wyrażenia. Wartość wejściowa jest kątem wyrażonym w stopniach.
Składnia
ds.SIN(expression(float64))
zwroty: kąt w stopniach, format dfloat.
Przykłady
Poniższy kod zwraca wartość 0.7071:
ds.SIN(45)
SINH
Oblicza sinus hiperboliczny wyrażenia. Wyrażenie musi być wartością liczbową.
Składnia
ds.Sinh(number (dfloat))
zwroty: otrzymana sinus w formacie dfloat.
Przykłady
Jeśli mylink.number zawiera numer 2, to dwie następujące funkcje są równoważne i zwracają wartość 3.6269:
ds.Sinh(2)
ds.Sinh(mylink.mynumber)
Sqrt
Służy do obliczania pierwiastka kwadratowego liczby.
Składnia
ds.Sqrt(number (dfloat))
zwraca: wynikowy pierwiastek kwadratowy z liczby w formacie dfloat.
Przykłady
Jeśli parametr mylink.number zawiera liczbę 450, to następujące dwie funkcje są równoważne i zwracają wartość 21.2132:
ds.Sqrt(450)
ds.Sqrt(mylink.mynumber)
Opalony
Służy do obliczania trygonometrycznego tangensa wyrażenia. Wyrażenie musi generować wartość liczbową, która jest kątem w radianach.
Składnia
ds.Tan(radians (dfloat))
zwroty: wynikowe tangens w formacie dfloat.
Przykłady
Jeśli parametr mylink.number zawiera liczbę 0.7853981, to następujące dwie funkcje są równoważne, a następnie zwracana jest wartość 1:
ds.Tan(0.7853981)
ds.Tan(mylink.mynumber)
TAN
Zwraca funkcję TAN, zwracając trygonometryczny tangens wejścia. Dane wejściowe reprezentują kąt wyrażony w stopniach.
Składnia
ds.TAN(expression(float64))
zwraca: kąt w stopniach, format float64 .
Przykłady
Poniższy kod zwraca wartość 1:
ds.TAN(45)
ATAN
Zwraca trigonometryczny arc-tangens wyrażenia. Wartość wejściowa musi być wartością liczbową. Wynik jest wyrażony w stopniach.
Składnia
ds.ATAN(expression(float64))
zwraca: kąt w stopniach, format float64 .
Przykłady
Poniższy kod zwraca wartość 45:
ds.ATAN(1)
TANH
Oblicza hiperboliczny tangens wyrażenia. Wyrażenie musi być wartością liczbową.
Składnia
ds.Tanh(number (dfloat))
zwroty: wynikowe tangens w formacie dfloat.
Przykłady
Jeśli mylink.number zawiera liczbę 2, to dwie następujące funkcje są równoważne, a zwracana jest wartość 0.964028:
ds.Tanh(2)
ds.Tanh(mylink.mynumber)
Funkcje liczb
Użyj funkcji numeracji, aby wyodrębnić mantysę z liczby dziesiętnej lub zmiennopozycyjnej. Kategoria Liczba w edytorze wyrażeń zawiera także funkcje rzutowania typów, których można używać do rzutowania liczb jako typów danych typu double, float lub integer.
Funkcje transformatora AsDouble(), AsFloat()i AsInteger() zachowują się inaczej niż inne funkcje konwersji danych transformatora, gdy są one używane w derywacjach, w których wynikiem jest łańcuch. Wynika to z faktu, że kompilator transformator nie przekształca wyniku funkcji dla tych funkcji na łańcuch.
AsDouble
Traktuj podaną liczbę jako podwójną.
Składnia
ds.AsDouble(number (int, float etc.))
zwroty: liczba w formacie dwukrotnym.
Przykłady
W poniższym wyrażeniu wejściowy mynumber zawiera liczbę całkowitą, ale funkcja zwraca liczbę zmiennopozycyjna podwójnej precyzji. Jeśli wartość mylink.mynumber zawiera wartość 56, to następujące dwie funkcje są równoważne, a następnie zwracana jest wartość 12.963:
ds.AsDouble(56/4.32)
ds.AsDouble(mylink.mynumber/4.32)
AsFloat
Traktuj daną liczbę jako liczbę zmiennopozycyjną.
Składnia
ds.AsFloat(number (int, double etc.))
zwroty: liczba w formacie liczby zmiennopozycyjnej.
Przykłady
W poniższym wyrażeniu wejście mynumber zawiera liczbę całkowitą, ale funkcja wyprowadza liczbę zmiennopozycyjną. Jeśli wartość mylink.mynumber zawiera wartość 56, to następujące dwie funkcje są równoważne, a następnie zwracana jest wartość 12.963:
ds.AsFloat(56/4.32)
ds.AsFloat(mylink.mynumber/4.32)
AsInteger
Traktuj podaną liczbę jako liczbę całkowitą. Jednak istnieje różnica w zachowaniu, gdy liczba dziesiętna jest przypisana do liczby całkowitej w porównaniu z liczbą zmiennopozycyjną lub podwójną przypisanymi do liczby całkowitej. Jeśli konwersja jest typu float lub double do liczby całkowitej, to jest to proste przypisanie do liczby całkowitej. W przypadku dziesiętnej partycji AsInteger()funkcja jest wywoływana i zaokrągla wynik w kierunku najbliższej wartości.
Składnia
ds.AsInteger(number (float, double etc.))
zwroty: liczba w formacie liczby całkowitej.
Przykłady
W poniższym wyrażeniu wartość wejściowa 12.962963 ma typ Double. Mimo że wartość jest typu Double, funkcja generuje liczbę całkowitą. Dlatego jest to proste przypisanie do liczby całkowitej i funkcja zwraca wartość 12:
ds.AsInteger(12.962963)
W poniższym wyrażeniu obliczenia, takie jak (56/4.32), są traktowane jako wywołanie funkcji typu Decimal, a wywołanie funkcji AsInteger() zaokrągla się do najbliższej wartości i zwraca wartość 13:
ds.AsInteger(56/4.32)
poprawka
Przekształca wartość liczbową w liczbę zmiennopozycyjną o określonym numerze precyzji. Jeśli liczba jest wartościowana do wartości NULL, zwracana jest wartość NULL. Wartość dokładności jest wartością liczbową, która odpowiada liczbie cyfr precyzji w liczbie zmiennoprzecinowej. Domyślna precyzja to 4. Wartość trybu jest flagą, która określa sposób obsługi nadmiaru cyfr. Jeśli tryb ma wartość 0 lub nie jest określony, nadmiarowe cyfry są zaokrąglane. Jeśli tryb ma wartość inną niż 0, nadmiarowe cyfry są obcinane.
Składnia
ds.FIX(numeric_expression (string), precision (int8), mode (int32))
zwroty: przekształcona liczba formatów dfloat.
Przykłady
Poniższy kod zwraca numer 37.7363.
ds.FIX("37.73629273")
MantissaFromLiczba dziesiętna
Zwraca mantysę z podanej liczby dziesiętnej.
Składnia
ds.MantissaFromDecimal(number (decimal))
zwroty: mantysa w formacie dfloat.
Przykłady
Jeśli parametr mylink.number zawiera numer 243.7675, to następujące dwie funkcje są równoważne i zwróć wartość 7675:
ds.MantissaFromDecimal(243.7675)
ds.MantissaFromDecimal(mylink.mynumber)
MantissaFromDFloat
Zwraca mantysę z podanej wartości dfloat.
Składnia
ds.MantissaFromDFloat(number (dfloat))
zwroty: mantysa w formacie dfloat.
Przykłady
Jeśli parametr mylink.number zawiera numer 1.234412000000000010E+4, wówczas następująca funkcja zwraca wartość 1:
ds.MantissaFromDFloat(mylink.mynumber)
BRL
Przekształca liczbę w łańcuchu w typ zmiennopozycyjny bez utraty dokładności.
Składnia
ds.Real(numeric_expression (string))
zwroty: przekształcona liczba formatów dfloat.
Przykłady
Poniższy kod zwraca numer 1.23.
ds.Real("1.23")
Surowe funkcje
Funkcja RAW umożliwia uzyskanie długości danych w kolumnie zawierającej dane surowe.
RawLength
Zwraca długość łańcucha surowego.
Składnia
ds.RawLength(input string (string))
zwraca: długość łańcucha surowego w formacie int32 .
Przykłady
Jeśli program mylink.rawdata zawiera dane surowe z mapy bitowej, wówczas następująca funkcja zwraca wielkość mapy bitowej w bajtach:
ds.RawLength(mylink.rawdata)
Funkcje łańcuchowe
Te funkcje są używane do wykonywania funkcji związanych z łańcuchem w wyrażeniu.
AlNum
Sprawdza, czy dany łańcuch zawiera tylko znaki alfanumeryczne.
Składnia
ds.AlNum(string (string))
zwroty: wynik typu int8 , 1, jeśli dane wejściowe są poprawne dla danego typu, a 0 w przeciwnym razie.
Przykład
Jeśli mylink.mystring1 zawiera łańcuch "OED_75_9*E", to następująca funkcja zwróci wartość 0 (false).
ds.AlNum(mylink.mystring1)
Jeśli mylink.mystring2 zawiera łańcuch "12redroses", to następująca funkcja zwróci wartość 1 (true).
ds.AlNum(mylink.mystring2)
Alfa
Sprawdza, czy dany łańcuch zawiera tylko znaki alfabetu.
Składnia
ds.Alpha(string (string))
zwroty: wynik typu int8 , 1, jeśli dane wejściowe są poprawne dla danego typu, a 0 w przeciwnym razie.
Przykłady
Jeśli mylink.mystring1 zawiera łańcuch "12redroses", to następująca funkcja zwróci wartość 0 (false).
ds.Alpha(mylink.mystring1)
Jeśli mylink.mystring2 zawiera łańcuch "dwunastej wersji dwunastej", to następująca funkcja zwróci wartość 1 (prawda).
ds.Alpha(mylink.mystring2)
Koty
Łączy dwa łańcuchy.
Składnia
ds.Cats(str1 (string), str2 (string))
zwroty: wynikowa konkatenowana łańcuch.
Przykłady
Poniższy kod zwraca wartość "ABC123".
ds.Cats("ABC", "123")
Zmiana
Zastępuje dany podłańcuch w wyrażeniu zastępujący łańcuch.
Jeśli argument podłańcucha jest pustym łańcuchem, zwracana jest wartość argumentu wyrażenia.
Jeśli wartość argumentu zastępczego jest łańcuchem pustym, usuwane są wszystkie wystąpienia podłańcucha rozpoczynające się od pozycji wskazanej przez wartość argumentu początkowego. Jeśli wartość argumentu wystąpienia jest mniejsza lub równa 0, zastępowane są wszystkie wystąpienia rozpoczynające się od pozycji wskazanej przez wartość argumentu początkowego. W przeciwnym razie liczba zastępowanych wystąpień jest wskazywaana przez wartość argumentu wystąpienia, począwszy od pozycji wskazanej przez wartość argumentu początkowego. Jeśli wartość argumentu begin jest mniejsza lub równa 1, zastępowanie rozpoczyna się od pierwszego wystąpienia. W przeciwnym razie zastępowanie rozpoczyna się od pozycji wskazanej przez wartość argumentu begin.
Składnia
ds.Change(expression (string), substring (string), replacement (string), [occurrence (int32), [begin (int32)]])
zwroty: nowy łańcuch ze wszystkimi zastępowanych podciągami.
Przykłady
Jeśli parametr mylink.mystring zawiera wyrażenie "aaabbbcccbbb", to następująca funkcja zwraca łańcuch "aaaZZZcccZZZ".
ds.Change(mylink.mystring,"bbb","ZZZ")
Jeśli mylink.mystring zawiera wyrażenie "ABC", a podłańcuch jest pusty, to następująca funkcja zwraca łańcuch "ABC".
ds.Change(mylink.mystring,"","ZZZ")
Jeśli mylink.mystring zawiera wyrażenie "aaabbbcccbbb", a zastępowanie jest puste, to następująca funkcja zwraca łańcuch "aaaccc".
ds.Change(mylink.mystring, "bbb", "")
Obszar CompactWhite
Zwraca łańcuch po zmniejszeniu wszystkich kolejnych białych znaków do jednej przestrzeni.
Składnia
ds.CompactWhiteSpace(string (string))
zwraca: wynikowy łańcuch z zmniejszoną białą spacjami.
Przykłady
Jeśli łańcuch mylink.mystring zawiera łańcuch "zbyt wiele spacji", wówczas następująca funkcja zwraca łańcuch "zbyt wiele obszarów":
ds.CompactWhiteSpace(mylink.mystring)
Porównaj
Porównuje dwa łańcuchy do sortowania. Porównanie może być wyrównane do lewej strony (ustawienie domyślne) lub wyrównane do prawej. Porównanie wyrównane do prawej porównuje podłańcuchy liczbowe w określonych łańcuchach jako liczby.
Łańcuchy liczbowe muszą występować w tej samej pozycji znaku w każdym łańcuchu. Na przykład porównanie łańcuchów AB100 i AB99 z prawej strony wskazuje, że wartość AB100 jest większa niż AB99 , ponieważ wartość 100 jest większa niż 99. Porównanie łańcuchów AC99 i AB100 wyrównane po lewej stronie wskazuje, że wartość AC99 jest większa od wartości B, ponieważ wartość C jest większa niż B.
Składnia
ds.Compare(string1 (string), string2 (string), [justification ("L" or "R")] )
zwroty: wynik typu int8 , -1, jeśli string1 jest mniejsze niż string2, 0, jeśli oba łańcuchy są takie same, 1, jeśli string1 jest większe od string2.
Przykłady
Jeśli mylink.mystring1 zawiera łańcuch "AB99", a łańcuch mylink.mystring2 zawiera łańcuch "AB100", to następująca funkcja zwraca wynik 1.
ds.Compare(mylink.mystring1, mylink.mystring2, "L")
Jeśli mylink.mystring1 zawiera łańcuch "AB99", a łańcuch mylink.mystring2 zawiera łańcuch "AB100", to następująca funkcja zwraca wynik -1.
ds.Compare(mylink.mystring1, mylink.mystring2, "R")
CompareNoPrzypadek
Porównuje dwa łańcuchy do sortowania, ignorując ich obserwacje.
Składnia
ds.CompareNoCase(string1 (string), string2 (string))
zwroty: wynik typu int8 , -1, jeśli string1 jest mniejsze od string2, 0, jeśli oba łańcuchy są takie same, oraz 1, jeśli string1 jest większe od string2.
Przykłady
Jeśli mylink.mystring1 zawiera łańcuch "Ciasto czekoladowe", a mylink.mystring2 zawiera łańcuch "ciasto czekoladowe", wówczas następująca funkcja zwraca wynik 0.
ds.CompareNoCase(mylink.mystring1, mylink.mystring2)
CompareNum
Porównuje pierwsze n znaków z dwóch łańcuchów, a n jest określane przez użytkownika.
Składnia
ds.CompareNum(string1 (string), string2 (string), length (int16))
zwroty: wynik typu int8 , -1, jeśli string1 jest mniejsze niż string2, 0, jeśli oba łańcuchy są takie same, 1, jeśli string1 jest większe od string2.
Przykłady
Jeśli mylink.mystring1 zawiera łańcuch "Czekolada", a mylink.mystring2 zawiera łańcuch "Choccy Treat", to następująca funkcja zwraca wynik 0.
ds.CompareNum(mylink.mystring1, mylink.mystring2,4)
CompareNumNoCase
Porównuje pierwsze n znaków dwóch łańcuchów, ignorując ich wielkość liter n , które są określane przez użytkownika.
Składnia
ds.CompareNumNoCase(string1 (string), string2 (string), length (int16))
zwroty: wynik typu int8 , -1, jeśli string1 jest mniejsze niż string2, 0, jeśli oba łańcuchy są takie same, 1, jeśli string1 jest większe od string2.
Przykłady
Jeśli łańcuch mylink.myraw zawiera łańcuch "czekolada", a mylink.mystring2 zawiera łańcuch "Choccy Treat", to następująca funkcja zwraca wynik 0.
ds.CompareNumNoCase(mylink.mystring1, mylink.mystring2,4)
Konwersja
Przekształca łańcuch w określony wewnętrzny lub zewnętrzny format pamięci masowej. Wyrażenie łańcuchowe wartościuje łańcuch, który ma zostać przekształcony.
W poniższej tabeli przedstawiono wartości, które można określić dla konwersji. conv_code określa typy formatów pamięci masowej, których dotyczy konwersja, a conv_mode określa, który format jest używany do wprowadzania danych lub danych wyjściowych. W przypadku określenia "I" dla conv_modefunkcja ICONV() jest używana do konwersji. Jeśli dla opcji conv_modezostanie podana wartość "O", funkcja OCONV() będzie używana do konwersji.
Tabela dla wartości konwersji
conv_code |
conv_mode |
Opis |
|---|---|---|
| MX | I | Przekształca łańcuch wejściowy z szesnastkowego na wartość dziesiętną. |
| MB | I | Przekształca łańcuch wejściowy z binarnego na dziesiętny. |
| MX0C | I | Przekształca łańcuch wejściowy z szesnastkowego na łańcuch znaków ASCII. |
| MB0C | I | Przekształca łańcuch wejściowy z binarnego na łańcuch znaków ASCII. |
| MX | O | Przekształca łańcuch wejściowy z liczby dziesiętnej na wartość szesnastkową. |
| MB | O | Przekształca łańcuch wejściowy z liczby dziesiętnej na binarny. |
| MX0C | O | Przekształca łańcuch wejściowy z łańcucha znaków ASCII na wartość szesnastkową. |
| MB0C | O | Przekształca łańcuch wejściowy z łańcucha znaków ASCII na binarny. |
Składnia
ds.Conversion(string (string), conv_code (string), conv_mode (string))
zwroty: przekształcony łańcuch.
Przykłady
Jeśli mylink.mystring zawiera łańcuch "1111", to następująca funkcja zwraca wartość 15.
ds.Conversion(mylink.mystring,"MB", "I")
Jeśli mylink.mystring zawiera łańcuch "CDE", wówczas następująca funkcja zwraca wartość 434445.
ds.Conversion(mylink.mystring,"MX0C", "O")
Przekształć
Przekształca znaki w łańcuchu, które jest wyznaczone w danym wyrażeniu. Przekształca znaki określone w jednej liście na znaki określone na innej liście.
Składnia
ds.Convert(fromlist (string), tolist (string), expression (string))
zwraca: łańcuch z przekształconym, wyznaczonym znakami.
Przykłady
Jeśli mylink.mystring1 zawiera łańcuch "TERAZ IS THE TIME", to następująca funkcja zwraca łańcuch "NOW YS XHE XYME".
ds.Convert("TI","XY", mylink.mystring1)
Liczebność
Zlicza, ile razy podłańcuch występuje w łańcuchu.
Składnia
ds.Count(string (string), substring (string))
zwraca: liczbę wystąpień podłańcucha w formacie int32 .
Przykłady
Jeśli mylink.mystring1 zawiera łańcuch "krople czekoladowe, lody czekoladowe, batony czekoladowe", wówczas następująca funkcja zwraca wartość 3.
ds.Count(mylink.mystring1, "choc")
BD.ILE.REKORDÓW
Zlicza wartości pól z ogranicznikami w łańcuchu.
Składnia
ds.Dcount(string (string), delimiter (string))
zwraca: liczbę pól z ogranicznikami w formacie int32 .
Przykłady
Jeśli mylink.mystring1 zawiera łańcuch "krople czekoladowe, lody czekoladowe, batony czekoladowe", wówczas następująca funkcja zwraca wartość 3.
ds.Dcount(mylink.mystring1,",")
DownCase
Zmienia wszystkie wielkie litery w łańcuchu na małe litery.
Składnia
ds.DownCase(string (string))
zwraca: wynikowy łańcuch w przypadku wszystkich małych liter.
Przykłady
Jeśli mylink.mystring1 zawiera łańcuch "CaMel cAsE", to następująca funkcja zwraca łańcuch "case camel case".
ds.DownCase(mylink.mystring1)
DQuote
Zawiera łańcuch znaków podwójnego cudzysłowu.
Składnia
ds.DQuote(string (string))
zwroty: wynikowy łańcuch ujęty w podwójny cudzysłów.
Przykłady
Jeśli łańcuch mylink.mystring1 zawiera znaki cudzysłowu, wówczas następująca funkcja zwraca łańcuch "needs quotes" (cudzysłowy).
ds.DQuote(mylink.mystring1)
Ereplace
Zastępuje podłańcuch w wyrażeniu z łańcuchem zastępczym.
Jeśli argument podłańcucha jest pustym łańcuchem, to wartość argumentu zastępczego jest poprzedzona wartością argumentu wyrażenia. Jeśli argument zastępujący jest pustym łańcuchem, usuwane są wszystkie wystąpienia podłańcucha rozpoczynające się od pozycji wskazanej przez wartość argumentu początkowego. Jeśli wartość argumentu wystąpienia jest mniejsza lub równa 0, zastępowane są wszystkie wystąpienia rozpoczynające się od wartości argumentu początkowego. W przeciwnym razie liczba zastępowanych wystąpień jest wskazywaana przez wartość argumentu wystąpienia, rozpoczynając od pozycji wskazaną przez wartość argumentu początkowego. Jeśli wartość argumentu begin jest mniejsza lub równa 1, zastępowanie rozpoczyna się od pierwszego wystąpienia. W przeciwnym razie zastępowanie rozpoczyna się od pozycji wskazanej przez wartość argumentu begin.
Składnia
ds.Ereplace(expression (string), substring (string), replacement (string), [occurrence (int32), [begin (int32)]])
zwraca: łańcuch wynikowy ze wszystkimi wystąpieniem zastąpionego podłańcucha.
Przykłady
Jeśli mylink.mystring zawiera wyrażenie "ABC", a podłańcuch jest pusty, następująca funkcja zwraca wartość "ZZZABC".
ds.Ereplace(mylink.mystring,"","ZZZ")
Jeśli parametr mylink.mystring zawiera wyrażenie "aaabbbcccbbb", a zastępowanie jest puste, następująca funkcja zwraca wartość aaaccc.
ds.Ereplace(mylink.mystring, "bbb", "")
Wymiana
Zastępuje znak w łańcuchu.
Składnia
ds.Exchange(str (string), findStr (string), replaceStr (string))
zwraca: wynikowy łańcuch z zastąpionym znakami.
Przykłady
Poniższy kod zwraca wartość: ".B.BC".
ds.Exchange("ABABC", "41", "2E")
EXTRACT
Dostęp do treści danych określonego pola, wartości lub podwartości z tablicy dynamicznej. Działa podobnie do REMOVE.
Wejściowa tablica dynamiczna musi mieć tylko CHAR (254), CHAR (253), CHAR (252) jako separatory i ich hierarchie, jak wcześniej. Mogą one być pobierane odpowiednio przez funkcje AM lub FM, VM, SM lub SVM. FM jest ogranicznikiem do pól łańcuchowych, VM jest ogranicznikiem wartości łańcuchów, a SM jest ogranicznikiem do podwartości łańcuchowych.
Więcej informacji na temat produktu EXTRACTzawiera sekcja EXTRACT function(Funkcja wyodrębniania).
Składnia
ds.EXTRACT(str (string), field (int64), [value (int64), subvalue (int64)])
zwraca: wynikowy wyodrębniony łańcuch łańcucha formatu.
Przykłady
Zwracany jest następujący kod: "9ü3ü5". Tablica dynamiczna zawiera 3 pola rozdzielone przez FM/AM, 2 wartości w pierwszym polu, 1 podwartość w pierwszej wartości itd.
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)
Poniższy kod zwraca pusty łańcuch, ponieważ istnieją tylko 3 pola, a nie 10 lub więcej.
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)
Pole
Zwraca jeden lub więcej podłańcuchów, które znajdują się między określonymi separatorami w łańcuchu. Wystąpienie argumentu określa, które wystąpienie separatora ma być używane jako terminator. Numer argumentu opcjonalnie określa liczbę podłańcuchów, które mają zostać zwrócone.
Składnia
ds.Field(string (string), delimiter (string), occurrence (int32), [number (int32)])
zwraca: odpowiedni łańcuch między separatorami.
Przykłady
Jeśli mylink.mystring1 zawiera łańcuch "krople czekoladowe, lody czekoladowe, batony czekoladowe, dyppery czekoladowe", wówczas następująca funkcja zwraca łańcuch " lody czekoladowe ".
ds.Field(mylink.mystring1,",",2)
Jeśli mylink.mystring1 zawiera łańcuch "krople czekoladowe, lody czekoladowe, batony czekoladowe, dyppery czekoladowe", wówczas następująca funkcja zwraca łańcuch " lody czekoladowe, batony czekoladowe ".
ds.Field(mylink.mystring1,",",2,2)
FieldStore
Modyfikuje łańcuchy znaków, wstawiając, usuwając lub zastępując pola rozdzielone określonym łańcuchem ograniczników. Łańcuch separatorów oznacza łańcuch, który ma zostać zmodyfikowany, i może być dowolnym pojedynczym znakiem ASCII. Przyjmuje również parametry start , które są pozycją łańcucha wejściowego, w którym rozpoczyna się modyfikacja, oraz number , co jest liczbą wystąpień nowego łańcucha wstawianego w łańcuchu wejściowym.
Składnia
ds.FieldStore(str (string), delimiter (string), start (int8), number (int8), new_fields (string))
zwraca: zmodyfikowany łańcuch łańcucha formatu.
Przykłady
Poniższy kod zwraca łańcuch A#B#C#D#5:
ds.FieldStore("1#2#3#4#5", "#", 1, 4, "A#B#C#D")
Fmt
Używa funkcji FMT lub wyrażenia formatowego do formatowania danych dla danych wyjściowych. Wyrażenie języka BASIC można sformatować dla danych wyjściowych, wykonując je za pomocą wyrażenia formatowanego. Szczegółowe informacje na temat składni funkcji Fmt można znaleźć w sekcji Funkcja FMT.
Składnia
ds.Fmt(string (string), format (string))
zwraca: wynikowe sformatowane dane w postaci łańcucha formatu.
Przykłady
Poniższy kod zwraca łańcuch "23-69-86":
ds.Fmt("236986","R##-##-##")
Poniższy kod zwraca liczbę "***** $555,666,898.00":
ds.Fmt("555666898","20*R2$,")
FmtDP
Przekształca wielobajtowe zestawy znaków łańcucha typu w format docelowy. Jeśli obsługa języków narodowych (National Language Support-NLS) nie jest włączona, funkcja FmtDP działa podobnie jak równoważna funkcja Fmt. Szczegółowe informacje na temat składni funkcji FmtDP można znaleźć w sekcji FunkcjaFmtDP.
Składnia
ds.FmtDP(string (string), format (string), [mapname (string)])
zwroty: przekształcony łańcuch łańcucha formatu.
Przykłady
Poniższy kod zwraca liczbę 56789:
ds.FmtDP("123456789","R#5")
Krotność
Służy do tworzenia łańcuchów w celu utworzenia podłańcuchów. łańcuch jest łańcuchem, który ma zostać złożony. length jest długością podłańcuchów znaków.
ds.Fold(str (string), length (int8))
zwraca: wynikowy łańcuch złożony.
Poniższy kod zwraca "THISþIS AþTESTþFOLDEþD STRþING".
ds.Fold("THIS IS A TEST FOLDED STRING", 5)
Folddp
W trybie obsługi języków narodowych (National Language Support-NLS): łańcuchy tworzą łańcuchy tworające podłańcuchy za pomocą znaków wyświetlania znaków.
Składnia
ds.Folddp(str (string), length (int), opmap (string))
zwraca: wynikowy łańcuch złożony.
Przykłady
Zostanie zwrócony następujący kod: "STOKROK ÞUNICOÞDE STEINGRING".
ds.Folddp("这里需要 UNICODE STRING", 5, "0")
Indeks
Znajduje początkową pozycję znaku podłańcucha. Wystąpienie argumentu określa, które wystąpienie podłańcucha ma być zlokalizowane.
Składnia
ds.Index(string (string), substring (string), occurrence (int32))
zwroty: wynik w formacie int32 liczby wystąpień.
Przykłady
Jeśli program mylink.mystring1 zawiera łańcuch "krople czekoladowe, lody czekoladowe, batony czekoladowe, dyppery czekoladowe", wówczas następująca funkcja zwraca wartość 18.
ds.Index(mylink.mystring1,"chocolate",2)
Strona lewa:
Zwraca liczbę n znaków z lewej strony łańcucha.
Składnia
ds.Left(string (string) number (int32))
zwróci wartość n znaków z lewej strony łańcucha.
Przykłady
Jeśli program mylink.mystring1 zawiera łańcuch "krople czekoladowe, lody czekoladowe, batony czekoladowe, dyppery czekoladowe", wówczas następująca funkcja zwraca łańcuch "czekolada".
ds.Left(mylink.mystring1,9)
DŁ
Zwraca długość łańcucha znaków.
Składnia
ds.Len(string (string))
zwraca: długość łańcucha w formacie int32 .
Przykłady
Jeśli mylink.mystring1 zawiera łańcuch "czekolada", wówczas następująca funkcja zwraca wartość 9.
ds.Len(mylink.mystring1)
Lendp
W trybie obsługi języków narodowych (National Language Support-NLS) zwraca długość łańcucha wraz z jego łączną pozycją wyświetlaną.
Składnia
ds.Lendp(str (string), opmap (string))
zwraca: długość łańcucha w formacie int64.
Przykłady
Zwracane są następujące kody: 19.
ds.Lendp("这里需要 UNICODE STRING", "0")
Dostosowanie
Preferowany odpowiednik MATCHES. Służy do porównywania wyrażenia łańcuchowego z wzorcem. Więcej informacji na temat składni komendy Match można znaleźć w sekcji Operator zgodności.
Składnia
ds.Match(str (string), pattern (string))
zwroty: wynik tego, czy wzorzec jest zgodny z łańcuchem wejściowym, w formacie boolowskim.
Przykłady
Następujący kod zwraca wartość false:
ds.Match("XYZ123AB", "3X3N")
Następujący kod zwraca wartość true:
ds.Match("XYZ123AB", "3X3N...")
MatchField
Przeszukuje łańcuch i zwraca część tego łańcucha, która jest zgodna z parametrem wejściowym pattern . Więcej informacji na temat składni komendy MatchField można znaleźć w sekcji Operator MATCH.
Składnia
ds.MatchField(str (string), pattern (string), field (int))
zwraca: wynik łańcucha formatu.
Przykłady
Poniższy kod zwraca łańcuch "XYZ":
ds.MatchField("XYZ123AB", "3X3N...", 1)
Liczba
Zwraca 1, jeśli łańcuch może zostać przekształcony w liczbę lub zwraca 0 w inny sposób.
Składnia
ds.Num(string (string))
zwróci wartość: 1, jeśli łańcuch może zostać przekształcony w liczbę lub zwraca 0 w inny sposób w formacie int32 .
Przykłady
Jeśli mylink.mystring1 zawiera łańcuch "22", to następująca funkcja zwraca wartość 1.
ds.Num(mylink.mystring1)
Jeśli mylink.mystring1 zawiera łańcuch "dwadzieścia dwa", to następująca funkcja zwraca wartość 0.
ds.Num(mylink.mystring1)
PadString
Zwraca łańcuch dopełniony określoną liczbą znaków dopełnienia.
Składnia
ds.PadString(string (string) padstring (string) padlength (int32))
zwraca: wynikowy łańcuch dopełniony.
Przykłady
Jeśli łańcuch mylink.mystring1 zawiera łańcuch "AB175", wówczas następująca funkcja zwraca łańcuch "AB17500000".
ds.PadString(mylink.mystring1,"0",5)
Usuń
Wyodrębnia i zwraca dynamiczne elementy tablicy rozdzielane separatorami systemowymi oraz w celu wskazania, który ogranicznik systemowy został znaleziony. Akceptuje on jeden znak typu CHAR jako ogranicznik i zwraca odpowiedni numer, w którym znaleziono ogranicznik.
| Liczba | Typ ogranicznika |
|---|---|
| 0 | Koniec łańcucha |
| 1 | Znak pozycji ASCII CHAR (255) |
| 2 | Znak pola ASCII CHAR (254) |
| 3 | Znak wartości ASCII CHAR (253) |
| 4 | Znak podwartości ASCII CHAR (252) |
| 5 | Znak tekstowy ASCII CHAR (251) |
| 6 | ASCII CHAR (250) (Niedostępne w wariancie PIOPEN) |
| 7 | ASCII CHAR (249) (Niedostępne w wariancie PIOPEN) |
| 8 | ASCII CHAR (248) (Niedostępne w wariancie PIOPEN) |
Więcej informacji na temat funkcji REMOVE zawiera sekcja Funkcja REMOVE.
Składnia
ds.REMOVE(str (string))
Zwraca: wynikowy łańcuch z ogranicznikami usunięci z listy łańcuchów formatu oraz numer odpowiadający ogranicznikom znalezionym.
Przykłady
Poniższy kod zwraca wartość [ "3", "12"].
ds.REMOVE("12" + ds.VM() + "12" + ds.VM())
Strona prawa:
Zwraca wartość n znaków z prawej strony łańcucha.
Składnia
ds.Right(string (string) number (int32))
zwroty: z prawej strony n znaków łańcucha.
Przykłady
Jeśli program mylink.mystring1 zawiera łańcuch "krople czekoladowe, lody czekoladowe, batony czekoladowe, rozpylacze czekoladowe", wówczas następująca funkcja zwraca łańcuch "dyppery".
ds.Right(mylink.mystring1,7)
Soundex
Zwraca kod identyfikujący zestaw słów, które są (w przybliżeniu) zarówno fonetycznie, jak i oparte na standardowym, otwartym algorytmie dla oceny SOUNDEX.
Składnia
ds.Soundex(string (string))
zwraca: kod identyfikujący zestaw słów fonetycznie.
Przykłady
Jeśli łańcuch mylink.mystring1 zawiera łańcuch "Griffin", to następująca funkcja zwraca kod "G615".
ds.Soundex(mylink.mystring1)
Jeśli program mylink.mystring1 zawiera łańcuch "Griphin", wówczas następująca funkcja zwraca kod "G615".
ds.Soundex(mylink.mystring1)
Miejsce
Zwraca łańcuch n znaków spacji.
Składnia
ds.Space(length (int32))
zwraca: łańcuch białych znaków o określonej długości.
Przykłady
Jeśli mylink.mylength zawiera liczbę 100, to poniższa funkcja zwraca łańcuch zawierający 100 znaków spacji.
ds.Space(mylink.mylength)
Cytuj
Zawiera łańcuch w pojedynczych cudzysłowach.
Składnia
ds.SQuote(string (string))
zwroty: łańcuch ujęty w pojedynczy cudzysłów.
Przykłady
Jeśli łańcuch mylink.mystring1 zawiera znaki cudzysłowu, to poniższa funkcja zwraca łańcuch "needs quotes" (cudzysłowy).
ds.SQuote(mylink.mystring1)
STR
Powtarza określoną liczbę razy łańcuch.
Składnia
ds.Str(string (string), repeats (int32))
zwraca: wynikowy łańcuch powtórzony n razy.
Przykłady
Jeśli łańcuch mylink.mystring1 zawiera łańcuch potrzeb "choc", to następująca funkcja zwraca łańcuch "chocchocchocchocchoc".
ds.Str(mylink.mystring1,5)
Obszar StripWhite
Zwraca łańcuch po usunięciu z niego wszystkich białych znaków spacji.
Składnia
ds.StripWhiteSpace(string (string))
zwraca: łańcuch bez białych znaków.
Przykłady
Jeśli mylink.mystring zawiera łańcuch "zbyt wiele spacji", to następująca funkcja zwraca łańcuch "toomanyspaces":
ds.StripWhiteSpace(mylink.mystring)
Podłańcuch
Zwraca określony podłańcuch.
Jeśli zostanie podana wartość n , funkcja pobiera ostatnie n znaków łańcucha.
Jeśli określono start i length , funkcja pobiera znaki o długości równej length począwszy od pozycji start łańcucha.
Jeśli określono separator , funkcja pobiera jeden lub więcej podłańcuchów znajdujących się między określonymi separatorami w łańcuchu. occu to liczba ograniczników, a num jest długością podłańcucha między separatorami w wynikowym podłańcuchu.
Składnia
ds.Substring(string (string), n (int8))
ds.Substring(string (string), start (int8), length (int8))
ds.Substring(string (string), delimiter (string), occu (int8), num (int8))
zwraca: wynikowa tablica podłańcuchów w łańcuchu formatu.
Przykłady
Poniższy kod zwraca "ab.cd".
ds.Substring("ab.cd", ".", 1, 2)
Podłańcuchy
Tworzy tablicę dynamiczną, której wszystkie elementy są podłańcuchami odpowiednich elementów tablicy dynamicznej wejściowej.
Składnia
ds.Substrings(str (string), start (int8), length (int8))
zwraca: wynikowa tablica dynamiczna z podciągami odpowiadania tablicy wejściowej, format łańcuchowy.
Przykłady
Poniższy kod zwraca wartość "NESýITHþ23üý50ü".
ds.Substrings("JONESýSMITHþ1.23ü20ý2.50ü10", 3, 20)
Przytnij
Usuwa wszystkie wiodące i końcowe spacje i tabulatory. Funkcja redukuje również wewnętrzne wystąpienia spacji lub tabulacji do jednego.
Argument stripchar może opcjonalnie określić znak inny niż spacja lub tabulator. Argument options (opcjonalnie) określa typ operacji trim, która ma zostać wykonana i zawiera jedną lub więcej z następujących wartości:
A: Usuń wszystkie wystąpienia stripchar.
B Usuń zarówno początkowe, jak i końcowe wystąpienia strippchar.
D Usuń czołowe, końcowe i nadmiarowe znaki biało-przestrzenie.
E Usuń końcowe znaki spacji.
F Usuń czołowe znaki biało-przestrzenie.
L Usuń wszystkie początkowe wystąpienia stripchar.
R Usuń początkowe, końcowe i nadmiarowe wystąpienia strippchar.
T Usuń wszystkie końcowe wystąpienia stripchar.
Składnia
ds.Trim(string (string), [stripchar (string)], [options (string)])
zwroty: łańcuch przyciskany.
Przykłady
Jeśli mylink.mystring zawiera łańcuch " String with whitespace ", then the następująca funkcja zwraca łańcuch" String with whitespace ":
ds.Trim(mylink.mystring)
Jeśli mylink.mystring zawiera łańcuch " ..Usuń .. nadmiarowe .. kropki .... ", Następnie następująca funkcja zwraca łańcuch "Remove.redundant.dots":
ds.Trim(mylink.mystring,".")
Jeśli mylink.mystring zawiera łańcuch "Usuń .. all.. dots....", Następnie następująca funkcja zwraca łańcuch "Removealldots":
ds.Trim(mylink.mystring,".","A")
Jeśli mylink.mystring zawiera łańcuch "Usuń .. trailing.. dots....", wtedy następująca funkcja zwraca łańcuch "Remove .. trailing.. dots":
ds.Trim(mylink.mystring,".","T")
TrimB
Usuwa wszystkie końcowe spacje i tabulatory z łańcucha.
Składnia
ds.TrimB(string (string))
zwroty: łańcuch przyciskany.
Przykłady
Jeśli łańcuch mylink.mystring zawiera łańcuch "zbyt wiele spacji końcowych", wówczas następująca funkcja zwraca łańcuch "zbyt wiele spacji końcowych":
ds.TrimB(mylink.mystring)
TrimF
Usuwa wszystkie wiodące spacje i tabulatory z łańcucha.
Składnia
ds.TrimF(string (string))
zwroty: łańcuch przyciskany.
Przykłady
Jeśli mylink.mystring zawiera łańcuch " zbyt wiele początkowych spacji ", a następnie następująca funkcja zwraca łańcuch" zbyt wiele początkowych spacji ":
ds.TrimF(mylink.mystring)
TrimLeadingTrailing
Usuwa wszystkie wiodące i końcowe spacje i tabulatory z łańcucha.
Składnia
ds.TrimLeadingTrailing(string (string))
zwroty: łańcuch przyciskany.
Przykłady
Jeśli mylink.mystring zawiera łańcuch " zbyt wiele spacji ", a następnie następująca funkcja zwraca łańcuch" zbyt wiele spacji ":
ds.TrimLeadingTrailing(mylink.mystring)
UpCase
Zmienia wszystkie małe litery w łańcuchu na wielkie.
Składnia
ds.UpCase(string (string))
zwraca: łańcuch wynikowy we wszystkich wielkich przypadkach.
Przykłady
Jeśli łańcuch mylink.mystring1 zawiera łańcuch "CaMel cAsE", wówczas następująca funkcja zwraca łańcuch "CAMEL CASE":
ds.UpCase(mylink.mystring1)
Wiadomości błyskawiczne
Zwraca CHAR (255). Działa tak samo jak w przypadku AM.
Składnia
ds.IM()
zwraca: wynikowy CHAR (255).
Przykłady
Poniższy kod zwraca wartość '%s'.
ds.IM()
FM
Zwraca CHAR (254).
Składnia
ds.FM()
zwroty: wynikowy CHAR (254).
Przykłady
Poniższy kod zwraca 'þ'.
ds.FM()
przed południem
Zwraca CHAR (254). Działa tak samo jak FM.
Składnia
ds.AM()
zwroty: wynikowy CHAR (254).
Przykłady
Poniższy kod zwraca 'þ'.
ds.AM()
Maszyna wirtualna
Zwraca CHAR (253).
Składnia
ds.VM()
zwroty: wynikowe CHAR (253).
Przykłady
Poniższy kod zwraca wartość 'ý'.
ds.VM()
SM
Zwraca CHAR (252). Działa tak samo jak SVM.
Składnia
ds.SM()
zwroty: wynikowy CHAR (252).
Przykłady
Poniższy kod zwraca 'ü'.
ds.SM()
SVM
Zwraca CHAR (252). Działa tak samo jak SM.
Składnia
ds.SVM()
zwroty: wynikowy CHAR (252).
Przykłady
Poniższy kod zwraca 'ü'.
ds.SVM()
TM
Zwraca CHAR (251).
Składnia
ds.TM()
zwroty: wynikowy CHAR (251).
Przykłady
Poniższy kod zwraca wartość 'û'.
ds.TM()
Funkcje narzędziowe
Funkcje programu narzędziowego określają różne cele związane z pobieraniem informacji o konkretnych funkcjach DataStage .
ElementAt
Zwraca element z listy określonej przez indeks.
Składnia
ds.ElementAt(list (object))
zwraca: indeks elementu obiektu formatu.
Przykłady
Poniższy kod zwraca 'b':
ds.ElementAt(["a","b","c"], 1)
Poniższy kod zwraca wartość 2:
ds.ElementAt([1,2,3], 1)
GetCommandNazwa
Pobiera identyfikator węzła działania Uruchom skrypt Bash, a następnie pobiera nazwę komendy działania skryptu Uruchom skrypt bash.
Składnia
ds.GetCommandName(tasks.activity_id (string))
zwraca: nazwę komendy w postaci łańcucha formatu.
Przykłady
Poniższy kod zwraca nazwę komendy run_bash_script_5zadania:
ds.GetCommandName(tasks.run_bash_script_5)
Dane wyjściowe GetCommand
Pobiera identyfikator węzła działania Uruchom skrypt Bash i pobiera jego standardowe wyjście. Jest on równoważny z wyrażeniem CEL:
tasks.<activity_id>.results.standard_output
Składnia
ds.GetCommandOutput(tasks.activity_id (string))
zwraca: standardowe wyjście łańcucha formatu.
Przykłady
Poniższy kod zwraca standardowe wyjście zadania run_bash_script_5:
ds.GetCommandOutput(tasks.run_bash_script_5)
Komunikat GetError
Dane wyjściowe są używane tylko w zadaniu w procedurze obsługi wyjątków. Dane wyjściowe to tekst komunikatu, który będzie rejestrowany jako ostrzeżenie, gdy wyjątek zostanie zgłoszony.
Składnia
ds.GetErrorMessage()
zwroty: wynikowa wiadomość o łańcuchu formatu.
Przykłady
Następujący kod zwraca komunikat o błędzie dla zadania zakończonego niepowodzeniem:
ds.GetErrorMessage()
GetErrorLiczba
Wartość wyjściowa używana w zadaniu tylko w procedurze obsługi wyjątków jest liczbą całkowitą wskazaną na typ wywoływanego błędu. Wartość 1 lub -1.
Wartość 1 wskazuje, że zadanie zostało uruchomione przez zadanie, które zostało przerwane i nie zostało skonfigurowane żadne konkretne procedury obsługi.
Wartość -1 wskazuje, że wykonanie zadania nie powiodło się z innych przyczyn.
Składnia
ds.GetErrorNumber()
zwraca: wynikowa liczba całkowita w formacie int.
Przykłady
Poniższy kod zwraca numer błędu typu działania procedury obsługi wyjątków:
ds.GetErrorNumber()
GetErrorŹródło
Dane wyjściowe używane w zadaniu tylko w procedurze obsługi wyjątku są nazwą pomostową etapu działania, który zgłosił wyjątek.
Składnia
ds.GetErrorSource()
zwraca: wynikowa wartość zadania w postaci łańcucha formatu.
Przykłady
Następujący kod zwraca zadanie, które zakończyło się niepowodzeniem:
ds.GetErrorSource()
GetJobNazwa
Zwraca nazwę zadania uruchomionego działania DataStage w momencie wykonywania funkcji. Jest on równoważny z wyrażeniem CEL:
tasks.<activity_id>.results.job_name
Składnia
ds.GetJobName(tasks.activity_id (string))
zwraca: nazwę zadania w postaci łańcucha formatu.
Przykłady
Poniższy kod zwraca nazwę zadania run_datastage_flow_1:
ds.GetJobName(tasks.run_datastage_flow_1)
Status GetJob
Pobiera identyfikator węzła działania "Uruchom DataStage " i pobiera jego status zadania dla <activity_name>.$JobStatus. Jest on równoważny z następującym wyrażeniem:
((tasks.<activity_id>.results.status == 'Completed') ? 1 : ((tasks.<activity_id>.results.status == 'CompletedWithWarnings') ? 2 : ((tasks.<activity_id>.results.status == 'Cancelled') ? 96 : 3)))
Składnia
ds.GetJobStatus(tasks.activity_id (string))
zwraca: status zadania w formacie int.
Przykłady
Następujący kod zwraca status zadania run_datastage_flow_1:
ds.GetJobStatus(tasks.run_datastage_flow_1)
Licznik GetList
Użyte w zadaniu w pętli tylko z licznikiem listy, wartością wyjściową jest bieżąca wartość zmiennej licznika.
Składnia
ds.GetListCounter()
zwraca: wynikowa wartość licznika łańcucha formatu.
Przykłady
Poniższy kod zwraca bieżącą wartość pętli.
ds.GetListCounter()
Licznik GetNumeric
Użyte w zadaniu w pętli tylko z licznikiem numerycznym, wyjściem jest bieżąca wartość zmiennej przeciwstawnej pętli.
Składnia
ds.GetNumericCounter()
zwraca: wynikowa wartość licznika w formacie int.
Przykłady
Poniższy kod zwraca bieżącą wartość pętli.
ds.GetNumericCounter()
GetOutputArg
Zwraca określoną wartość klucza z danych wejściowych JSON typu łańcuchowego.
Składnia
ds.GetOutputArg(JSON (string), key_value (string))
zwraca: wartość pola właściwości.
Przykłady
Poniższy kod zwraca wartość łańcuchową "tom":
ds.GetOutputArg("{"name":"tom"}", "name")
GetReturnWartość
Pobiera identyfikator węzła działania Run Bash Script activity (Uruchom skrypt Bash Script) i zwraca wartość działania Uruchom skrypt Bash Script. Jest on równoważny z następującym wyrażeniem CEL:
tasks.<activity_id>.results.return_value
Składnia
ds.GetReturnValue(tasks.activity_id (string))
zwraca: wynikowa wartość zadania w formacie int.
Przykłady
Następujący kod zwraca wartość zadania tasks.run_bash_script_5:
ds.GetReturnValue(tasks.run_bash_script_5)
Status GetUser
Pobiera identyfikator zadania przepływu DataStage i zwraca status zadania przepływu DataStage w zadaniu kolejowym. Nie działa, jeśli jest uruchamiane w zadaniu równoległym. Jest on równoważny z wyrażeniem CEL:
tasks.<activity_id>.results.user_status
Składnia
ds.GetUserStatus(tasks.run_datastage_id (string))
zwraca: status identyfikatora zadania przepływu DataStage w łańcuchu formatu.
Przykłady
Następujący kod zwraca wartość identyfikatora zadania run_datastage_5:
ds.GetUserStatus(tasks.run_datastage_5)
LogName
Zwraca nazwę użytkownika bieżącego użytkownika.
Składnia
ds.LogName()
zwraca: nazwę użytkownika bieżącego użytkownika w postaci łańcucha formatu.
Przykłady
Poniższy kod zwraca nazwę użytkownika bieżącego użytkownika.
ds.LogName()
Ścieżka
Zwraca nazwę ścieżki bieżącego użytkownika.
Składnia
ds.Path()
zwraca: nazwę ścieżki bieżącego użytkownika łańcucha formatu.
Przykłady
Poniższy kod zwraca nazwę ścieżki bieżącego użytkownika.
ds.Path()
Schemat
Zwraca nazwę schematu bieżącego użytkownika.
Składnia
ds.Schema()
zwraca: nazwę schematu bieżącego użytkownika łańcucha formatu.
Przykłady
Poniższy kod zwraca nazwę schematu bieżącego użytkownika.
ds.Schema()
UserNo
Zwraca numer użytkownika bieżącego użytkownika.
Składnia
ds.UserNo()
zwraca: informacje o użytkowniku bieżącego użytkownika w formacie int.
Przykłady
Poniższy kod zwraca numer użytkownika bieżącego użytkownika.
ds.UserNo()
Kto
Zwraca bieżącego użytkownika.
Składnia
ds.Who()
zwraca: bieżący użytkownik łańcucha formatu.
Przykłady
Poniższy kod zwraca bieżącego użytkownika.
ds.Who()
Funkcje obsługi wartości NULL
Funkcje, które mają pustą obsługę.
IsNull
Zwraca wartość true, gdy wyrażenie wejściowe jest wartościowane do wartości NULL.
Składnia
ds.IsNull(input (any))
zwroty: wynik tego, czy wyrażenie jest wartościowane do wartości NULL, w formacie boolowskim.
Przykłady
Następujący kod zwraca wartość true.
ds.IsNull(null)
Poniższy kod zwraca wartość false.
ds.IsNull(0)
isNotNull (ma wartość inną niż NULL)
Zwraca wartość true, gdy wyrażenie wejściowe nie jest wartościowane do wartości NULL.
Składnia
ds.IsNotNull(input (any))
zwroty: wynik tego, czy wyrażenie nie jest wartościowane do wartości NULL, w formacie boolowskim.
Przykłady
Poniższy kod zwraca wartość false.
ds.IsNotNull(null)
Następujący kod zwraca wartość true.
ds.IsNotNull(0)
Null
Zwraca wartość null.
Składnia
ds.Null()
zwraca: wartość null.
Przykłady
Następujący kod zwraca wartość NULL.
ds.Null()
NullToPuste
Zwraca pusty łańcuch, jeśli dane wejściowe mają wartość NULL. W przeciwnym razie zwraca wartość kolumny wejściowej.
Składnia
ds.NullToEmpty(input (any))
zwroty: pusty łańcuch lub wartość wejściowa.
Przykłady
Poniższy kod zwraca wartość "AA".
ds.NullToEmpty("AA")
Poniższy kod zwraca "".
ds.NullToEmpty(null)
NullStr
Zwraca łańcuch tekstowy o wartości NULL (128).
Składnia
ds.NullStr()
zwroty: łańcuch pusty CHAR (128).
Przykłady
Poniższy kod zwraca €.
ds.NullStr()
NullToWartość
Zwraca określoną wartość, jeśli dane wejściowe mają wartość NULL. W przeciwnym razie zwraca wartość kolumny wejściowej.
Składnia
ds.NullToValue(input (any), default (any))
zwraca: określoną wartość lub wartość wejściową.
Przykłady
Poniższy kod zwraca "test".
ds.NullToValue("test", "default")
Poniższy kod zwraca wartość "default".
ds.NullToValue(null, "default")
Poniższy kod zwraca 1.
ds.NullToValue(null, 1)
NullToZero
Zwraca 0, jeśli wartość wejściowa jest równa null, w przeciwnym razie zwraca wartość kolumny wejściowej.
Składnia
ds.NullToZero(input (any))
zwróci wartość: 0 lub wartość wejściową.
Przykłady
Poniższy kod zwraca wartość 88.
ds.NullToZero(88)
Poniższy kod zwraca 0.
ds.NullToZero(null)
SetNull
Przypisuje wartość null do kolumny docelowej.
Składnia
ds.SetNull()
zwroty: ustawia wartość docelową na wartość pustą.
Przykłady
Następujący kod zwraca wartość NULL.
ds.SetNull()
Funkcje makr
Funkcje, które obsługują pobieranie zestawu metadanych projektu związanego z zadaniami sekwencji DataStage .
JobName
Zwraca nazwę zadania sekwencer.
Składnia
ds.JobName
zwraca: nazwa zadania sekwencera łańcucha formatu.
Przykłady
Poniższy kod zwraca nazwę zadania sekwencer.
ds.JobName
Data JobStart
Zwraca datę rozpoczęcia zadania sekwencera.
Składnia
ds.JobStartDate
zwraca: datę rozpoczęcia zadania sekwencera w łańcuchu formatu.
Przykłady
Poniższy kod zwraca datę rozpoczęcia zadania sekwencer.
ds.JobStartDate
Czas JobStart
Zwraca czas rozpoczęcia zadania sekwencera.
Składnia
ds.JobStartTime
zwraca: czas rozpoczęcia zadania sekwencera w łańcuchu formatu.
Przykłady
Poniższy kod zwraca czas rozpoczęcia zadania sekwencer.
ds.JobStartTime
JobStartDatownik
Zwraca znacznik czasu rozpoczęcia zadania sekwencer.
Składnia
ds.JobStartTimestamp
zwraca: znacznik czasu rozpoczęcia zadania sekwencera datownika formatu.
Przykłady
Poniższy kod zwraca znacznik czasu rozpoczęcia zadania sekwencer.
ds.JobStartTimestamp
HostName
Zwraca nazwę hosta serwera DataStage .
Składnia
ds.HostName
zwraca: zadanie sekwencer InvocationId łańcucha formatu.
Przykłady
Poniższy kod zwraca zadanie sekwencer InvocationId.
ds.HostName
ProjectName
Zwraca nazwę projektu uruchomionego zadania sekwencera
Składnia
ds.ProjectName
zwraca: nazwę projektu uruchomionego zadania sekwencera.
Przykłady
Poniższy kod zwraca nazwę projektu uruchomionego zadania sekwencera.
ds.ProjectName
ProjectId
Zwraca identyfikator projektu uruchomionego zadania sekwencera.
Składnia
ds.ProjectId
zwraca: identyfikator projektu uruchomionego zadania sekwencera.
Przykłady
Poniższy kod zwraca identyfikator projektu uruchomionego zadania sekwencera.
ds.ProjectId
JobId
Zwraca identyfikator zadania uruchomionego zadania sekwencera.
Składnia
ds.JobId
zwraca: identyfikator zadania uruchomionego zadania sekwencera.
Przykłady
Poniższe komendy zwracają identyfikator zadania uruchomionego zadania sekwencer.
ds.JobId
JobController
Zwraca nazwę przepływu potoku dla uruchomionego zadania sekwencera.
Składnia
ds.JobController
zwraca: nazwę przepływu potoku dla uruchomionego zadania sekwencera.
Przykłady
Następujące komendy zwracają nazwę przepływu potoku dla uruchomionego zadania sekwencer.
ds.JobController
Temat nadrzędny: Dodawanie warunków do potoku