Pythonゼロ埋め（ゼロパディング）完全ガイド – 文字列・数値の桁揃え方法を徹底解説
Pythonでプログラミングをしていると、数値や文字列を一定の桁数に揃えるためにゼロ埋め（ゼロパディング）を行う場面は非常に多くあります。ファイル名の連番、データベースのID、時刻表示、CSV出力など、様々なシーンで活用される重要な技術です。この記事では、Pythonでゼロ埋めを行う様々な方法を実例とともに詳しく解説します。
1. 基本的なゼロ埋め方法
zfill()メソッドによるゼロ埋め
# 文字列のゼロ埋め
number = "123"
padded = number.zfill(5)
print(padded) # "00123"
# 数値を文字列に変換してゼロ埋め
num = 42
padded_num = str(num).zfill(4)
print(padded_num) # "0042"
format()メソッドによるゼロ埋め
# format()を使ったゼロ埋め
number = 123
padded = "{:05d}".format(number)
print(padded) # "00123"
# 文字列での使用
text = "abc"
padded_text = "{:>07}".format(text)
print(padded_text) # "0000abc"
f文字列（f-string）によるゼロ埋め
# f文字列を使ったゼロ埋め（Python 3.6以降）
number = 123
padded = f"{number:05d}"
print(padded) # "00123"
width = 6
value = 42
padded_dynamic = f"{value:0{width}d}"
print(padded_dynamic) # "000042"
2. 数値のゼロ埋め
整数のゼロ埋め
# 基本的な整数のゼロ埋め
numbers = [1, 23, 456, 7890]
for num in numbers:
print(f"{num:06d}")
# 000001
# 000023
# 000456
# 007890
浮動小数点数のゼロ埋め
# 浮動小数点数のゼロ埋め
value = 3.14
padded = f"{value:08.2f}"
print(padded) # "00003.14"
# 小数点以下の桁数も指定
price = 1234.5
formatted = f"{price:010.2f}"
print(formatted) # "0001234.50"
負の数値でのゼロ埋め
# 負の数値のゼロ埋め
negative = -123
padded_negative = f"{negative:06d}"
print(padded_negative) # "-00123"
# 符号を考慮した幅指定
print(f"{-45:+07d}") # "-000045"
print(f"{45:+07d}") # "+000045"
3. 文字列のゼロ埋め
右寄せでのゼロ埋め
# 文字列を右寄せでゼロ埋め
text = "hello"
padded = text.zfill(10)
print(padded) # "00000hello"
# format()でも同様
padded_fmt = f"{text:0>10}"
print(padded_fmt) # "00000hello"
左寄せでのゼロ埋め
# 左寄せでゼロ埋め
text = "world"
padded_left = f"{text:0<10}"
print(padded_left) # "world00000"
中央寄せでのゼロ埋め
# 中央寄せでゼロ埋め
text = "center"
padded_center = f"{text:0^12}"
print(padded_center) # "000center000"
4. 実用的な応用例
ファイル名の連番生成
# ファイル名の連番にゼロ埋めを適用
def generate_filenames(count, prefix="file", extension=".txt", digits=3):
filenames = []
for i in range(1, count + 1):
filename = f"{prefix}{i:0{digits}d}{extension}"
filenames.append(filename)
return filenames
files = generate_filenames(15, "image", ".jpg", 4)
print(files[:5]) # ['image0001.jpg', 'image0002.jpg', ...]
時刻表示でのゼロ埋め
from datetime import datetime
# 時刻表示でのゼロ埋め
now = datetime.now()
formatted_time = f"{now.hour:02d}:{now.minute:02d}:{now.second:02d}"
print(formatted_time) # "09:05:03"
# カスタム日付フォーマット
date_str = f"{now.year:04d}-{now.month:02d}-{now.day:02d}"
print(date_str) # "2024-01-15"
IDやコードの生成
# ユーザーIDの生成
def generate_user_id(user_number):
return f"USER{user_number:06d}"
# 商品コードの生成
def generate_product_code(category_id, product_id):
return f"P{category_id:03d}-{product_id:05d}"
print(generate_user_id(123)) # "USER000123"
print(generate_product_code(5, 42)) # "P005-00042"
5. リストや配列でのゼロ埋め
リスト内の数値を一括ゼロ埋め
# リスト内の数値を一括でゼロ埋め
numbers = [1, 23, 456, 7, 89]
padded_numbers = [f"{num:05d}" for num in numbers]
print(padded_numbers) # ['00001', '00023', '00456', '00007', '00089']
辞書のキーや値をゼロ埋め
# 辞書のキーをゼロ埋めで変換
data = {1: "apple", 23: "banana", 456: "cherry"}
padded_keys = {f"{k:04d}": v for k, v in data.items()}
print(padded_keys) # {'0001': 'apple', '0023': 'banana', '0456': 'cherry'}
6. データ処理でのゼロ埋め
CSVデータの整形
import pandas as pd
# CSVデータでのゼロ埋め処理
data = {
'id': [1, 23, 456, 7],
'name': ['Alice', 'Bob', 'Charlie', 'David']
}
df = pd.DataFrame(data)
df['id_padded'] = df['id'].apply(lambda x: f"{x:05d}")
print(df)
# id name id_padded
# 0 1 Alice 00001
# 1 23 Bob 00023
# 2 456 Charlie 00456
# 3 7 David 00007
JSONデータの処理
import json
# JSONデータでのゼロ埋め処理
def pad_json_ids(data, id_field='id', width=6):
"""JSONデータのIDフィールドをゼロ埋めする"""
if isinstance(data, list):
for item in data:
if id_field in item:
item[f"{id_field}_padded"] = f"{item[id_field]:0{width}d}"
return data
json_data = [
{"id": 1, "name": "Product A"},
{"id": 23, "name": "Product B"},
{"id": 456, "name": "Product C"}
]
padded_data = pad_json_ids(json_data)
print(json.dumps(padded_data, indent=2))
7. 特殊なゼロ埋めパターン
16進数のゼロ埋め
# 16進数でのゼロ埋め
number = 255
hex_padded = f"{number:08x}" # 小文字
print(hex_padded) # "000000ff"
hex_upper = f"{number:08X}" # 大文字
print(hex_upper) # "000000FF"
# プレフィックス付き
hex_with_prefix = f"0x{number:06x}"
print(hex_with_prefix) # "0x0000ff"
8進数・2進数のゼロ埋め
# 8進数のゼロ埋め
number = 64
oct_padded = f"{number:06o}"
print(oct_padded) # "000100"
# 2進数のゼロ埋め
bin_padded = f"{number:08b}"
print(bin_padded) # "01000000"
8. バリデーションとエラーハンドリング
安全なゼロ埋め関数
def safe_zero_pad(value, width, fill_char='0'):
"""安全なゼロ埋め関数"""
try:
# 数値の場合
if isinstance(value, (int, float)):
if isinstance(value, float):
return f"{value:0{width}.2f}"
else:
return f"{value:0{width}d}"
# 文字列の場合
elif isinstance(value, str):
if value.isdigit():
return value.zfill(width)
else:
return f"{value:{fill_char}>{width}}"
else:
# その他の型は文字列に変換
return f"{str(value):{fill_char}>{width}}"
except (ValueError, TypeError):
return str(value)
# テスト
test_values = [42, 3.14, "123", "abc", None, [1, 2, 3]]
for val in test_values:
result = safe_zero_pad(val, 8)
print(f"{val} -> {result}")
9. パフォーマンスの比較
各手法の実行速度比較
import time
def benchmark_padding_methods(value, width, iterations=100000):
"""ゼロ埋め手法のパフォーマンス比較"""
# zfill()メソッド
start = time.time()
for _ in range(iterations):
str(value).zfill(width)
zfill_time = time.time() - start
# format()メソッド
start = time.time()
for _ in range(iterations):
f"{value:0{width}d}"
format_time = time.time() - start
# f文字列
start = time.time()
for _ in range(iterations):
f"{value:05d}" # 固定幅での比較
fstring_time = time.time() - start
print(f"zfill(): {zfill_time:.4f}秒")
print(f"format(): {format_time:.4f}秒")
print(f"f-string: {fstring_time:.4f}秒")
benchmark_padding_methods(123, 5)
10. 大量データでの効率的な処理
バッチ処理でのゼロ埋め
def batch_zero_pad(numbers, width=5):
"""大量データの効率的なゼロ埋め処理"""
# リスト内包表記を使用（高速）
return [f"{num:0{width}d}" for num in numbers]
def batch_zero_pad_generator(numbers, width=5):
"""メモリ効率的なジェネレータ版"""
for num in numbers:
yield f"{num:0{width}d}"
# 大量データのテスト
large_data = range(1000000)
start = time.time()
# ジェネレータを使用してメモリ効率化
padded_gen = batch_zero_pad_generator(large_data, 7)
sample = [next(padded_gen) for _ in range(5)]
print(f"サンプル: {sample}")
print(f"処理時間: {time.time() - start:.4f}秒")
11. 文字エンコーディングでの注意点
全角・半角文字でのゼロ埋め
# 全角文字を含む場合の注意点
def smart_pad(text, width, pad_char='0'):
"""全角文字を考慮したパディング"""
# 文字列の表示幅を計算（全角文字は2として計算）
display_width = sum(2 if ord(c) > 127 else 1 for c in text)
pad_length = max(0, width - display_width)
return pad_char * pad_length + text
japanese_text = "こんにちは"
padded_jp = smart_pad(japanese_text, 15, '0')
print(f"'{padded_jp}'") # 全角文字の幅を考慮
12. 実際のプロジェクトでの活用例
ログファイル名の生成
from datetime import datetime
import os
class LogManager:
def __init__(self, base_dir="logs"):
self.base_dir = base_dir
self.sequence = 1
def generate_log_filename(self):
"""ログファイル名を生成"""
now = datetime.now()
date_str = f"{now.year:04d}{now.month:02d}{now.day:02d}"
time_str = f"{now.hour:02d}{now.minute:02d}{now.second:02d}"
seq_str = f"{self.sequence:04d}"
filename = f"app_{date_str}_{time_str}_{seq_str}.log"
self.sequence += 1
return os.path.join(self.base_dir, filename)
# 使用例
log_mgr = LogManager()
for _ in range(3):
filename = log_mgr.generate_log_filename()
print(filename)
# logs/app_20240115_143025_0001.log
# logs/app_20240115_143025_0002.log
# logs/app_20240115_143025_0003.log
バーコード・QRコード生成
def generate_barcode_data(product_id, batch_id, item_number):
"""バーコード用のデータ文字列を生成"""
# 各要素をゼロ埋めして結合
product_padded = f"{product_id:06d}" # 商品ID: 6桁
batch_padded = f"{batch_id:04d}" # バッチID: 4桁
item_padded = f"{item_number:08d}" # アイテム番号: 8桁
barcode = f"{product_padded}{batch_padded}{item_padded}"
return barcode
# チェックディジットの計算も含める
def calculate_check_digit(barcode):
"""バーコードのチェックディジット計算"""
total = sum(int(digit) * (3 if i % 2 else 1)
for i, digit in enumerate(barcode))
return (10 - (total % 10)) % 10
product_barcode = generate_barcode_data(123, 45, 6789)
check_digit = calculate_check_digit(product_barcode)
final_barcode = f"{product_barcode}{check_digit}"
print(f"バーコード: {final_barcode}") # 000123004500006789X
13. トラブルシューティング
よくある問題と解決策
# 問題1: 負の数値での予期しない結果
def fix_negative_padding():
negative = -123
# 問題のあるパディング
wrong = f"{negative:06d}"
print(f"間違い: '{wrong}'") # "-00123" (6桁になっていない)
# 正しいパディング
correct = f"{negative:+07d}" # 符号込みで7桁
print(f"正しい: '{correct}'") # "-000123"
# 問題2: 文字列と数値の混在
def handle_mixed_types(values):
"""混在する型を安全に処理"""
results = []
for val in values:
try:
# 数値として解釈可能かチェック
if isinstance(val, str) and val.isdigit():
results.append(f"{int(val):05d}")
elif isinstance(val, (int, float)):
results.append(f"{int(val):05d}")
else:
# 数値でない場合は文字列として処理
results.append(f"{str(val):0>5}")
except (ValueError, TypeError):
results.append(str(val))
return results
mixed_data = [123, "456", "abc", 7.89, None]
processed = handle_mixed_types(mixed_data)
print(processed) # ['00123', '00456', '00abc', '00007', 'None']
fix_negative_padding()
14. 最適化のベストプラクティス
効率的なゼロ埋めパターン
# 推奨パターン
class PaddingHelper:
@staticmethod
def format_id(value, width=6):
"""ID用の標準ゼロ埋め"""
return f"{value:0{width}d}"
@staticmethod
def format_filename_number(value, width=4):
"""ファイル名用の連番ゼロ埋め"""
return f"{value:0{width}d}"
@staticmethod
def format_time_component(value):
"""時刻コンポーネント用（固定2桁）"""
return f"{value:02d}"
@classmethod
def batch_format(cls, values, formatter_name, *args):
"""バッチ処理用"""
formatter = getattr(cls, formatter_name)
return [formatter(val, *args) for val in values]
# 使用例
helper = PaddingHelper()
ids = [1, 23, 456]
formatted_ids = helper.batch_format(ids, 'format_id', 8)
print(formatted_ids) # ['00000001', '00000023', '00000456']
まとめ
Pythonでのゼロ埋め（ゼロパディング）は、データの整形や表示において非常に重要な技術です。主な手法として以下があります：
- zfill()メソッド – 文字列に対するシンプルなゼロ埋め
- format()メソッド – 柔軟な書式指定が可能
- f文字列 – Python 3.6以降の推奨方法、可読性が高い
- カスタム関数 – 複雑な要件に対応する独自実装
用途に応じて適切な手法を選択し、エラーハンドリングやパフォーマンスも考慮することで、堅牢で効率的なコードを書くことができます。特にファイル管理、データベース操作、ログ管理などにおいて、ゼロ埋めは欠かせない技術となります。
■プロンプトだけでオリジナルアプリを開発・公開してみた！！
■AI時代の第一歩！「AI駆動開発コース」はじめました！
テックジム東京本校で先行開始。
■テックジム東京本校
「武田塾」のプログラミング版といえば「テックジム」。
講義動画なし、教科書なし。「進捗管理とコーチング」で効率学習。
より早く、より安く、しかも対面型のプログラミングスクールです。
＜短期講習＞5日で5万円の「Pythonミニキャンプ」開催中。
＜月1開催＞放送作家による映像ディレクター養成講座
＜オンライン無料＞ゼロから始めるPython爆速講座
