pandas.Series.astype

Series.astype(dtype, copy=True, errors='raise', **kwargs) [source]

Преобразование объекта pandas к указанному типу dtype.

Параметры:

dtype : тип данных или словарь имени столбца -> тип данных Используйте numpy.dtype или Python-тип для преобразования всего объекта pandas к одному типу. В качестве альтернативы, используйте {col: dtype, …}, где col — метка столбца, а dtype — numpy.dtype или Python-тип для преобразования одного или нескольких столбцов DataFrame к столбцеспецифическим типам. copy : bool, по умолчанию True. Возвращает копию, когда copy=True (будьте очень осторожны при настройке copy=False, так как изменения значений могут затем распространяться на другие объекты pandas). errors : {‘raise’, ‘ignore’}, по умолчанию ‘raise’. Управление поднятием исключений при неверных данных для указанного типа. raise : разрешить поднятие исключений ignore : подавить исключения. При ошибке вернуть исходный объект Новая в версии 0.20.0. raise_on_error : поднимать исключение при некорректном вводе Устарело начиная с версии 0.20.0: Используйте errors вместо этого kwargs : keyword arguments to pass on to the constructor

Возвращает:

casted : type of caller

См. также

pandas.to_datetime

Преобразование аргумента в дату и время.

pandas.to_timedelta

Преобразование аргумента в интервал времени.

pandas.to_numeric

Преобразование аргумента в числовой тип.

numpy.ndarray.astype

Преобразование массива numpy к указанному типу.

Примеры

>>> ser = pd.Series([1, 2], dtype='int32')
>>> ser
0    1
1    2
dtype: int32
>>> ser.astype('int64')
0    1
1    2
dtype: int64

Преобразование в категориальный тип:

>>> ser.astype('category')
0    1
1    2
dtype: category
Categories (2, int64): [1, 2]

Преобразование в упорядоченный категориальный тип с пользовательским упорядочением:

>>> ser.astype('category', ordered=True, categories=[2, 1])
0    1
1    2
dtype: category
Categories (2, int64): [2 < 1]

Обратите внимание, что использование copy=False и изменение данных в новом объекте pandas может привести к распространению изменений:

>>> s1 = pd.Series([1,2])
>>> s2 = s1.astype('int64', copy=False)
>>> s2[0] = 10
>>> s1  # note that s1[0] has changed too
0    10
1     2
dtype: int64