PNDSPY1111¶

Message Pandas < pandas.core.frame.DataFrame.tz_localize > has a partial mapping with a few scenarios not supported in Snowpark.

Category Warning

Applies to¶

This EWI applies to the following elements (same implementation):

pandas.core.frame.DataFrame.tz_localize
pandas.core.generic.NDFrame.tz_localize
pandas.core.series.Series.tz_localize

Description¶

This issue appears when the SMA detects the use of a pandas element that has a direct equivalent in Snowpark pandas, but some scenarios might behave differently than pandas.

Missing or Unsupported Parameters: axis, level, copy ambiguous, nonexistent

Reason: N if timezone format is not supported. Only timezones listed in pytz.all_timezones are supported. For example, UTC is supported but UTC+/-, such as UTC+09:00, is not supported.

Scenario¶

A method with a few scenarios that aren’t supported in Snowpark.

Input¶

The following example shows a method with a few unsupported scenarios in Snowpark.

import pandas as pd

df = pd.DataFrame({'A': [1, 2, 3], 'B': [4, 5, 6]})
result = df.tz_localize()

Copy

Output¶

The SMA adds the EWI PNDSPY1111 to the output code to let you know that this element has a few scenarios that aren’t supported in Snowpark.

import snowflake.snowpark.modin.pandas as pd

#EWI: PNDSPY1111 => pandas.core.frame.DataFrame.tz_localize has a partial mapping, with few scenarios not supported. Check Snowpark pandas documentation for more detail.
df = pd.DataFrame({'A': [1, 2, 3], 'B': [4, 5, 6]})
result = df.tz_localize()

Copy

Recommended fix¶

The following parameters are not supported in Snowpark pandas: axis, level, copy ambiguous, nonexistent.

Recommended approaches:

Avoid unsupported parameters: Modify your code to not use these parameters if they are not essential.

Use .to_pandas() for full compatibility: If you need these parameters, convert to native pandas first:

# Convert to native pandas when unsupported parameters are needed
native_df = df.to_pandas()
result = native_df.tz_localize(...)  # Use all parameters

Copy

Split the operation: Perform supported operations in Snowpark pandas, then use native pandas only for the unsupported functionality.

Timezone handling difference: N if timezone format is not supported. Only timezones listed in pytz.all_timezones are supported. For example, UTC is supported but UTC+/-, such as UTC+09:00, is not supported.

When working with timezones in Snowpark pandas:

Ensure your timezone strings are valid IANA timezone names (e.g., ‘UTC’, ‘America/New_York’)
Test timezone conversions with sample data before running on full dataset
Consider using .to_pandas() for complex timezone operations if results differ

Additional recommendations¶

Check the Snowpark pandas documentation to verify which scenarios aren’t supported for that specific element.