teradataml 20.0.0.4__py3-none-any.whl → 20.0.0.6__py3-none-any.whl

teradataml/dataframe/sql.py

@@ -5480,6 +5480,7 @@ class _SQLColumnExpression(_LogicalColumnExpression,
         self._quotechar = kw.get("quotechar", None)
         self._udf_script = kw.get("udf_script", None)
         self.alias_name = self.compile() if (self._udf or self._udf_script) is None else None
+        self._debug = kw.get("debug", False)
 
     @property
     def expression(self):
@@ -6737,8 +6738,42 @@ class _SQLColumnExpression(_LogicalColumnExpression,
         """
         return _SQLColumnExpression(self.expression.distinct().label(self.name))
 
+    def _format_ilike_like_args(self, other, escape_char=None):
+        """
+            DESCRIPTION:
+                Internal function to validate and format the arguments passed to
+                'ilike' and 'like' functions.
+
+            PARAMETERS:
+                other:
+                    Required Argument.
+                    Specifies a string to match.
+                    Types: str OR ColumnExpression
+
+                escape_char:
+                    Optional Argument.
+                    Specifies the escape character to be used in the pattern.
+                    Types: str with one character
+
+            RETURNS:
+                tuple
+
+            EXAMPLES:
+                self._format_ilike_like_args(other='A!%', escape_char='!')
+        """
+        # Validate the arguments.
+        arg_validate = []
+        arg_validate.append(["other", other, False, (str, ColumnExpression), True])
+        arg_validate.append(["escape_char", escape_char, True, (str), True])
+        _Validators._validate_function_arguments(arg_validate)
+
+        # Format the arguments for ilike/like function.
+        other  = "{}".format(other.compile()) if isinstance(other, ColumnExpression) else "'{}'".format(other)
+        escape = " ESCAPE '{}'".format(escape_char) if escape_char is not None else ""
+        return other, escape
+
     @collect_queryband(queryband="DFC_ilike")
-    def ilike(self, other):
+    def ilike(self, other, escape_char=None):
         """
         DESCRIPTION:
             Function which is used to match the pattern.
@@ -6747,67 +6782,95 @@ class _SQLColumnExpression(_LogicalColumnExpression,
             other:
                 Required Argument.
                 Specifies a string to match. String match is case insensitive.
-                Types: str
+                Types: str OR ColumnExpression
+
+            escape_char:
+                Optional Argument.
+                Specifies the escape character to be used in the pattern.
+                Types: str with one character
 
         RETURNS:
             ColumnExpression.
 
         EXAMPLES:
-            >>> load_example_data("dataframe","admissions_train")
-            >>> df = DataFrame.from_table('admissions_train')
-               masters   gpa     stats programming  admitted
-            id
-            13      no  4.00  Advanced      Novice         1
-            26     yes  3.57  Advanced    Advanced         1
-            5       no  3.44    Novice      Novice         0
-            19     yes  1.98  Advanced    Advanced         0
-            15     yes  4.00  Advanced    Advanced         1
-            40     yes  3.95    Novice    Beginner         0
-            7      yes  2.33    Novice      Novice         1
-            22     yes  3.46    Novice    Beginner         0
-            36      no  3.00  Advanced      Novice         0
-            38     yes  2.65  Advanced    Beginner         1
-
-            # Example 1: Find out the records whose stats starts with 'A'.
-            >>> df = df[df.stats.ilike('a%')]
+            # Load example data.
+            >>> load_example_data("teradataml", "pattern_matching_data")
+            >>> df = DataFrame('pattern_matching_data')
+                       data     pattern     level
+            id                                   
+            5       prod_01    prod_01%  Beginner
+            8      log%2024        l_g%  Beginner
+            2     user%2025     user!%%  Beginner
+            6       prod%v2     prod!_%    Novice
+            4   data%backup     data@%%  Advanced
+            10     backup_9  restore!_9  Beginner
+            7      log_file   log^_file  Advanced
+            1    user_Alpha     user!_%  Advanced
+            3     data_2024          d%    Novice
+            9     temp_file    temp!__%    Novice
+
+            # Example 1: Find out the records which starts with 'A' in the column 'level'.
+            >>> df = df[df.level.ilike('A%')]
             >>> df
-               masters   gpa     stats programming  admitted
-            id
-            19     yes  1.98  Advanced    Advanced         0
-            15     yes  4.00  Advanced    Advanced         1
-            38     yes  2.65  Advanced    Beginner         1
-            26     yes  3.57  Advanced    Advanced         1
-            17      no  3.83  Advanced    Advanced         1
-            34     yes  3.85  Advanced    Beginner         0
-            13      no  4.00  Advanced      Novice         1
-            24      no  1.87  Advanced      Novice         1
-            36      no  3.00  Advanced      Novice         0
-            27     yes  3.96  Advanced    Advanced         0
+                       data    pattern     level
+            id                                  
+            4   data%backup    data@%%  Advanced
+            7      log_file  log^_file  Advanced
+            1    user_Alpha    user!_%  Advanced
             >>>
 
             # Example 2: Create a new Column with values as -
-            #            1 if value of column 'stats' starts with 'a' and third letter is 'v',
+            #            1 if value of column 'level' starts with 'n' and third letter is 'v',
             #            0 otherwise. Ignore case.
-            >>> df.assign(new_col = case_when((df.stats.ilike('a_v%').expression, 1), else_=0))
-               masters   gpa     stats programming  admitted  n
-            id
-            13      no  4.00  Advanced      Novice         1  1
-            26     yes  3.57  Advanced    Advanced         1  1
-            5       no  3.44    Novice      Novice         0  0
-            19     yes  1.98  Advanced    Advanced         0  1
-            15     yes  4.00  Advanced    Advanced         1  1
-            40     yes  3.95    Novice    Beginner         0  0
-            7      yes  2.33    Novice      Novice         1  0
-            22     yes  3.46    Novice    Beginner         0  0
-            36      no  3.00  Advanced      Novice         0  1
-            38     yes  2.65  Advanced    Beginner         1  1
+            >>> from sqlalchemy.sql.expression import case as case_when
+            >>> df.assign(new_col = case_when((df.level.ilike('n_v%').expression, 1), else_=0))
+                       data     pattern     level new_col
+            id                                           
+            3     data_2024          d%    Novice       1
+            1    user_Alpha     user!_%  Advanced       0
+            8      log%2024        l_g%  Beginner       0
+            2     user%2025     user!%%  Beginner       0
+            10     backup_9  restore!_9  Beginner       0
+            9     temp_file    temp!__%    Novice       1
+            6       prod%v2     prod!_%    Novice       1
+            5       prod_01    prod_01%  Beginner       0
+            4   data%backup     data@%%  Advanced       0
+            7      log_file   log^_file  Advanced       0
+            >>>
+
+            # Example 3: Find out the records where the value in the 'data' column 
+            #            matches the pattern specified in the 'pattern' column.
+            >>> df = df[df.data.ilike(df.pattern)]
+            >>> df
+                     data   pattern     level
+            id                               
+            3   data_2024        d%    Novice
+            8    log%2024      l_g%  Beginner
+            5     prod_01  prod_01%  Beginner
+            >>>
+
+            # Example 4: Find out the records where the value in the 'data' column
+            #            matches the pattern specified in the 'pattern' column considering the
+            #            escape character as '!'.
+            >>> df = df[df.data.ilike(df.pattern, escape_char='!')]
+            >>> df
+                      data   pattern     level
+            id                                
+            8     log%2024      l_g%  Beginner
+            9    temp_file  temp!__%    Novice
+            3    data_2024        d%    Novice
+            2    user%2025   user!%%  Beginner
+            1   user_Alpha   user!_%  Advanced
+            5      prod_01  prod_01%  Beginner
             >>>
         """
+        # Validate and format arguments
+        other, escape = self._format_ilike_like_args(other, escape_char)        
         return _SQLColumnExpression(
-            literal_column("{} (NOT CASESPECIFIC) LIKE '{}'".format(self.compile(), other)))
+            literal_column("{} (NOT CASESPECIFIC) LIKE {}{}".format(self.compile(), other, escape)))
 
     @collect_queryband(queryband="DFC_like")
-    def like(self, other):
+    def like(self, other, escape_char=None):
         """
         DESCRIPTION:
             Function which is used to match the pattern.
@@ -6815,66 +6878,190 @@ class _SQLColumnExpression(_LogicalColumnExpression,
         PARAMETERS:
             other:
                 Required Argument.
-                Specifies a string to match. String match is case insensitive.
-                Types: str
+                Specifies a string to match. String match is case sensitive.
+                Types: str OR ColumnExpression
+
+            escape_char:
+                Optional Argument.
+                Specifies the escape character to be used in the pattern.
+                Types: str with one character
 
         RETURNS:
             ColumnExpression.
 
         EXAMPLES:
-            >>> load_example_data("dataframe","admissions_train")
-            >>> df = DataFrame.from_table('admissions_train')
-               masters   gpa     stats programming  admitted
-            id
-            13      no  4.00  Advanced      Novice         1
-            26     yes  3.57  Advanced    Advanced         1
-            5       no  3.44    Novice      Novice         0
-            19     yes  1.98  Advanced    Advanced         0
-            15     yes  4.00  Advanced    Advanced         1
-            40     yes  3.95    Novice    Beginner         0
-            7      yes  2.33    Novice      Novice         1
-            22     yes  3.46    Novice    Beginner         0
-            36      no  3.00  Advanced      Novice         0
-            38     yes  2.65  Advanced    Beginner         1
-
-            # Example 1: Find out the records whose stats starts with 'A'.
-            >>> df = df[df.stats.like('A%')]
+            # Load example data.
+            >>> load_example_data("teradataml", "pattern_matching_data")
+            >>> df = DataFrame('pattern_matching_data')
+                       data     pattern     level
+            id                                   
+            5       prod_01    prod_01%  Beginner
+            8      log%2024        l_g%  Beginner
+            2     user%2025     user!%%  Beginner
+            6       prod%v2     prod!_%    Novice
+            4   data%backup     data@%%  Advanced
+            10     backup_9  restore!_9  Beginner
+            7      log_file   log^_file  Advanced
+            1    user_Alpha     user!_%  Advanced
+            3     data_2024          d%    Novice
+            9     temp_file    temp!__%    Novice
+
+            # Example 1: Find out the records which starts with 'A' in the column 'level'.
+            >>> df = df[df.level.like('A%')]
             >>> df
-               masters   gpa     stats programming  admitted
-            id
-            19     yes  1.98  Advanced    Advanced         0
-            15     yes  4.00  Advanced    Advanced         1
-            38     yes  2.65  Advanced    Beginner         1
-            26     yes  3.57  Advanced    Advanced         1
-            17      no  3.83  Advanced    Advanced         1
-            34     yes  3.85  Advanced    Beginner         0
-            13      no  4.00  Advanced      Novice         1
-            24      no  1.87  Advanced      Novice         1
-            36      no  3.00  Advanced      Novice         0
-            27     yes  3.96  Advanced    Advanced         0
+                       data    pattern     level
+            id                                  
+            4   data%backup    data@%%  Advanced
+            7      log_file  log^_file  Advanced
+            1    user_Alpha    user!_%  Advanced
             >>>
 
             # Example 2: Create a new Column with values as -
-            #            1 if value of column 'stats' starts with 'A' and third letter is 'v',
+            #            1 if value of column 'stats' starts with 'N' and third letter is 'v',
             #            0 otherwise. Do not ignore case.
-            >>> df.assign(new_col = case_when((df.stats.like('A_v%').expression, 1), else_=0))
+            >>> from sqlalchemy.sql.expression import case as case_when
+            >>> df.assign(new_col = case_when((df.level.like('N_v%').expression, 1), else_=0))
+                       data     pattern     level new_col
+            id                                           
+            3     data_2024          d%    Novice       1
+            1    user_Alpha     user!_%  Advanced       0
+            8      log%2024        l_g%  Beginner       0
+            2     user%2025     user!%%  Beginner       0
+            10     backup_9  restore!_9  Beginner       0
+            9     temp_file    temp!__%    Novice       1
+            6       prod%v2     prod!_%    Novice       1
+            5       prod_01    prod_01%  Beginner       0
+            4   data%backup     data@%%  Advanced       0
+            7      log_file   log^_file  Advanced       0
+            >>>
+
+            # Example 3: Find out the records where the value in the 'data' column 
+            #            matches the pattern specified in the 'pattern' column.
+            >>> df = df[df.data.like(df.pattern)]
+            >>> df
+                     data   pattern     level
+            id                               
+            3   data_2024        d%    Novice
+            8    log%2024      l_g%  Beginner
+            5     prod_01  prod_01%  Beginner
+            >>>
+
+            # Example 4: Find out the records where the value in the 'data' column
+            #            matches the pattern specified in the 'pattern' column considering the
+            #            escape character as '!'.
+            >>> df = df[df.data.like(df.pattern, escape_char='!')]
             >>> df
-               masters   gpa     stats programming  admitted  n
-            id
-            13      no  4.00  Advanced      Novice         1  1
-            26     yes  3.57  Advanced    Advanced         1  1
-            5       no  3.44    Novice      Novice         0  0
-            19     yes  1.98  Advanced    Advanced         0  1
-            15     yes  4.00  Advanced    Advanced         1  1
-            40     yes  3.95    Novice    Beginner         0  0
-            7      yes  2.33    Novice      Novice         1  0
-            22     yes  3.46    Novice    Beginner         0  0
-            36      no  3.00  Advanced      Novice         0  1
-            38     yes  2.65  Advanced    Beginner         1  1
+                      data   pattern     level
+            id                                
+            8     log%2024      l_g%  Beginner
+            9    temp_file  temp!__%    Novice
+            3    data_2024        d%    Novice
+            2    user%2025   user!%%  Beginner
+            1   user_Alpha   user!_%  Advanced
+            5      prod_01  prod_01%  Beginner
             >>>
         """
+        # Validate and format arguments
+        other, escape = self._format_ilike_like_args(other, escape_char)        
         return _SQLColumnExpression(
-            literal_column("{} (CASESPECIFIC) LIKE '{}'".format(self.compile(), other)))
+            literal_column("{} (CASESPECIFIC) LIKE {}{}".format(self.compile(), other, escape)))
+
+    def rlike(self, pattern, case_sensitive=True):
+        """
+        DESCRIPTION:
+            Function to match a string against a regular expression pattern.
+
+        PARAMETERS:
+            pattern:
+                Required Argument.
+                Specifies a regular expression pattern to match against the column values.
+                Note:
+                    The pattern follows POSIX regular expression syntax.
+                Type: str OR ColumnExpression
+
+            case_sensitive:
+                Optional Argument.
+                Specifies whether the pattern matching is case-sensitive.
+                When set to False, the function ignores case sensitivity and matches 
+                the regex. Otherwise, function considers case sensitivity while matching regex.
+                Default: True
+                Type: bool
+
+        RAISES:
+            TeradataMlException
+
+        RETURNS:
+            ColumnExpression
+
+        EXAMPLES:
+            >>> load_example_data("dataframe","admissions_train")
+            >>> df = DataFrame("admissions_train")
+            >>> df
+                masters    gpa      stats programming  admitted
+            id
+            13      no     4.00  Advanced      Novice         1
+            26     yes     3.57  Advanced    Advanced         1
+            5       no     3.44    Novice      Novice         0
+            19     yes     1.98  Advanced    Advanced         0
+            15     yes     4.00  Advanced    Advanced         1
+            40     yes     3.95    Novice    Beginner         0
+            7      yes     2.33    Novice      Novice         1
+            22     yes     3.46    Novice    Beginner         0
+            36      no     3.00  Advanced      Novice         0
+            38     yes     2.65  Advanced    Beginner         1
+            
+            # Example 1: Find records whose 'stats' column contains 'van'.
+            >>> result = df[df.stats.rlike('.*van.*')]
+            >>> result
+                masters     gpa     stats  programming  admitted
+            id
+            13      no     4.00  Advanced      Novice         1
+            26     yes     3.57  Advanced    Advanced         1
+            34     yes     3.85  Advanced    Beginner         0
+            19     yes     1.98  Advanced    Advanced         0
+            15     yes     4.00  Advanced    Advanced         1
+            36      no     3.00  Advanced      Novice         0
+            38     yes     2.65  Advanced    Beginner         1
+
+            # Example 2: Find records whose 'stats' column ends with 'ced'.
+            >>> result = df[df.stats.rlike('.*ced$')]
+            >>> result
+               masters   gpa     stats programming  admitted
+            id                                              
+            34     yes  3.85  Advanced    Beginner         0
+            32     yes  3.46  Advanced    Beginner         0
+            11      no  3.13  Advanced    Advanced         1
+            30     yes  3.79  Advanced      Novice         0
+            28      no  3.93  Advanced    Advanced         1
+            16      no  3.70  Advanced    Advanced         1
+            14     yes  3.45  Advanced    Advanced         0
+            
+            # Example 3: Case-insensitive search for records containing 'NOVICE'.
+            >>> result = df[df.stats.rlike('NOVICE', case_sensitive=False)]
+            >>> result
+               masters   gpa   stats programming  admitted
+            id                                            
+            12      no  3.65  Novice      Novice         1
+            40     yes  3.95  Novice    Beginner         0
+            7      yes  2.33  Novice      Novice         1
+            5       no  3.44  Novice      Novice         0
+            22     yes  3.46  Novice    Beginner         0
+            37      no  3.52  Novice      Novice         1
+        """
+        # Validate arguments
+        arg_validate = []
+        arg_validate.append(["pattern", pattern, False, (str, ColumnExpression), True])
+        arg_validate.append(["case_sensitive", case_sensitive, True, (bool), True])
+        _Validators._validate_function_arguments(arg_validate)
+
+        if isinstance(pattern, ColumnExpression):
+            pattern = pattern.expression
+
+        # Set the case sensitivity modifier based on the parameter.
+        case_modifier = 'c' if case_sensitive else 'i'
+        return _SQLColumnExpression(
+            func.regexp_similar(self.expression, pattern, case_modifier) == 1,
+            type=INTEGER())
 
     @collect_queryband(queryband="DFC_startswith")
     def startswith(self, other):
@@ -7002,12 +7189,12 @@ class _SQLColumnExpression(_LogicalColumnExpression,
                 Specifies starting position to extract string from column.
                 Note:
                     Index position starts with 1 instead of 0.
-                Types: int
+                Types: int OR ColumnExpression
 
             length:
                 Required Argument.
                 Specifies the length of the string to extract from column.
-                Types: int
+                Types: int OR ColumnExpression
 
         RETURNS:
             ColumnExpression.
@@ -7040,10 +7227,218 @@ class _SQLColumnExpression(_LogicalColumnExpression,
                    emp_name  mgr_id mgr_name new_col
             emp_id
             500        Fred     400      Kim      on
+
+            # Example 3: Create a new column by passing ColumnExpression as
+            #            start_pos and length.
+            >>> df.assign(new_column = df.emp_name.substr(df.emp_id, df.mgr_id))
+                     emp_name  mgr_id mgr_name new_column
+            emp_id
+            1         Pat   2      Don        Pa
+
         """
-        return _SQLColumnExpression(func.substr(self.expression, start_pos, length),
+        # Handle cases where start_pos or length are ColumnExpressions.
+        start_pos_expr = start_pos.expression if isinstance(start_pos, _SQLColumnExpression) else start_pos
+        length_expr = length.expression if isinstance(length, _SQLColumnExpression) else length
+
+        return _SQLColumnExpression(func.substr(self.expression, start_pos_expr, length_expr),
                                     type=self.type)
 
+    def count_delimiters(self, delimiter):
+        """
+        DESCRIPTION:
+            Function to count the total number of occurrences of a specified delimiter.
+
+        PARAMETERS:
+            delimiter:
+                Required Argument.
+                Specifies the delimiter to count in the column values.
+                Types: str
+
+        RETURNS:
+            ColumnExpression.
+
+        EXAMPLES:
+        # Load sample data
+        >>> load_example_data("dataframe", "admissions_train")
+        >>> df = DataFrame("admissions_train")
+        
+        # Create a DataFrame with a column containing delimiters.
+        >>> df1 = df.assign(delim_col = 'ab.c.def.g')
+        >>> df1
+           masters   gpa     stats programming  admitted   delim_col
+        id                                                          
+        38     yes  2.65  Advanced    Beginner         1  ab.c.def.g
+        7      yes  2.33    Novice      Novice         1  ab.c.def.g
+        26     yes  3.57  Advanced    Advanced         1  ab.c.def.g
+        
+        # Example 1: Count the number of periods in column 'delim_col'.
+        >>> res = df1.assign(dot_count = df1.delim_col.count_delimiters('.'))
+        >>> res
+           masters   gpa     stats programming  admitted   delim_col  dot_count
+        id                                                                     
+        38     yes  2.65  Advanced    Beginner         1  ab.c.def.g          3
+        7      yes  2.33    Novice      Novice         1  ab.c.def.g          3
+        26     yes  3.57  Advanced    Advanced         1  ab.c.def.g          3
+
+        # Example 2: Count multiple delimiters in a string.
+        >>> df2 = df.assign(delim_col = 'a,b;c;d-e')
+        >>> res = df2.assign(
+        ...     comma_count = df2.delim_col.count_delimiters(','),
+        ...     semicolon_count = df2.delim_col.count_delimiters(';'),
+        ...     colon_count = df2.delim_col.count_delimiters(':'),
+        ...     dash_count = df2.delim_col.count_delimiters('-')
+        ... )
+        >>> res
+           masters   gpa     stats programming  admitted  delim_col colon_count comma_count dash_count  semicolon_count
+        id                                                                                                                
+        38     yes  2.65  Advanced    Beginner         1  a,b;c;d-e           0           1          1                2
+        7      yes  2.33    Novice      Novice         1  a,b;c;d-e           0           1          1                2
+        26     yes  3.57  Advanced    Advanced         1  a,b;c;d-e           0           1          1                2
+        5       no  3.44    Novice      Novice         0  a,b;c;d-e           0           1          1                2
+        """
+        
+        # Validate arguments
+        arg_validate = []
+        arg_validate.append(["delimiter", delimiter, False, (str), True])
+        _Validators._validate_function_arguments(arg_validate)
+        
+        # Calculate the count by comparing the original string length 
+        # with the length after removing all delimiters.
+        expression = (func.characters(self.expression) - func.characters(
+            func.oreplace(self.expression, delimiter, '')))// func.characters(delimiter)
+
+        return _SQLColumnExpression(expression, type=INTEGER())
+    
+    @collect_queryband(queryband="DFC_substringIndex")
+    def substring_index(self, delimiter, count):
+        """
+        DESCRIPTION:
+            Function to return the substring from a column before a specified 
+            delimiter, up to a given occurrence count.
+            
+        PARAMETERS:
+            delimiter:
+                Required Argument.
+                Specifies the delimiter string to split the column values.
+                Types: str
+
+            count:
+                Required Argument.
+                Specifies the number of occurrences of the delimiter to consider.
+                If positive, the substring is extracted from the start of the string.
+                If negative, the substring is extracted from the end of the string.
+                If zero, an empty string is returned.
+                Types: int
+        
+        RAISES:
+            TeradataMlException
+
+        RETURNS:
+            ColumnExpression.
+
+        EXAMPLES:
+            # Load the data to run the example.
+            >>> load_example_data("dataframe","admissions_train")
+            >>> df = DataFrame('admissions_train')
+
+            # Create a new column 'delim_col' with string.
+            >>> df1 = df.assign(delim_col = 'ab.c.def.g')
+            >>> df1
+               masters   gpa     stats programming  admitted   delim_col
+            id                                                          
+            38     yes  2.65  Advanced    Beginner         1  ab.c.def.g
+            7      yes  2.33    Novice      Novice         1  ab.c.def.g
+            26     yes  3.57  Advanced    Advanced         1  ab.c.def.g
+            5       no  3.44    Novice      Novice         0  ab.c.def.g
+            3       no  3.70    Novice    Beginner         1  ab.c.def.g
+            22     yes  3.46    Novice    Beginner         0  ab.c.def.g
+            1      yes  3.95  Beginner    Beginner         0  ab.c.def.g
+            17      no  3.83  Advanced    Advanced         1  ab.c.def.g
+            15     yes  4.00  Advanced    Advanced         1  ab.c.def.g
+            34     yes  3.85  Advanced    Beginner         0  ab.c.def.g
+
+            # Example 1: Create a new column 'new_column' by extracting the substring
+                         based on positive count.
+            >>> res = df1.assign(new_column = df1.delim_col.substring_index('.', 2))
+            >>> res
+               masters   gpa     stats programming  admitted   delim_col new_column
+            id                                                                     
+            34     yes  3.85  Advanced    Beginner         0  ab.c.def.g       ab.c
+            32     yes  3.46  Advanced    Beginner         0  ab.c.def.g       ab.c
+            11      no  3.13  Advanced    Advanced         1  ab.c.def.g       ab.c
+            30     yes  3.79  Advanced      Novice         0  ab.c.def.g       ab.c
+            28      no  3.93  Advanced    Advanced         1  ab.c.def.g       ab.c
+            16      no  3.70  Advanced    Advanced         1  ab.c.def.g       ab.c
+            35      no  3.68    Novice    Beginner         1  ab.c.def.g       ab.c
+            40     yes  3.95    Novice    Beginner         0  ab.c.def.g       ab.c
+            19     yes  1.98  Advanced    Advanced         0  ab.c.def.g       ab.c
+
+            # Example 2: Create a new column 'new_column' by extracting the substring
+                         based on negative count.
+            >>> res = df1.assign(new_column = df1.delim_col.substring_index('.', -3))
+            >>> res
+               masters   gpa     stats programming  admitted   delim_col new_column
+            id                                                                     
+            34     yes  3.85  Advanced    Beginner         0  ab.c.def.g    c.def.g
+            32     yes  3.46  Advanced    Beginner         0  ab.c.def.g    c.def.g
+            11      no  3.13  Advanced    Advanced         1  ab.c.def.g    c.def.g
+            30     yes  3.79  Advanced      Novice         0  ab.c.def.g    c.def.g
+            28      no  3.93  Advanced    Advanced         1  ab.c.def.g    c.def.g
+            16      no  3.70  Advanced    Advanced         1  ab.c.def.g    c.def.g
+            35      no  3.68    Novice    Beginner         1  ab.c.def.g    c.def.g
+            40     yes  3.95    Novice    Beginner         0  ab.c.def.g    c.def.g
+            19     yes  1.98  Advanced    Advanced         0  ab.c.def.g    c.def.g
+
+            # Example 3: Create a new column 'new_column' by extracting the substring
+                         with 2-character delimiter based on positive count.
+            >>> res = df1.assign(new_column = df1.delim_col.substring_index('c.d', 1))
+            >>> res
+               masters   gpa     stats programming  admitted   delim_col new_column
+            id                                                                     
+            34     yes  3.85  Advanced    Beginner         0  ab.c.def.g        ab.
+            32     yes  3.46  Advanced    Beginner         0  ab.c.def.g        ab.
+            11      no  3.13  Advanced    Advanced         1  ab.c.def.g        ab.
+            30     yes  3.79  Advanced      Novice         0  ab.c.def.g        ab.
+            28      no  3.93  Advanced    Advanced         1  ab.c.def.g        ab.
+            16      no  3.70  Advanced    Advanced         1  ab.c.def.g        ab.
+            35      no  3.68    Novice    Beginner         1  ab.c.def.g        ab.
+            40     yes  3.95    Novice    Beginner         0  ab.c.def.g        ab.
+
+        """
+        # Validate arguments
+        arg_validate = []
+        arg_validate.append(["delimiter", delimiter, False, (str), True])
+        arg_validate.append(["count", count, False, (int), True])
+        _Validators._validate_function_arguments(arg_validate)
+
+        # Create the SQL expression for substring_index.
+        if count == 0:
+            return _SQLColumnExpression(literal(""), type=self.type)
+            
+        elif count > 0:
+            # For positive count, return substring before the nth occurrence.
+            position = func.instr(self.expression, delimiter, 1, count)
+            # Handle the case where the delimiter is not found.
+            expression = case_when((position == 0, self.expression),
+                                    else_=func.substring(self.expression, 1, position - 1))
+        else:
+            # For negative count, we need to find substring after the (total - |count|)th delimiter
+            # First, get the total number of delimiters
+            total_delimiters = self.count_delimiters(delimiter).expression
+            
+            # Calculate the position to start from (convert negative count to positive position).
+            position = total_delimiters + count + 1
+            
+            # Handle the case where the absolute negative count exceeds the total number of delimiters.
+            expression = case_when((position > 0,
+                                    # Get substring after the nth occurrence from the beginning.
+                                    func.substring(self.expression, 
+                                                   func.instr(self.expression, delimiter, 1, position) + len(delimiter),
+                                                   func.characters(self.expression))),
+                                    else_=self.expression)
+            
+        return _SQLColumnExpression(expression, type=self.type)
+
     @collect_queryband(queryband="DFC_replace")
     def replace(self, to_replace, value=None):
         """
@@ -8954,568 +9349,13 @@ class _SQLColumnExpression(_LogicalColumnExpression,
         PARAMETERS:
             formatter:
                 Optional Argument.
-                Specifies the string to format the values of a column.
-                Type: str
-                Note:
+                Specifies the format for formatting the values of the column.
+                Type: str OR ColumnExpression 
+                Notes:
                    * If 'formatter' is omitted, numeric values is converted to a string exactly
                      long enough to hold its significant digits.
+                   * Get the supported formatters using `get_formatters("CHAR")` function.
 
-                * Formatter for Numeric types:
-                    +--------------------------------------------------------------------------------------------------+
-                    |    FORMATTER                             DESCRIPTION                                             |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    , (comma)                             A comma in the specified position.                      |
-                    |                                          A comma cannot begin a number format.                   |
-                    |                                          A comma cannot appear to the right of a decimal         |
-                    |                                          character or period in a number format.                 |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    1234             9,999             1,234     | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |   . (period)                             A decimal point.                                        |
-                    |                                          User can only specify one period in a number format.    |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    123.46             9999.9             123.5  | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    $                                     A value with a leading dollar sign.                     |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    1234             $9999              $1234    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    0                                     Leading zeros.                                          |
-                    |                                          Trailing zeros.                                         |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    1234             09999              01234    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    9                                     A value with the specified number of digits with a      |
-                    |                                          leading space if positive or with a leading minus       |
-                    |                                          if negative.                                            |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    1234             9999              1234      | |
-                    |                                              |    1234             999               ####      | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    B                                     Blank space for the integer part of a fixed point number|
-                    |                                          when the integer part is zero.                          |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    0.1234             B.999          Blank space| |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    C                                     The ISO currency symbol as specified in the ISOCurrency |
-                    |                                          element in the SDF file.                                |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    234              C999              USD234    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    D                                     The character that separates the integer and fractional |
-                    |                                          part of non-monetary values.                            |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    234.56           999D9             234.6     | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    EEEE                                  A value in scientific notation.                         |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    234.56           9.9EEEE             2.3E+02 | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    G                                     The character that separates groups of digits in the    |
-                    |                                          integer part of non-monetary values.                    |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    123456           9G99G99           1,234,56  | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    L                                     The string representing the local currency as specified |
-                    |                                          in the Currency element according to system settings.   |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    234              L999              $234      | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    MI                                    A trailing minus sign if the value is negative.         |
-                    |                                          The MI format element can appear only in the last       |
-                    |                                          position of a number format.                            |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    -1234            9999MI            1234-     | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    PR                                    A negative value in <angle brackets>, or                |
-                    |                                          a positive value with a leading and trailing blank.     |
-                    |                                          The PR format element can appear only in the last       |
-                    |                                          position of a number format.                            |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    -1234            9999PR            <1234>    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    S                                     A negative value with a leading or trailing minus sign. |
-                    |                                          a positive value with a leading or trailing plus sign.  |
-                    |                                          The S format element can appear only in the first or    |
-                    |                                          last position of a number format.                       |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    +1234            S9999             +1234     | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    TM                                    (text minimum format) Returns the smallest number of    |
-                    |                                          characters possible. This element is case insensitive.  |
-                    |                                          TM or TM9 return the number in fixed notation unless    |
-                    |                                          the output exceeds 64 characters. If the output exceeds |
-                    |                                          64 characters, the number is returned in scientific     |
-                    |                                          notation.                                               |
-                    |                                          TME returns the number in scientific notation with the  |
-                    |                                          smallest number of characters.                          |
-                    |                                          You cannot precede this element with an other element.  |
-                    |                                          You can follow this element only with one 9 or one E    |
-                    |                                          (or e), but not with any combination of these.          |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    1234             TM                1234      | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    U                                    (dual currency) The string that represents the dual     |
-                    |                                          currency as specified in the DualCurrency element       |
-                    |                                          according to system settings.                           |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    1234             U9999             $1234     | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    V                                     A value multiplied by 10 to the n (and, if necessary,   |
-                    |                                          rounded up), where n is the number of 9's after the V.  |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    1234             9999V99           123400    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    X                                     The hexadecimal value of the specified number of digits.|
-                    |                                          If the specified number is not an integer, the function |
-                    |                                          will round it to an integer.                            |
-                    |                                          This element accepts only positive values or zero.      |
-                    |                                          Negative values return an error. You can precede this   |
-                    |                                          element only with zero (which returns leading zeros) or |
-                    |                                          FM. Any other elements return an error. If you do not   |
-                    |                                          specify zero or FM, the return always has one leading   |
-                    |                                          blank.                                                  |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    1234             XXXX              4D2       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-
-                * Formatter for Date types:
-                    +--------------------------------------------------------------------------------------------------+
-                    |    FORMATTER                             DESCRIPTION                                             |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    -                                                                                             |
-                    |    /                                                                                             |
-                    |    ,                                     Punctuation characters are ignored and text enclosed in |
-                    |    .                                     quotation marks is ignored.                             |
-                    |    ;                                                                                             |
-                    |    :                                                                                             |
-                    |    "text"                                                                                        |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    03/09/17         MM-DD             09-17     | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    AD                                    AD indicator.                                           |
-                    |    A.D.                                                                                          |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    03/09/17         CCAD              21AD      | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    AM                                    Meridian indicator.                                     |
-                    |    A.M.                                                                                          |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    03/09/17         CCAM              21AM     | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    BC                                                                                            |
-                    |    B.C.                                  BC indicator.                                           |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    03/09/17         CCBC              21BC      | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    CC                                    Century.                                                |
-                    |    SCC                                   If the last 2 digits of a 4-digit year are between 01   |
-                    |                                          and 99 inclusive, the century is 1 greater than the     |
-                    |                                          first 2 digits of that year.                            |
-                    |                                          If the last 2 digits of a 4-digit year are 00, the      |
-                    |                                          century is the same as the first 2 digits of that year. |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    03/09/17         CCBC              21BC      | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    D                                     Day of week (1-7).                                      |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    03/09/17         D                 4         | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    DAY	                               Name of day.                                            |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    03/09/17         DAY               WEDNESDAY | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    DD                                    Day of month (1-31).                                    |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    03/09/17         DD                17        | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    DDD                                   Day of year (1-366).                                    |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    03/09/17         DDD               260       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    DL                                    Date Long. Equivalent to the format string ‘FMDay,      |
-                    |                                          Month FMDD, YYYY’.                                      |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data       formatter         result             | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 03/09/17   DL      Wednesday, September 17, 2003| |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    DS                                    Date Short. Equivalent to the format string             |
-                    |                                          ‘FMMM/DD/YYYYFM’.                                       |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    03/09/17         DS                9/17/2003 | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    DY                                    abbreviated name of day.                                |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    data             formatter         result    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              |    03/09/17         DY                WED       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    FF                                    [1..9]	Fractional seconds.                            |
-                    |                                          Use [1..9] to specify the number of fractional digits.  |
-                    |                                          FF without any number following it prints a decimal     |
-                    |                                          followed by digits equal to the number of fractional    |
-                    |                                          seconds in the input data type. If the data type has no |
-                    |                                          fractional digits, FF prints nothing.                   |
-                    |                                          Any fractional digits beyond 6 digits are truncated.    |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  FF         000000   | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    HH                                                                                            |
-                    |    HH12                                 Hour of day (1-12).                                      |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  HH         09       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    HH24	                              Hour of the day (0-23).                                  |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  HH24         09     | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    IW                                   Week of year (1-52 or 1-53) based on ISO model.          |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  IW         01       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    IYY                                                                                           |
-                    |    IY                                   Last 3, 2, or 1 digits of ISO year.                      |
-                    |    I                                                                                             |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  IY         16       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    IYYY	                              4-digit year based on the ISO standard.                  |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  IYYY         2016   | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    J                                    Julian day, the number of days since January 1, 4713 BC. |
-                    |                                         Number specified with J must be integers.                |
-                    |                                         Teradata uses the Gregorian calendar in calculations to  |
-                    |                                         and from Julian Days.                                    |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  J          2457394  | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    MI                                   Minute (0-59).                                           |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  MI         08       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    MM                                   Month (01-12).                                           |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  MM         01       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    MON	                              Abbreviated name of month.                               |
-                    |                                          Example:                                                |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  MON        JAN      | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    MONTH	                              Name of month.                                           |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  MONTH      JANUARY  | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    PM                                                                                            |
-                    |    P.M.                                 Meridian indicator.                                      |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  HHPM       09PM     | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    Q                                    Quarter of year (1, 2, 3, 4).                            |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  Q       1           | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    RM                                   Roman numeral month (I - XII).                           |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  RM         I        | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    SP                                   Spelled. Any numeric element followed by SP is spelled in|
-                    |                                         English words. The words are capitalized according to how|
-                    |                                         the element is capitalized.                              |
-                    |                                         For example: 'DDDSP' specifies all uppercase, 'DddSP'    |
-                    |                                         specifies that the first letter is capitalized, and      |
-                    |                                         'dddSP' specifies all lowercase.                         |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  HHSP       NINE     | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    SS                                   Second (0-59).                                           |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  SS         03       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    SSSSS	                              Seconds past midnight (0-86399).                         |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  SSSSS      32883    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    TS                                   Time Short. Equivalent to the format string              |
-                    |                                         'HH:MI:SS AM'.                                           |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  TS     09:08:01 AM  | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    TZH	                              Time zone hour.                                          |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  TZH        +00      | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    TZM	                              Time zone minute.                                        |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  TZM        00       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    TZR	                              Time zone region. Equivalent to the format string        |
-                    |                                         'TZH:TZM'.                                               |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  TZR        +00:00   | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    WW                                   Week of year (1-53) where week 1 starts on the first day |
-                    |                                         of the year and continues to the 7th day of the year.    |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  WW         01       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    W                                    Week of month (1-5) where week 1 starts on the first day |
-                    |                                         of the month and ends on the seventh.                    |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  W          1        | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    X                                    Local radix character.                                   |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  MMXYY      01.16    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    Y,YYY	                              Year with comma in this position.                        |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                        formatter  result   | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  Y,YYY      2,016    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    YEAR                                 Year, spelled out. S prefixes BC dates with a minus sign.|
-                    |    SYEAR                                                                                         |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                     formatter  result      | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  YEAR  TWENTY SIXTEEN| |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    YYYY                                                                                          |
-                    |    SYYYY                                4-digit year. S prefixes BC dates with a minus sign.     |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                     formatter  result      | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  YYYY    2016        | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    YYY                                  Last 3, 2, or 1 digit of year.                           |
-                    |    YY                                   If the current year and the specified year are both in   |
-                    |    Y                                    the range of 0-49, the date is in the current century.   |
-                    |                                         Example:                                                 |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                     formatter  result      | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01.000000  YY      16          | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
 
         RAISES:
             TypeError, ValueError, TeradataMlException
@@ -9525,94 +9365,188 @@ class _SQLColumnExpression(_LogicalColumnExpression,
 
         EXAMPLES:
             # Load the data to run the example.
-            >>> load_example_data("uaf", "stock_data")
+            >>> load_example_data("teradataml", "tochar_data")
 
-            # Create a DataFrame on 'stock_data' table.
-            >>> df = DataFrame("stock_data")
+            # Create a DataFrame on 'tochar_data' table.
+            >>> df = DataFrame("tochar_data")
             >>> df
-                        seq_no timevalue  magnitude
-            data_set_id
-            556               3  19/01/16     61.080
-            556               5  19/01/30     63.810
-            556               6  19/02/06     63.354
-            556               7  19/02/13     63.871
-            556               9  19/02/27     61.490
-            556              10  19/03/06     61.524
-            556               8  19/02/20     61.886
-            556               4  19/01/23     63.900
-            556               2  19/01/09     61.617
-            556               1  19/01/02     60.900
+                int_col  float_col  date_col int_format float_format date_format
+            id                                                                  
+            3      1314     123.46  03/09/17       XXXX          TM9          DY
+            0      1234     234.56  03/09/17      9,999        999D9       MM-DD
+            2       789     123.46  03/09/17       0999       9999.9         DAY
+            1       456     234.56  03/09/17       $999      9.9EEEE        CCAD
+
             >>> df.tdtypes
-            column         type
-            data_set_id    INTEGER()
-            seq_no         INTEGER()
-            timevalue         DATE()
-            magnitude        FLOAT()
-
-            # Example 1: Convert 'seq_no' column to character type.
-            >>> res = df.assign(seq_no = df.seq_no.to_char())
+            COLUMN NAME	                                   TYPE
+            id                                        INTEGER()
+            int_col                                   INTEGER()
+            float_col                                   FLOAT()
+            date_col                                     DATE()
+            int_format      VARCHAR(length=20, charset='LATIN')
+            float_format    VARCHAR(length=20, charset='LATIN')
+            date_format     VARCHAR(length=20, charset='LATIN')
+
+            # Example 1: Convert 'int_col' column to character type.
+            >>> res = df.assign(int_col = df.int_col.to_char())
             >>> res
-                        seq_no timevalue  magnitude
-            data_set_id
-            556              3  19/01/16     61.080
-            556              5  19/01/30     63.810
-            556              6  19/02/06     63.354
-            556              7  19/02/13     63.871
-            556              9  19/02/27     61.490
-            556             10  19/03/06     61.524
-            556              8  19/02/20     61.886
-            556              4  19/01/23     63.900
-            556              2  19/01/09     61.617
-            556              1  19/01/02     60.900
+                int_col  float_col  date_col int_format float_format date_format
+            id                                                                 
+            0     1234     234.56  03/09/17      9,999        999D9       MM-DD
+            3     1314     123.46  03/09/17       XXXX          TM9          DY
+            2      789     123.46  03/09/17       0999       9999.9         DAY
+            1      456     234.56  03/09/17       $999      9.9EEEE        CCAD
+
             >>> res.tdtypes
-            columnn         type
-            data_set_id    INTEGER()
-            seq_no         VARCHAR()
-            timevalue         DATE()
-            magnitude        FLOAT()
-
-            # Example 2: Convert "magnitude" column to character type in '$99.9' format.
-            >>> res = df.assign(char_column = df.magnitude.to_char('$99.9'))
+            COLUMN NAME	                                   TYPE
+            id                                        INTEGER()
+            int_col                                   VARCHAR()
+            float_col                                   FLOAT()
+            date_col                                     DATE()
+            int_format      VARCHAR(length=20, charset='LATIN')
+            float_format    VARCHAR(length=20, charset='LATIN')
+            date_format     VARCHAR(length=20, charset='LATIN')
+
+            # Example 2: Convert 'float_col' column to character type in '$999.9' format.
+            >>> res = df.assign(char_col = df.float_col.to_char('$999.9'))
             >>> res
-                        seq_no timevalue  magnitude char_column
-            data_set_id
-            556               3  19/01/16     61.080       $61.1
-            556               5  19/01/30     63.810       $63.8
-            556               6  19/02/06     63.354       $63.4
-            556               7  19/02/13     63.871       $63.9
-            556               9  19/02/27     61.490       $61.5
-            556              10  19/03/06     61.524       $61.5
-            556               8  19/02/20     61.886       $61.9
-            556               4  19/01/23     63.900       $63.9
-            556               2  19/01/09     61.617       $61.6
-            556               1  19/01/02     60.900       $60.9
-
-            # Example 3: Convert "timevalue" column to character type in 'YYYY-DAY-MONTH' format
-            >>> res = df.assign(timevalue = df.timevalue.to_char('YYYY-DAY-MONTH'))
+                int_col  float_col  date_col int_format float_format date_format char_col
+            id                                                                           
+            0      1234     234.56  03/09/17      9,999        999D9       MM-DD   $234.6
+            3      1314     123.46  03/09/17       XXXX          TM9          DY   $123.5
+            2       789     123.46  03/09/17       0999       9999.9         DAY   $123.5
+            1       456     234.56  03/09/17       $999      9.9EEEE        CCAD   $234.6
+
+            # Example 3: Convert 'date_col' column to character type in 'YYYY-DAY-MONTH' format
+            >>> res = df.assign(char_col = df.date_col.to_char('YYYY-DAY-MONTH'))
             >>> res
-                        seq_no                 timevalue  magnitude
-            data_set_id
-            556               3  2019-WEDNESDAY-JANUARY       61.080
-            556               5  2019-WEDNESDAY-JANUARY       63.810
-            556               6  2019-WEDNESDAY-FEBRUARY      63.354
-            556               7  2019-WEDNESDAY-FEBRUARY      63.871
-            556               9  2019-WEDNESDAY-FEBRUARY      61.490
-            556              10  2019-WEDNESDAY-MARCH         61.524
-            556               8  2019-WEDNESDAY-FEBRUARY      61.886
-            556               4  2019-WEDNESDAY-JANUARY       63.900
-            556               2  2019-WEDNESDAY-JANUARY       61.617
-            556               1  2019-WEDNESDAY-JANUARY       60.900
+                int_col  float_col  date_col int_format float_format date_format                  char_col
+            id                                                                                            
+            3      1314   123.4600  03/09/17       XXXX          TM9          DY  1903-THURSDAY -SEPTEMBER
+            0      1234   234.5600  03/09/17      9,999        999D9       MM-DD  1903-THURSDAY -SEPTEMBER
+            2       789   123.4600  03/09/17       0999       9999.9         DAY  1903-THURSDAY -SEPTEMBER
+            1       456   234.5600  03/09/17       $999      9.9EEEE        CCAD  1903-THURSDAY -SEPTEMBER
+
+            # Example 4: Convert 'int_col' column to character type in 'int_format' column format.
+            >>> res = df.assign(char_col = df.int_col.to_char(df.int_format))
+            >>> res
+                int_col  float_col  date_col int_format float_format date_format char_col
+            id                                                                           
+            0      1234     234.56  03/09/17      9,999        999D9       MM-DD    1,234
+            3      1314     123.46  03/09/17       XXXX          TM9          DY      522
+            2       789     123.46  03/09/17       0999       9999.9         DAY     0789
+            1       456     234.56  03/09/17       $999      9.9EEEE        CCAD     $456
+
+            # Example 5: Convert 'float_col' column to character type in 'float_format' column format.
+            >>> res = df.assign(char_col = df.float_col.to_char(df.float_format))
+            >>> res
+                int_col  float_col  date_col int_format float_format date_format   char_col
+            id                                                                             
+            2       789     123.46  03/09/17       0999       9999.9         DAY      123.5
+            3      1314     123.46  03/09/17       XXXX          TM9          DY     123.46
+            1       456     234.56  03/09/17       $999      9.9EEEE        CCAD    2.3E+02
+            0      1234     234.56  03/09/17      9,999        999D9       MM-DD      234.6
+
+            # Example 4: Convert 'date_col' column to character type in 'date_format' column format.
+            >>> res = df.assign(char_col = df.date_col.to_char(df.date_format))
+            >>> res
+                int_col  float_col  date_col int_format float_format date_format   char_col
+            id                                                                             
+            0      1234     234.56  03/09/17      9,999        999D9       MM-DD      09-17
+            3      1314     123.46  03/09/17       XXXX          TM9          DY        THU
+            2       789     123.46  03/09/17       0999       9999.9         DAY   THURSDAY 
+            1       456     234.56  03/09/17       $999      9.9EEEE        CCAD       20AD
+
         """
         arg_validate = []
-        arg_validate.append(["formatter", formatter, True, (str), True])
+        arg_validate.append(["formatter", formatter, True, (str, ColumnExpression), True])
 
         # Validate argument types
         _Validators._validate_function_arguments(arg_validate)
 
         _args=[self.expression]
         if formatter:
+            formatter = formatter.expression if isinstance(formatter, ColumnExpression) else formatter
             _args.append(formatter)
         return _SQLColumnExpression(func.to_char(*_args), type=VARCHAR())
+    
+    def to_number(self, formatter=None):
+        """
+        DESCRIPTION:
+            Converts a string-like representation of a number to NUMBER type.
+            
+        PARAMETERS:
+            formatter:
+                Optional Argument.
+                Specifies a variable length string containing formatting characters
+                that define the format of the columns.
+                Type: str OR ColumnExpression
+                Notes:
+                    * If 'formatter' is omitted, numeric values is converted to a string exactly
+                      long enough to hold its significant digits.
+                    * Get the supported formatters using `get_formatters("NUMERIC")` function.
+                    
+        RAISES:
+            TypeError, ValueError, TeradataMlException
+            
+        RETURNS:
+            ColumnExpression
+            
+        EXAMPLES:
+            # Load the data to run the example.
+            >>> load_example_data("teradataml", "to_num_data")
+
+            # Create a DataFrame on 'to_num_data' table.
+            >>> df = DataFrame("to_num_data")
+            >>> df
+            price col_format
+            $1234      $9999
+            USD123      C999
+            78.12      99.99
+
+            #  Example 1: Convert 'price' column to number type without passing any formatter.
+            >>> res = df.assign(new_col=df.price.to_number())
+            >>> res
+            price col_format  new_col
+            $1234      $9999      NaN
+            USD123      C999      NaN
+            78.12      99.99    78.12
+
+            #  Example 2: Convert 'price' column to number type by passing formatter as string.
+            >>> res = df.assign(new_col=df.price.to_number('99.99'))
+            >>> res
+            price col_format  new_col
+            $1234      $9999      NaN
+            USD123      C999      NaN
+            78.12      99.99    78.12
+
+            #  Example 3: Convert 'price' column to number type by passing formatter as ColumnExpression.
+            >>> res = df.assign(new_col=df.price.to_number(df.col_format))
+            >>> res
+            price col_format  new_col
+             $1234     $9999     1234
+            USD123      C999      123
+             78.12     99.99    78.12
+
+            >>> df.tdtypes
+            price	    VARCHAR(length=20, charset='LATIN')
+            col_format	VARCHAR(length=20, charset='LATIN')
+            new_col	                               NUMBER()
+      
+        """
+
+        arg_validate = []
+        arg_validate.append(["formatter", formatter, True, (str, ColumnExpression), True])
+
+        # Validate argument types
+        _Validators._validate_function_arguments(arg_validate)
+        
+        _args = [self.expression]
+        if formatter is not None:
+            formatter = formatter.expression if isinstance(formatter, ColumnExpression) else formatter
+            _args.append(formatter)
+
+        return _SQLColumnExpression(func.to_number(*_args), type=NUMBER())
 
     def to_date(self, formatter=None):
         """
@@ -9625,213 +9559,10 @@ class _SQLColumnExpression(_LogicalColumnExpression,
                 Specifies a variable length string containing formatting characters
                 that define the format of column.
                 Type: str
-                Note:
+                Notes:
                     * If "formatter" is omitted, the following default date format is used: 'YYYY-MM-DD'
-                * formatter for date type:
-                    +--------------------------------------------------------------------------------------------------+
-                    |    FORMATTER                             DESCRIPTION                                             |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    -                                                                                             |
-                    |    /                                                                                             |
-                    |    ,                                     Punctuation characters are ignored and text enclosed in |
-                    |    .                                     quotation marks is ignored.                             |
-                    |    ;                                                                                             |
-                    |    :                                                                                             |
-                    |    "text"                                                                                        |
-                    |                                         Example: Date with value '2003-12-10'                    |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data             formatter          value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | '2003-12-10'     YYYY-MM-DD         03/12/10    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    D                                     Day of week (1-7).                                      |
-                    |                                          Example: day of week with value '2'                     |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter           value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2               D                   24/01/01    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    DAY	                               Name of day.                                            |
-                    |                                          Example: Date with value '2024-TUESDAY-01-30'           |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                formatter         value     | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2024-TUESDAY-01-30   YYYY-DAY-MM-DD   24/01/30  | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    DD                                    Day of month (1-31).                                    |
-                    |                                          Example: Date with value '2003-10-25'                   |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter           value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2003-10-25       YYYY-MM-DD         03/10/25    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    DDD	                               Day of year (1-366).                                    |
-                    |                                          Example: Date with value '2024-366'                     |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter           value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2024-366       YYYY-DDD             24/12/31    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    DY                                    abbreviated name of day.                                |
-                    |                                          Example: Date with value '2024-Mon-01-29'               |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter           value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2024-Mon-01-29   YYYY-DY-MM-DD   24/01/29       | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    HH                                                                                            |
-                    |    HH12                                 Hour of day (1-12).                                      |
-                    |                                          Example: Date with value '2016-01-06 09:08:01'          |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data                formatter            value  | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-01-06 09:08:01 YYYY-MM-DD HH:MI:SS  6/01/06| |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    HH24	                              Hour of the day (0-23).                                  |
-                    |                                          Example:  Date with value '2016-01-06 23:08:01'         |
-                    |                                           +----------------------------------------------------+ |
-                    |                                           | data                formatter              value   | |
-                    |                                           +----------------------------------------------------+ |
-                    |                                           | 2016-01-06 23:08:01 YYYY-MM-DD HH24:MI:SS  6/01/06 | |
-                    |                                           +----------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    J                                    Julian day, the number of days since January 1, 4713 BC. |
-                    |                                         Number specified with J must be integers.                |
-                    |                                         Teradata uses the Gregorian calendar in calculations to  |
-                    |                                         and from Julian Days.                                    |
-                    |                                          Example: Number of julian days with value '2457394'     |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter           value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2457394         J                   16/01/06    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    MI                                   Minute (0-59).                                           |
-                    |                                          Example: Date with value '2016-01-06 23:08:01'          |
-                    |                                           +----------------------------------------------------+ |
-                    |                                           | data                formatter              value  | |
-                    |                                           +----------------------------------------------------+ |
-                    |                                           | 2016-01-06 23:08:01 YYYY-MM-DD HH24:MI:SS  6/01/06 | |
-                    |                                           +----------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    MM                                   Month (01-12).                                           |
-                    |                                          Example: Date with value '2016-01-06 23:08:01'          |
-                    |                                           +----------------------------------------------------+ |
-                    |                                           | data                formatter              value  | |
-                    |                                           +----------------------------------------------------+ |
-                    |                                           | 2016-01-06 23:08:01 YYYY-MM-DD HH24:MI:SS  6/01/06 | |
-                    |                                           +----------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    MON	                              Abbreviated name of month.                               |
-                    |                                          Example: Date with value '2016-JAN-06'                  |
-                    |                                           +----------------------------------------------------+ |
-                    |                                           | data                formatter              value   | |
-                    |                                           +----------------------------------------------------+ |
-                    |                                           | 2016-JAN-06         YYYY-MON-DD           16/01/06 | |
-                    |                                           +----------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    MONTH	                              Name of month.                                           |
-                    |                                          Example: Date with value '2016-JANUARY-06'              |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter              value    | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2016-JANUARY-06  YYYY-MONTH-DD         16/01/06 | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    PM                                                                                            |
-                    |    P.M.                                 Meridian indicator.                                      |
-                    |                                          Example:  Date with value '2016-01-06 23:08:01 PM'      |
-                    |                                      +---------------------------------------------------------+ |
-                    |                                      | data                   formatter                value   | |
-                    |                                      +---------------------------------------------------------+ |
-                    |                                      | 2016-01-06 23:08:01 PM YYYY-MM-DD HH24:MI:SS PM 16/01/06| |
-                    |                                      +---------------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    RM                                   Roman numeral month (I - XII).                           |
-                    |                                          Example: Date with value '2024-XII'                     |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter           value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2024-XII       YYYY-RM             24/12/01     | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    RR                                   Stores 20th century dates in the 21st century using only |
-                    |                                         2 digits. If the current year and the specified year are |
-                    |                                         both in the range of 0-49, the date is in the current    |
-                    |                                         century.                                                 |
-                    |                                         Example: Date with value '2024-365, 21'                  |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter           value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2024-365, 21      YYYY-DDD, RR      21/12/31    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    RRRR	                              Round year. Accepts either 4-digit or 2-digit input.     |
-                    |                                         2-digit input provides the same return as RR.            |
-                    |                                          Example: Date with value '2024-365, 21'                  |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter           value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2024-365, 21       YYYY-DDD, RRRR   24/12/31    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    SS                                   Second (0-59).                                           |
-                    |                                          Example: Date with value '2016-01-06 23:08:01'          |
-                    |                                           +----------------------------------------------------+ |
-                    |                                           | data                formatter              value   | |
-                    |                                           +----------------------------------------------------+ |
-                    |                                           | 2016-01-06 23:08:01 YYYY-MM-DD HH24:MI:SS  6/01/06 | |
-                    |                                           +----------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    SSSSS	                              Seconds past midnight (0-86399).                         |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    TZH	                              Time zone hour.                                          |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    TZM	                              Time zone minute.                                        |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    X                                    Local radix character.                                   |
-                    |                                         Example: Date with value '2024.366'                      |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter           value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2024.366       YYYYXDDD             24/12/31    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    Y,YYY	                              Year with comma in this position.                        |
-                    |                                          Example: Date with value '2,024-366'                    |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter           value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2,024-366       Y,YYY-DDD           24/12/31    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    YYYY                                                                                          |
-                    |    SYYYY                                4-digit year. S prefixes BC dates with a minus sign.     |
-                    |                                          Example: Date with value '2024-366'                     |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter           value       | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 2024-366       YYYY-DDD             24/12/31    | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-                    |    YYY                                  Last 3, 2, or 1 digit of year.                           |
-                    |    YY                                   If the current year and the specified year are both in   |
-                    |    Y                                    the range of 0-49, the date is in the current century.   |
-                    |                                          Example: Date with value '24-366'                       |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | data            formatter       value           | |
-                    |                                              +-------------------------------------------------+ |
-                    |                                              | 24-366       YY-DDD             24/12/31        | |
-                    |                                              +-------------------------------------------------+ |
-                    +--------------------------------------------------------------------------------------------------+
-
+                    * Get the supported formatters using `get_formatters("DATE")` function.
+                    
         RAISES:
             TypeError, ValueError, TeradataMlException
 
@@ -9907,7 +9638,7 @@ class _SQLColumnExpression(_LogicalColumnExpression,
         if formatter:
             _args.append(formatter)
         return _SQLColumnExpression(func.to_date(*_args), type=DATE())
-
+    
     def trunc(self, expression=0, formatter=None):
         """
         DESCRIPTION:
@@ -10656,7 +10387,7 @@ class _SQLColumnExpression(_LogicalColumnExpression,
         value = value.expression if isinstance(value, _SQLColumnExpression) else value
         return _SQLColumnExpression(_fun(self.expression, value), type=type_)
 
-    def parse_url(self, url_part):
+    def parse_url(self, url_part, key=None):
         """
         DESCRIPTION:
             Extracts a specific part from the URL.
@@ -10668,6 +10399,13 @@ class _SQLColumnExpression(_LogicalColumnExpression,
                 Permitted Values: HOST, PATH, QUERY, REF, PROTOCOL, FILE, AUTHORITY, USERINFO
                 Type: str or ColumnExpression
 
+            key:
+                Optional Argument.
+                Specifies the key to be used for extracting the value from the query string.
+                Note:
+                    * Applicable only when url_part is set to 'QUERY'.
+                Type: str or ColumnExpression
+
         Returns:
             ColumnExpression
 
@@ -10678,43 +10416,96 @@ class _SQLColumnExpression(_LogicalColumnExpression,
             # Create a DataFrame on 'url_data' table.
             >>> df = DataFrame("url_data")
             >>> df
-                                                                        urls       part
-            id
-            3                                       https://www.facebook.com       HOST
-            6              smtp://user:password@smtp.example.com:21/file.txt   USERINFO
-            4   https://teracloud-pod-services-pod-account-service.dummyvalu      QUERY
-            2   https://example.net/path4/path5/path6?query4=value4#fragment        REF
-            0                                   http://example.com:8080/path       FILE
-            1                                      ftp://example.net:21/path       PATH
-            5                        http://pg.example.ml/path150#fragment90  AUTHORITY
-            7                                         https://www.google.com   PROTOCOL
-
-            # Example 1: Extract components from column 'urls' using column 'part'
+                                                                        urls       part     query_key
+            id                                                                                       
+            3                                       https://www.facebook.com       HOST  facebook.com
+            8             http://example.com/api?query1=value1&query2=value2      QUERY        query1
+            6              smtp://user:password@smtp.example.com:21/file.txt   USERINFO      password
+            4   https://teracloud-pod-services-pod-account-service.dummyvalu      QUERY          None
+            0                                   http://example.com:8080/path       FILE          path
+            2   https://example.net/path4/path5/path6?query4=value4#fragment        REF     fragment3
+            1                                      ftp://example.net:21/path       PATH          path
+            5                        http://pg.example.ml/path150#fragment90  AUTHORITY    fragment90
+            7                                         https://www.google.com   PROTOCOL    google.com
+
+            # Example 1: Extract components from column 'urls' using column 'part'.
             >>> df.assign(col = df.urls.parse_url(df.part))
-                                                                        urls       part               col
-            id
-            3                                       https://www.facebook.com       HOST  www.facebook.com
-            6              smtp://user:password@smtp.example.com:21/file.txt   USERINFO     user:password
-            4   https://teracloud-pod-services-pod-account-service.dummyvalu      QUERY              None
-            2   https://example.net/path4/path5/path6?query4=value4#fragment        REF          fragment
-            0                                   http://example.com:8080/path       FILE             /path
-            1                                      ftp://example.net:21/path       PATH             /path
-            5                        http://pg.example.ml/path150#fragment90  AUTHORITY     pg.example.ml
-            7                                         https://www.google.com   PROTOCOL             https
-            >>>
+                                                                        urls       part     query_key                          col
+            id                                                                                                                    
+            3                                       https://www.facebook.com       HOST  facebook.com             www.facebook.com
+            8             http://example.com/api?query1=value1&query2=value2      QUERY        query1  query1=value1&query2=value2
+            6              smtp://user:password@smtp.example.com:21/file.txt   USERINFO      password                user:password
+            4   https://teracloud-pod-services-pod-account-service.dummyvalu      QUERY          None                         None
+            0                                   http://example.com:8080/path       FILE          path                        /path
+            2   https://example.net/path4/path5/path6?query4=value4#fragment        REF     fragment3                     fragment
+            1                                      ftp://example.net:21/path       PATH          path                        /path
+            5                        http://pg.example.ml/path150#fragment90  AUTHORITY    fragment90                pg.example.ml
+            7                                         https://www.google.com   PROTOCOL    google.com                        https
+            
+            # Example 2: Extract components from column 'urls' using 'part' and
+            #            'query_key' column.
+            >>> df.assign(col = df.urls.parse_url(df.part, df.query_key))
+                                                                        urls       part     query_key     col
+            id                                                                                               
+            3                                       https://www.facebook.com       HOST  facebook.com    None
+            8             http://example.com/api?query1=value1&query2=value2      QUERY        query1  value1
+            6              smtp://user:password@smtp.example.com:21/file.txt   USERINFO      password    None
+            4   https://teracloud-pod-services-pod-account-service.dummyvalu      QUERY          None    None
+            0                                   http://example.com:8080/path       FILE          path    None
+            2   https://example.net/path4/path5/path6?query4=value4#fragment        REF     fragment3    None
+            1                                      ftp://example.net:21/path       PATH          path    None
+            5                        http://pg.example.ml/path150#fragment90  AUTHORITY    fragment90    None
+            7                                         https://www.google.com   PROTOCOL    google.com    None
+
+            # Extract components from column 'urls' using 'part' and 'query_key' str.
+            >>> df.assign(col = df.urls.parse_url('QUERY', 'query2'))
+                                                                        urls       part     query_key     col
+            id                                                                                               
+            3                                       https://www.facebook.com       HOST  facebook.com    None
+            8             http://example.com/api?query1=value1&query2=value2      QUERY        query1  value2
+            6              smtp://user:password@smtp.example.com:21/file.txt   USERINFO      password    None
+            4   https://teracloud-pod-services-pod-account-service.dummyvalu      QUERY          None    None
+            0                                   http://example.com:8080/path       FILE          path    None
+            2   https://example.net/path4/path5/path6?query4=value4#fragment        REF     fragment3    None
+            1                                      ftp://example.net:21/path       PATH          path    None
+            5                        http://pg.example.ml/path150#fragment90  AUTHORITY    fragment90    None
+            7                                         https://www.google.com   PROTOCOL    google.com    None
         """
 
         # Validating Arguments
         arg_type_matrix = []
         arg_type_matrix.append(["url_part", url_part, False, (str, ColumnExpression), True])
+        arg_type_matrix.append(["key", key, True, (str, ColumnExpression), True])
         _Validators._validate_function_arguments(arg_type_matrix)
 
+        # If key is provided and url_part is QUERY, then use regex to extract the value.
+        if key is not None:
+            query_expr = _SQLColumnExpression(func.regexp_substr(func.regexp_substr(self.expression, 
+                '[?&]' + (key.expression if isinstance(key, _SQLColumnExpression) else key) + '=([^&]*)'), '[^=]*$'), type=VARCHAR())
+            # If url_part is a column expression, then use case statement to extract the value.
+            if isinstance(url_part, _SQLColumnExpression):
+                whens = [(url_part == 'HOST', None),
+                    (url_part == 'PATH', None ),
+                    (url_part == 'QUERY', query_expr),
+                    (url_part == 'REF', None),
+                    (url_part == 'PROTOCOL', None),
+                    (url_part == 'FILE',None),
+                    (url_part == 'AUTHORITY', None),
+                    (url_part == 'USERINFO', None)]
+
+                from teradataml.dataframe.sql_functions import case
+                return case(whens)
+            
+            # If url_part is a string, then return the query expression directly.
+            if isinstance(url_part, str) and url_part == 'QUERY':
+                return query_expr
+         
         # Regex pattern used to extract 'url_part' is '^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?'.
         # teradataml does not support regex grouping hence in some cases first used 'regex_replace' and
         # then 'regex_substr' or vice-versa.
         _part_to_extract_dict = {'HOST': _SQLColumnExpression(
-            func.regexp_replace(func.regexp_substr(self.expression, '//([^/?#]*)'), '(//[^/?#]+@)|(//)|(:\d+)', ''),
-            type=VARCHAR()),
+                                     func.regexp_replace(func.regexp_substr(self.expression, '//([^/?#]*)'), '(//[^/?#]+@)|(//)|(:\d+)', ''),
+                                        type=VARCHAR()),
                                  'PATH': _SQLColumnExpression(func.regexp_substr(
                                      func.regexp_replace(self.expression, '^(([^:/?#]+):)?(//([^/?#]*))?', ''),
                                      '([^?#]*)'), type=VARCHAR()),