Python pandas.to_timedelta用法及代碼示例

用法: pandas.to_timedelta(arg, unit=None, errors='raise')

將參數轉換為 timedelta。

時間增量是時間的絕對差異，以差異單位表示(例如，天、小時、分鍾、秒)。此方法將參數從可識別的 timedelta 格式/值轉換為 Timedelta 類型。

參數：

arg：str、timedelta、list-like 或係列

要轉換為 timedelta 的數據。

unit：str，可選

表示數字 arg 的 arg 單位。默認為 "ns" 。

可能的值：

‘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’

errors：{‘ignore’, ‘raise’, ‘coerce’}，默認 ‘raise’

如果‘raise’，則無效解析將引發異常。
如果‘coerce’，則無效解析將被設置為NaT。
如果‘ignore’，則無效解析將返回輸入。

時間增量

如果解析成功。返回類型取決於輸入：

list-like:timedelta64 dtype 的TimedeltaIndex
係列：timedelta64 dtype 係列
標量：時間增量

注意：

如果精度高於納秒，則對於字符串輸入，持續時間的精度將被截斷為納秒。

例子：

將單個字符串解析為 Timedelta：

>>> pd.to_timedelta('1 days 06:05:01.00003')
Timedelta('1 days 06:05:01.000030')
>>> pd.to_timedelta('15.5us')
Timedelta('0 days 00:00:00.000015500')

解析字符串列表或數組：

>>> pd.to_timedelta(['1 days 06:05:01.00003', '15.5us', 'nan'])
TimedeltaIndex(['1 days 06:05:01.000030', '0 days 00:00:00.000015500', NaT],
               dtype='timedelta64[ns]', freq=None)

通過指定 unit 關鍵字參數來轉換數字：

>>> pd.to_timedelta(np.arange(5), unit='s')
TimedeltaIndex(['0 days 00:00:00', '0 days 00:00:01', '0 days 00:00:02',
                '0 days 00:00:03', '0 days 00:00:04'],
               dtype='timedelta64[ns]', freq=None)
>>> pd.to_timedelta(np.arange(5), unit='d')
TimedeltaIndex(['0 days', '1 days', '2 days', '3 days', '4 days'],
               dtype='timedelta64[ns]', freq=None)

相關用法

注：本文由純淨天空篩選整理自pandas.pydata.org大神的英文原創作品 pandas.to_timedelta。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。

用法:

參數：

返回：

注意：

例子：