Type conversion functions

Transcription

1 20th August 2013 Type conversion functions String to Date in Datastage Transformer Functions Used in Datastage Transformer Null Handling Functions In Datastage Transformer [ praveen.com/2013/07/nullhandling functions in datastage.html] String Functions In DatastageTransformer [ praveen.com/2013/07/stringfunctions in datastage.html] Date and time functions in Datastage [ praveen.com/2012/10/date and timefunctions you can use.html] Char Generates an ASCII character from its numeric code value. You can optionally specify the allow8bits argument to convert 8 bit ASCII values. Input: code (number), [allow8bits] Output: result (char) Examples. The following example outputs the ASCII code 65 as the character A. Char(65) DateToString Returns the string representation of the given date. The format of the string can optionally be specified. Input: date (date), [format (string)] Output: result (string) Examples. The following example outputs the date contained in the column link_name.mydate to a string. If link_name.mydate contains the date 18th August, 2009, then the output string is " ": DateToString(link_name.mydate) The following example outputs the date contained in the column link_name.mydate to a string with the format dd:mm:yyyy. If link_name.mydate contained the date 18th August, 2009, then the output string would be "18:08:2009": DateToString(link_name.mydate, "%dd:%mm:%yyyy") DateToDecimal Returns the given date as a packed decimal value. If your target decimal specifies a scale, part of the date appears after the decimal point. You can optionally specify a format string that

2 specifies how the date is stored in the decimal number. The default format string is "%yyyy%mm%dd", so, for example, the date is stored as the decimal number Format strings can only specify a format that contains numbers. For example, you cannot specify a format string such as "%yyyy %mm %dd", because the hyphen character ( ) cannot be stored in a packed decimal value. The following tokens are valid for conversions to or from decimal values: %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) The literal digits 0 to 9 are also valid. Input: basedate (date) [, format (string)] Output: converted_date (decimal) Examples. If the column link_name.basedate contains the date , then the following function stores the date as the decimal number : DateToDecimal (link_name.basedate, "%dd%mm%yyyy") If the column link_name.basedate contains the date , and the target column has a length of 10 and a scale of 2, then the following function stores the date as the decimal number : DateToDecimal (link_name.basedate) DecimalToDate Returns the given packed decimal as a date. Both the sign and the scale of the decimal number are ignored when it is converted to a date. You can optionally specify a format string that specifies how the date is stored in the decimal number. The default format string is "%yyyy%mm%dd", so, for example, the date is stored as the decimal number Format strings can only specify a format that contains numbers. For example, you cannot specify a format string such as "%yyyy %mm %dd", because the hyphen character ( ) cannot be stored in a packed decimal value. The following tokens are valid for conversions to or from decimal values: %yyyy (four digit year) %yy (two digit year) %NNNNyy (two digit year with cutoff)

3 %mm (two digit month) %dd (two digit day of month) %ddd (three digit day of year) The literal digits 0 to 9 are also valid. Input: basedec (decimal) [, format (string)] Output: date Examples. If the column link_name.mydecdata contains the value , then the following function returns the date : DecimalToDate (link_name.basedate, "%dd%mm%yyyy") If the column link_name.mydecdata contains the value , then the following function returns the date : DecimalToDate (link_name.basedate) DecimalToDecimal Returns the given decimal in decimal representation with precision and scale specified in the target column definition. The argument rtype optionally specifies a rounding type, and is set to one of the following values: ceil. Round the source field toward positive infinity. For example, 1.4 > 2, 1.6 > 1. floor. Round the source field toward negative infinity. For example, 1.6 > 1, 1.4 > 2. round_inf. Round or truncate the source field toward the nearest representable value, breaking ties by rounding positive values toward positive infinity and negative values toward negative infinity. For example, 1.4 > 1, 1.5 > 2, 1.4 > 1, 1.5 > 2. trunc_zero. Discard any fractional digits to the right of the rightmost fractional digit supported in the destination, regardless of sign. For example, if the destination is an integer, all fractional digits are truncated. If the destination is another decimal with a smaller scale, round or truncate to the scale size of the destination decimal. For example, 1.6 > 1, 1.6 > 1. Input: decimal (decimal) [,rtype (string)] Output: result (decimal) Examples. If the column link_name.mydec contains the decimal number , the following function returns the decimal number DecimalToDecimal(link_name.mydec,"ceil") The following function returns the decimal number DecimalToDecimal(link_name.mydec,"floor")

