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:

widthint

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