Skip to main content

PROPER Function

Converts an input string to propercase. Input can be a column reference or a string literal.

Propercase is strict title case. If the first character of any non-breaking segment of letters in the string is an alphabetical character, it is capitalized. Otherwise, the string is unchanged. See the examples below.

Wrangle vs. SQL: This function is part of Wrangle, a proprietary data transformation language. Wrangle is not SQL. For more information, see Wrangle Language.

Basic Usage

Column reference example:

proper(MyName)

Output: Returns the string values in the MyName column value written in Proper Case.

String literal example:

proper('Hello, world')

Output: The string Hello, World is written to the new column.

Syntax and Arguments

proper(column_string)

Argument

Required?

Data Type

Description

column_string

Y

string

Name of the column or string literal to be applied to the function

For more information on syntax standards, see Language Documentation Syntax Notes.

column_string

Name of the column or string constant to be converted.

  • Missing string or column values generate missing string results.

  • String constants must be quoted ('Hello, World').

  • Multiple columns and wildcards are not supported.

Usage Notes:

Required?

Data Type

Example Value

Yes

String literal or column reference

myColumn

Examples

Tip

For additional examples, see Common Tasks.

Example - uppercase, lowercase, propercase functions

This example demonstrates functions that can be used to change the case of String values.

Functions:

Item

Description

UPPER Function

All alphabetical characters in the input value are converted to uppercase in the output value.

LOWER Function

All alphabetical characters in the input value are converted to lowercase in the output value.

PROPER Function

Converts an input string to propercase. Input can be a column reference or a string literal.

Source:

In the following example, you can see a number of input values in the leftmost column. The output columns are blank.

input

uppercase

lowercase

propercase

AbCdEfGh IjKlMnO

go West, young man!

Oh, *(*$%(&! That HURT!

A11 w0rk and n0 0play makes Jack a dull boy.

Transformation:

To generate uppercase, lowercase, and propercase values in the output columns, use the following transforms:

Transformation Name

Edit column with formula

Parameter: Columns

uppercase

Parameter: Formula

UPPER(input)

Transformation Name

Edit column with formula

Parameter: Columns

lowercase

Parameter: Formula

LOWER(input)

Transformation Name

Edit column with formula

Parameter: Columns

propercase

Parameter: Formula

PROPER(input)

Results:

input

uppercase

lowercase

propercase

AbCdEfGh IjKlMnO

ABCDEFGH IJKLMNO

abcdefgh ijklmno

Abcdefgh Ijklmno

go West, young man!

GO WEST, YOUNG MAN!

go west, young man!

Go West, Young Man!

Oh, *(*$%(&! That HURT!

OH, *(*$%(&! THAT HURT!

oh, *(*$%(&! that hurt!

Oh, *(*$%(&! That Hurt!

A11 w0rk and n0 0play makes Jack a dull boy.

A11 W0RK AND N0 0PLAY MAKES JACK A DULL BOY.

a11 w0rk and n0 0play makes jack a dull boy.

A11 W0rk And N0 0play Makes Jack A Dull Boy.