4 The following function returns the decimal number DecimalToDecimal(link_name.mydec,"trunc_zero") The following function returns the decimal number DecimalToDecimal(link_name.mydec,"round_inf") In all these examples, the target decimal has a length of 10 and a scale of 2. DecimalToDFloat Returns the given decimal in dfloat representation. The argument "fix_zero" optionally specifies that all zero decimal values are regarded as valid (by default, decimal numbers comprising all zeros are treated as invalid). Input: decimal (decimal) [,"fix_zero"] Output: result (dfloat) Examples. If the column link_name.mydec contains the decimal number the following function returns the dfloat number E+00. DecimalToDFloat(link_name.mydec,"fix_zero") If the column link_name.mydec contains the decimal number the following function returns the dfloat number E+04. DecimalToDFloat(link_name.mydec,"fix_zero") If the column link_name.mydec contains the decimal number the following function returns the dfloat number E+04. DecimalToDFloat(link_name.mydec,"fix_zero") If the column link_name.mydec contains the decimal number the following function returns the dfloat number E+04. DecimalToDFloat(link_name.mydec) If the column link_name.mydec contains the decimal number the following function returns the dfloat number E+04. DecimalToDFloat(link_name.mydec) DecimalToString Returns the given decimal as a string. The argument "fix_zero" optionally specifies that all zero decimal values are regarded as valid (by default, decimal numbers comprising all zeros are treated as invalid). This covers the case where the sign bits of the packed decimal representation are all 0 as well as all the content digits. This cast is not considered valid unless "fix_zero" is true.

5 Input: decimal (decimal) [,"fix_zero"] Output: result (string) Examples. If the column link_name.mydec contains the decimal number , the following function returns the string "4": DecimalToString(link_name.mydec,"suppress_zero") If the column link_name.mydec contains the decimal number , the following function returns the string " ". DecimalToString(link_name.mydec,"fix_zero") If the column link_name.mydec contains the decimal number , the following function returns the string "12344". DecimalToString(link_name.mydec,"suppress_zero") If the column link_name.mydec contains the decimal number , the following function returns the string " ". DecimalToString(link_name.mydec,"fix_zero") If the column link_name.mydec contains the decimal number , the following function returns the string " ". DecimalToString(link_name.mydec,"fix_zero") If the column link_name.mydec contains the decimal number , the following function returns the string " ": DecimalToString(link_name.mydec,"suppress_zero") If the column link_name.mydec contains the decimal number , the following function returns the string " ". DecimalToString(link_name.mydec) If the column link_name.mydec contains the decimal number , the following function returns the string " ". DecimalToString(link_name.mydec) DecimalToTime Returns the given packed decimal as a time. You can optionally specify a format string that specifies how the time is stored in the decimal number. The default format string is " %hh%nn%ss", so, for example, the time 14:03:22 is stored as the decimal number Format strings can

6 only specify a format that contains numbers. For example, you cannot specify a format string such as "%hh:%nn:%ss", because the colon character (:) cannot be stored in a packed decimal value. The following tokens are valid for conversions to or from decimal values: %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). The literal digits 0 to 9 are also valid. If your specified format includes microseconds (for example, %ss.4), then the position of the decimal point is inferred in the decimal value. The position of the decimal point does not have to coincide with the specified scale of the decimal (for example, scale = 4). Input: time (time) [, format (string)] Output: result (decimal) Examples: If the column link_name.mytimedec contains the decimal value , then the following function returns the time 20:06:58: DecimalToTime(link_name.mytimedec) If the column link_name.mytimedec contains the de cimal value , then the following function returns the time 20:06:58: DecimalToTime(link_name.mytimedec, "%ss%nn%hh") DecimalToTimestamp Returns the given packed decimal as a timestamp. You can optionally specify a format string that specifies how the timestamp is stored in the decimal number. The default format string is " %yyyy%mm%dd%hh%nn%ss", so, for example, the timestamp :03:22 is stored as the decimal number Format strings can only specify a format that contains numbers. For example, you cannot specify a format string such as "%yyyy/%mm/%dd%hh:%nn:%ss", because the slash character (/) and the colon character (:) cannot be stored in a packed decimal value. The following tokens are valid for conversions to or from decimal values: %yyyy (four digit year) %yy (two digit year) %NNNNyy (two digit year with cutoff) %mm (two digit month) %dd (two digit day of month)

