Skip to main content
`Ctrl`+`K`

# pandas.Series.str.slice

Series.str.slice(start=None, stop=None, step=None)

  Slice substrings from each element in the Series or Index.

  Parameters:
    startint, optional

      Start position for slice operation.

    stopint, optional

      Stop position for slice operation.

    stepint, optional

      Step size for slice operation.

  Returns:
    Series or Index of object

      Series or Index from sliced substring from original string object.

  See also

  `Series.str.slice_replace`

    Replace a slice with a string.

  `Series.str.get`

    Return element at position. Equivalent to Series.str.slice(start=i, stop=i+1) with i being the position.

  Examples

      >>> s = pd.Series(["koala", "dog", "chameleon"])
      >>> s
      0        koala
      1          dog
      2    chameleon
      dtype: object

      >>> s.str.slice(start=1)
      0        oala
      1          og
      2    hameleon
      dtype: object

      >>> s.str.slice(start=-1)
      0           a
      1           g
      2           n
      dtype: object

      >>> s.str.slice(stop=2)
      0    ko
      1    do
      2    ch
      dtype: object

      >>> s.str.slice(step=2)
      0      kaa
      1       dg
      2    caeen
      dtype: object

      >>> s.str.slice(start=0, stop=5, step=3)
      0    kl
      1     d
      2    cm
      dtype: object

  Equivalent behaviour to:

      >>> s.str[0:5:3]
      0    kl
      1     d
      2    cm
      dtype: object