トップ / 式評価・文字列・型変換

left / right

文字列の先頭・末尾から指定した文字数を取り出す。

left(col("code"), 3)
right(col("code"), 3)

pl.col("code").str.slice(0, 3)
pl.col("code").str.slice(-3)

挙動・設計の違い

Snowparkにはleft/rightという専用の関数があるが、Polarsには同名の専用メソッドが無く、substringのページで扱ったstr.sliceを使い分ける（開始位置0から3文字＝先頭3文字、開始位置-3＝末尾から3文字目以降を最後まで）。"ABCDEF"を実行して確認したところ、left(_, 3)は"ABC"、str.slice(0,3)も"ABC"、right(_, 3)は"DEF"、str.slice(-3)も"DEF"で一致する。

移行時の落とし穴

rightに対応するstr.slice(-3)は「末尾から3文字」を負のインデックスの開始位置だけで表現しており、substringのページで説明した1ベース/0ベースの違いに加えて、負の数を使う書き方に慣れていないと直感的に読みにくい。str.slice(-3)は「末尾から3文字目の位置から、指定が無ければ最後まで」という意味で、length引数を省略できる点もleft側（str.slice(0,3)はlength必須）との非対称性として押さえておく。

式評価・文字列・型変換の他のメソッド

• when / otherwise ── 条件に応じて異なる値を返す（複数分岐の条件式）。
• iff ── 条件が真か偽かで2つの値のどちらかを返す（2分岐専用のショートカット）。
• is_null / is_not_null ── 値がNULL（欠損）かどうかを判定する。
• coalesce ── 複数の列を左から順に見て、最初に見つかったNULLでない値を返す。
• cast ── 列の型を別の型に変換する。
• substring ── 文字列の一部を指定した位置から切り出す。
• concat（文字列連結） ── 複数の列・文字列を1つにつなげる。
• upper / lower ── 文字列を大文字・小文字に統一する。
• trim / ltrim / rtrim ── 文字列の前後にある空白（または指定した文字）を取り除く。
• to_date ── 文字列を日付型に変換する。
• date_trunc ── 日付・時刻を指定した単位（月・年など）で切り捨てる。
• datediff ── 2つの日付・時刻の差を、指定した単位（日数など）で求める。
• dateadd ── 日付・時刻に一定期間を加算（または減算）する。
• round ── 数値を指定した桁数で四捨五入する。
• regexp_replace ── 正規表現にマッチした部分を別の文字列に置き換える。
• split ── 文字列を区切り文字で分割し、配列（リスト）にする。
• md5 / sha2 ── 文字列からハッシュ値を計算する（重複検知・疑似的な主キー生成などに使う）。
• length ── 文字列の長さ（文字数）を求める。
• contains ── 文字列に指定した部分文字列が含まれているかを判定する。
• startswith / endswith ── 文字列が指定した文字列で始まる／終わるかを判定する。
• replace（文字列の置き換え） ── 文字列中の一致した部分を、別の文字列に置き換える（正規表現ではない単純一致）。
• abs / ceil / floor ── 絶対値、切り上げ、切り下げを求める基本的な数値関数。
• greatest / least ── 複数の列を横に比較し、行ごとの最大値・最小値を求める。
• year / month / dayofmonth ── 日付・時刻から年・月・日の値だけを取り出す。
• lpad / rpad ── 文字列の左側・右側を指定した文字で埋め、一定の長さに揃える。
• initcap ── 各単語の先頭だけを大文字にし、残りを小文字にする（タイトルケース化）。
• current_date / current_timestamp ── 現在の日付・日時を取得する。
• array_contains ── 配列の中に指定した値が含まれているかを判定する。
• parse_json / object_construct ── 文字列をJSON（半構造化データ）として解釈する／複数の値からJSONオブジェクトを組み立てる。
• sqrt / exp / ln ── 平方根、指数関数（eのべき乗）、自然対数を求める。
• reverse ── 文字列の文字の並び順を反転させる。
• charindex ── 文字列の中で、指定した部分文字列が最初に現れる位置を求める。
• to_decimal / to_varchar ── 文字列を指定した精度の数値に変換する／数値を文字列に変換する（書式指定つき）。

出典・検証情報

• Snowpark 公式リファレンス（left / right）
• Polars 公式リファレンス（left / right）

Polars 1.36.1 で実行確認 / Snowpark Python SDK 1.51.1 で静的検証（2026-08-30）