7 %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). The literal digits 0 to 9 are also valid. If your specified format includes microseconds (for example, %ss.4), then the position of the decimal point is inferred in the decimal value. The position of the decimal point does not have to coincide with the specified scale of the decimal (for example, scale = 4). Input: timestamp (timestamp) [, format (string)] Output: result (decimal) Examples: If the column link_name.mytimestampdec contains the value , then the following function returns the timestamp :06:58: DecimalToTimestamp(link_name.mytimestampdec) If the column link_name.mytimestampdec contains the decimal value , Then the following function returns the timestamp :06:58: DecimalToTimestamp(link_name.mytimestampdec, "%hh%nn%ss%yy%mm%dd") DFloatToDecimal Returns the given dfloat in decimal representation. The argument rtype optionally specifies a rounding type, and is set to one of the following values: ceil. Round the source field toward positive infinity. For example, 1.4 > 2, 1.6 > 1. floor. Round the source field toward negative infinity. For example, 1.6 > 1, 1.4 > 2. round_inf. Round or truncate the source field toward the nearest representable value, breaking ties by rounding positive values toward positive infinity and negative values toward negative infinity. For example, 1.4 > 1, 1.5 > 2, 1.4 > 1, 1.5 > 2. trunc_zero. Discard any fractional digits to the right of the rightmost fractional digit supported in the destination, regardless of sign. For example, if the destination is an integer, all fractional digits are truncated. If the destination is another decimal with a smaller scale, round or truncate to the scale size of the destination decimal. For example, 1.6 > 1, 1.6 > 1. Input: number (dfloat), [rtype (string)] Output: result (decimal) Examples. If the column link_name.myfloat contains the dfloat number 2.534, the following function returns the decimal number

8 DFloatToDecimal(link_name.mydec,"ceil") If the column link_name.myfloat contains the dfloat number 2.534, the following function returns the decimal number DFloatToDecimal(link_name.mydec,"floor") If the column link_name.myfloat contains the dfloat number 2.534, the following function returns the decimal number DFloatToDecimal(link_name.mydec,"trunc_zero") If the column link_name.myfloat contains the dfloat number 2.534, the following function returns the decimal number DFloatToDecimal(link_name.mydec,"round_inf") DfloatToStringNoExp Returns the given dfloat in its string representation with no exponent, using the specified scale. Input: number (dfloat), scale (string) Output: result (string) Examples. If the column link_name.myfloat contains the dfloat number 2.534, then the following function returns the string : DfloatToStringNoExp(link_name.myfloat,2) IsValid Returns whether the given string is valid for the given type. Valid types are "date", "decimal", "dfloat", "sfloat", "int8", "uint8", "int16", "uint16", "int32", "uint32", "int64", "uint64", "raw", "string", "time", "timestamp", "ustring". For data types of date, time, and timestamp, you can optionally specify a format string. The format string describes the format that your input data uses when it differs from the default formats for date, time, or timestamp. The default format for date is %yyyy %mm %dd. The default format for time is "%hh:%mm:%ss". The default format for timestamp is %yyyy %mm %dd %hh:%mm:%ss". Input: type (string), teststring (string) [, format (string)] Output: result (int8) Examples. If the column link_name.mystring contains the string "1", then the following function returns the value 1. IsValid("int8",link_name.mystring) If the column link_name.mystring contains the string " ", then the following function returns the value 0. IsValid("int8",link_name.mystring) IsValidDate

9 Returns whether the given value is valid for the type date. Input: testdate (date) Output: result (int8) Examples. If the column link_name.mydate contains the date , then the following function returns the value 1. IsValidDate(link_name.mydate) If the column link_name.mydate contains the string " ", then the following function returns the value 0, because the converted string is not a valid date. IsValidDate(StringTodate (link_name.mydate)) IsValidDecimal Returns whether the given value is valid for the type decimal. If the allzerosflag is set to 0, then an allzeroes representation is not valid. The allzerosflag is set to zero by default. Input: testvalue (decimal) [, allzerosflag (uint8)] Output: result (int8) Examples. If the column link_name.mynum contains the value , then the following function returns the value 1. IsValidDecimal(link_name.mynum) If the column link_name.mynum contains the string "wake robin", then the following function returns the value 0, because the converted string is not a valid decimal. IsValidDecimal(StringToDecimal (link_name.mynum)) IsValidTime Returns whether the given time is valid for the type time. Input: testtime (time) Output: result (int8) Examples. If the column link_name.mytime contains the time 23:09:22, then the following function returns the value 1: IsValidTime(link_name.mytime) If the column link_name.mydate contains the string "IbnKayeed", then the following function returns the value 0, because the converted string is not a valid time. IsValidTime(StringToTime (link_name.mytime)) IsValidTimestamp Returns whether the given timestamp is valid for the type timestamp. Input: testtimestamp (timestamp) Output: result (int8) Examples. If the column link_name.mytimestamp contains the time :09:22,

