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

datediff

2つの日付・時刻の差を、指定した単位（日数など）で求める。

datediff("day", col("start_date"), col("end_date"))

(pl.col("end_date") - pl.col("start_date")).dt.total_days()

挙動・設計の違い

Snowparkはdatediff(単位, 開始, 終了)という専用の関数を1回呼ぶだけで済む。Polarsには同名の専用関数が無く、日付列同士を引き算してDuration型にしてから、.dt.total_days()のようなメソッドで単位を取り出す2段階の書き方になる。14日差のデータで実行して確認したところ、どちらも14になる。

移行時の落とし穴

Polars側は「引き算してから単位を取り出す」という考え方の違いを理解していないと、datediffに相当する関数を探して見つからずに詰まる。日数以外の単位（時間・分）が欲しいときは.dt.total_days()の部分を.dt.total_hours()・.dt.total_minutes()に差し替える。

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

• 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 ── 日付・時刻を指定した単位（月・年など）で切り捨てる。
• dateadd ── 日付・時刻に一定期間を加算（または減算）する。
• round ── 数値を指定した桁数で四捨五入する。
• regexp_replace ── 正規表現にマッチした部分を別の文字列に置き換える。
• split ── 文字列を区切り文字で分割し、配列（リスト）にする。
• md5 / sha2 ── 文字列からハッシュ値を計算する（重複検知・疑似的な主キー生成などに使う）。

出典・検証情報

• Snowpark 公式リファレンス（datediff）
• Polars 公式リファレンス（datediff）

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