Skip to main content
`Ctrl`+`K`

# pandas.Series.str.zfill

Series.str.zfill(width)

  Pad strings in the Series/Index by prepending ‘0’ characters.

  Strings in the Series/Index are padded with ‘0’ characters on the left of the string to reach a total string length width. Strings in the Series/Index with length greater or equal to width are unchanged.

  Parameters:
    width int

      Minimum length of resulting string; strings with length less than width be prepended with ‘0’ characters.

  Returns:
    Series/Index of objects.

      A Series or Index where the strings are prepended with ‘0’ characters.

  See also

  `Series.str.rjust`

    Fills the left side of strings with an arbitrary character.

  `Series.str.ljust`

    Fills the right side of strings with an arbitrary character.

  `Series.str.pad`

    Fills the specified sides of strings with an arbitrary character.

  `Series.str.center`

    Fills both sides of strings with an arbitrary character.

  Notes

  Follows the same rules as `str.zfill()`: a leading sign character (‘+’/’-’) is kept at the front of the string and the ‘0’ padding is inserted after it.

  Examples

      >>> s = pd.Series(["-1", "1", "1000", 10, np.nan])
      >>> s
      0      -1
      1       1
      2    1000
      3      10
      4     NaN
      dtype: object

  Note that `10` and `NaN` are not strings, therefore they are converted to `NaN`. The minus sign in `'-1'` is kept at the front of the string and the ‘0’ padding is inserted after it, the same as `str.zfill()`. `1000` remains unchanged as it is longer than width.

      >>> s.str.zfill(3)
      0     -01
      1     001
      2    1000
      3     NaN
      4     NaN
      dtype: object