10 then the following function returns the value 1: IsValidTimestamp(link_name.mytimestamp) If the column link_name.mytimestamp contains the string "one of two", then the following function returns the value 0, because the converted string is not a valid timestamp. IsValidTimestamp(StringToTimestamp (link_name.mytimestamp)) RawNumAt Returns the integer value at the specified index value in the specified raw field. The index starts at 0. Input: rawfield (raw), index (int32) Output: result (int32) Examples. If the column link_name.myraw contains a raw value derived from the string "hello", then the following function returns the integer 0x68 (the ASCII code for the character h): RawNumAt(link_name.myraw, 0) If the column link_name.myraw contains a raw value derived from the string "hello", then the following function returns 0 because the specified index is out of range: RawNumAt(link_name.myraw, 12) RawToString Returns the given raw value as a string representation. You must ensure that the raw input value contains a sequence of bytes that are valid as characters in the target character set in which the output string is used. For example, the raw value { 0xE0 0x41 0x42 } is not a valid sequence of UTF 8 characters, since the lead byte, 0xE0, is supposed to be followed by a byte in the range [0x80..0xBF]. If a raw value { xe0 x41 x42 } is passed to the RawToString function, there could be an error if the output string is then accessed as if it were encoded in UTF 8. Input: rawfield (raw) Output: result (string) Examples. If the column link_name.myraw contains the value { 0x31 0x31 0x30 0x35 0x32 0x32 0x30 0x39 }, then the following function returns the string " ". RawNumAt(link_name.myraw) Seq Generates a numeric code value from an ASCII character. You can optionally specify the allow8bits argument to convert 8 bit ASCII values. Input: Seq (char) Output: result (number) Examples. The following example outputs the character A as the ASCII code 65.

11 Seq("A") SeqAt Returns the numeric code point value of the character at the specified position in the given string. The index starts at 0. If the specified index is out of range, the function returns 0. Input: basestring (string), index (int32) Output: result (int32) Examples. If the column link_name.mystring contains the string "horse", then the following function returns the value 0x6F (that is, the ASCII value of the character o). SeqAt(link_name.mystring, 1) StringToDate Returns a date from the given string in the given format. You do not have to specify a format string if your string contains a date in the default format yyyy mm dd. Input: string (string) [,format (string)] Output: result (date) Examples: If the column link_name.mystring contains the string , then the following function returns the date StringToDate(link_name.mystring) If the column link_name.mystring contains the string 18:08:1958, then the following function returns the date StringToDate(link_name.mystring,"%dd:%mm:%yyyy") StringToDecimal Returns the given string as a decimal representation. The argument rtype optionally specifies a rounding type, and is set to one of the following values: ceil. Round the source field toward positive infinity. For example, 1.4 > 2, 1.6 > 1. floor. Round the source field toward negative infinity. For example, 1.6 > 1, 1.4 > 2. round_inf. Round or truncate the source field toward the nearest representable value, breaking ties by rounding positive values toward positive infinity and negative values toward negative infinity. For example, 1.4 > 1, 1.5 > 2, 1.4 > 1, 1.5 > 2. trunc_zero. Discard any fractional digits to the right of the rightmost fractional digit supported in the destination, regardless of sign. For example, if the destination is an integer, all fractional digits are truncated. If the destination is another decimal with a smaller scale, round or truncate to the scale size of the destination decimal. For example, 1.6 > 1, 1.6 > 1. Input: string (string), [rtype (string)] Output: result (decimal)

12 Examples. If the column link_name.mystring contains the string " ", and the target is defined as having a precision of 7 and a scale of 2, then the following function returns the decimal StringToDecimal(link_name.mystring) If the column link_name.mystring contains the string " ", and the target is defined as having a precision of 7 and a scale of 2, then the following function returns the decimal StringToDecimal(link_name.mystring,"ceil") StringToRaw Returns a string in raw representation. Input: string (string) Output: result (raw) Examples. If the column link_name.mystring contains the string "hello", and the target column is defined as being of type Binary then the following function returns the value { 0x68 0x65 0x6C 0x6C 0x6F }. StringToRaw(link_name.mystring) StringToTime Returns a time representation of the given string. Input: string (string), [format (string)] Output: result (time) Examples: If the column link_name.mystring contains the string "20:06:58", then the function returns a time of 20:06:58. StringToTime(link_name.mystring) If the column link_name.mystring contains the string "20: 6:58", then the function returns a time of 20:06:58. StringToTime(link_name.mystring,"% (h,s):$(n,s):$(s,s)") StringToTimestamp Returns a time representation of the given string. Input: string (string) [format (string)] Output: result (time) Examples: If the column link_name.mystring contains the string " :06:58", then the function returns the timestamp :06:58. StringToTimestamp(link_name.mystring)

