pandas.to_timedelta — pandas 0.24.0rc1 documentation (original) (raw)

Parameters:

arg : str, timedelta, list-like or Series

The data to be converted to timedelta.

unit : str, default ‘ns’

Denotes the unit of the arg. Possible values: (‘Y’, ‘M’, ‘W’, ‘D’, ‘days’, ‘day’, ‘hours’, hour’, ‘hr’, ‘h’, ‘m’, ‘minute’, ‘min’, ‘minutes’, ‘T’, ‘S’, ‘seconds’, ‘sec’, ‘second’, ‘ms’, ‘milliseconds’, ‘millisecond’, ‘milli’, ‘millis’, ‘L’, ‘us’, ‘microseconds’, ‘microsecond’, ‘micro’, ‘micros’, ‘U’, ‘ns’, ‘nanoseconds’, ‘nano’, ‘nanos’, ‘nanosecond’, ‘N’).

box : bool, default True

• If True returns a Timedelta/TimedeltaIndex of the results.
• If False returns a numpy.timedelta64 or numpy.darray of values of dtype timedelta64[ns].

errors : {‘ignore’, ‘raise’, ‘coerce’}, default ‘raise’

• If ‘raise’, then invalid parsing will raise an exception.
• If ‘coerce’, then invalid parsing will be set as NaT.
• If ‘ignore’, then invalid parsing will return the input.