Function _cast_timestamp_to_coarsest_resolution

xarray/coding/times.py:298–310

(timestamp: pd.Timestamp)

def _cast_timestamp_to_coarsest_resolution(timestamp: pd.Timestamp) -> pd.Timestamp:
    # Cast timestamp to the coarsest resolution that can be used without
    # changing its value. If provided a string, the pandas.Timestamp
    # constructor used to automatically infer this from the resolution of the
    # string, but this behavior was changed in pandas-dev/pandas#62801. This
    # function allows us to approximately restore the old behavior in a way
    # that is perhaps more consistent with how we infer the resolution of the
    # data values themselves.
    for unit in _ORDERED_PANDAS_TIME_RESOLUTIONS:
        coarsest_timestamp = timestamp.as_unit(unit)
        if coarsest_timestamp == timestamp:
            return coarsest_timestamp
    return timestamp


def _unpack_time_unit_and_ref_date(