13 If the column link_name.mystring contains the string "8/ 8/ : 6:58", then the function returns the timestamp :06:58. StringToTimestamp(link_name.mystring, "%(d,s)/%(m,s)/%yyyy% (h,s):$(n,s):$(s,s)") StringToUstring Returns a ustring from the given string, optionally using the specified map (otherwise uses project default). Input: string (string), [mapname(string)] Output: result (ustring) Examples: If the column link_name.mystring contains the string " ", then the following function returns the ustring " " StringToUstring(link_name.mystring) TimestampToDate Returns a date from the given timestamp. Input: timestamp (timestamp) Output: result (date) Examples: If the column link_name.mytimestamp contains the timestamp :06:58, then the following function returns the date : TimestampToDate(link_name.mytimestamp) TimestampToDecimal Returns the given timestamp as a packed decimal. You can optionally specify a format string that specifies how the timestamp is stored in the decimal number. The default format string is " %yyyy%mm%dd%hh%nn%ss", so, for example, the timestamp :03:22 is stored as the decimal number Format strings can only specify a format that contains numbers. For example, you cannot specify a format string such as "%yyyy/%mm/%dd%hh:%nn:%ss", because the slash character (/) and the colon character (:) cannot be stored in a packed decimal value. The following tokens are valid for conversions to or from decimal values: %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)

14 %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). The literal digits 0 to 9 are also valid. If your specified format includes microseconds (for example, %ss.4), then the position of the decimal point is inferred in the decimal value. The position of the decimal point does not have to coincide with the specified scale of the decimal (for example scale = 4). Input: timestamp (timestamp) [, format (string)] Output: result (decimal) Examples: If the column link_name.mytimestamp contains the timestamp :06:58, then the following function returns the decimal value : TimestampToDecimal(link_name.mytimestamp) If the column link_name.mytimestamp contains the timestamp :06:58, then the following function returns the decimal value : TimestampToDecimal(link_name.mytimestamp, "%hh%nn%ss%yy%mm%dd") TimestampToString Returns a string from the given timestamp. Input: timestamp (timestamp) [format (string)] Output: result (string) Examples: If the column link_name.mytimestamp contains the timestamp :06:58, then the function returns the string " :06:58". TimestampToString(link_name.mytimestamp) If the column link_name.mytimestamp contains the timestamp :06:58, then the function returns the string "18/08/ :06:58": TimestampToTime TimestampToString(link_name.mytimestamp, "%dd/%mm/%yyyy %hh:$nn:$ss") Returns the string representation of the given timestamp. Input: timestamp (timestamp) Output: result (time) Examples: If the column link_name.mytimestamp contains the timestamp :06:58, then the function returns the time 20:06:58: TimestampToTime(link_name.mytimestamp)

15 TimeToString Returns a string from the given time. Input: timestamp (timestamp) [format (string)] Output: result (time) Examples: If the column link_name.mytime contains the time 20:06:58, then the following function returns the string "20:06:58": TimeToString(link_name.mytime) If the column link_name.mytime contains the time 20:06:58, then the following function returns the string "58:06:20": TimeToString(link_name.mytime, "%ss:$nn:$hh") TimeToDecimal Returns the given time as a packed decimal. You can optionally specify a format string that specifies how the time is stored in the decimal number. The default format string is " %hh%nn%ss", so, for example, the time 14:03:22 is stored as the decimal number Format strings can only specify a format that contains numbers. For example, you cannot specify a format string such as "%hh:%nn:%ss", because the colon character (:) cannot be stored in a packed decimal value. The following tokens are valid for conversions to or from decimal values: %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). The literal digits 0 to 9 are also valid. If your specified format includes microseconds (for example, %ss.4), then the position of the decimal point is inferred in the decimal value. The position of the decimal point does not have to coincide with the specified scale of the decimal (for example scale = 4). Input: time (time) [, format (string)] Output: result (decimal) Examples: If the column link_name.mytime contains the time 20:06:58, then the following function returns the decimal value : TimeToDecimal(link_name.mytime) If the column link_name.mytime contains the time 20:06:58, then the following function returns the decimal value : TimeToDecimal(link_name.mytime, "%ss%nn%hh") UstringToString Returns a string from the given ustring, optionally using the specified map (otherwise uses project

16 default). Input: string (ustring) [, mapname(string)] Output: result (string) Examples: If the column link_name.myustring contains the ustring " ", then the following function returns the string " ": UstringToString(link_name.myustring Posted 20th August 2013 by praveen govind Location: Southern Asia 0 Add a comment Enter your comment... Comment as: Google Accoun Publish Preview