xlsx-jp

name	xlsx-jp
description	Generate Japanese Excel files (.xlsx) using openpyxl with Japanese fonts, currency formatting (¥), Japanese era calendar (和暦), tax calculation, and business templates. Triggers on requests to create Excel帳票, 見積書Excel, 請求書xlsx, 勤怠管理表, 日本語スプレッドシート.

日本語 Excel ファイル生成スキル

概要

openpyxl を使用して、日本語のビジネス帳票を正しいフォーマットで .xlsx ファイルとして生成するスキルです。通貨表示（¥）、和暦、消費税計算、印鑑欄など、日本のビジネス帳票に必要な要素をカバーします。

前提条件

pip install openpyxl

基本設定

ワークブック作成と日本語フォント

from openpyxl import Workbook
from openpyxl.styles import Font, Alignment, Border, Side, PatternFill, numbers
from openpyxl.utils import get_column_letter

wb = Workbook()
ws = wb.active

# デフォルトフォント設定
default_font = Font(name='游ゴシック', size=10)
ws.sheet_properties.defaultRowHeight = 18

推奨フォント一覧

用途	フォント名	特徴
帳票全般	游ゴシック（Yu Gothic）	視認性が高く帳票向き
フォーマルな文書	游明朝（Yu Mincho）	正式な印象
互換性重視	MS ゴシック（MS Gothic）	等幅、古い環境でも表示可
互換性重視	MS 明朝（MS Mincho）	等幅明朝体

フォントサイズの基準

要素	サイズ
帳票タイトル	18pt〜24pt
セクション見出し	12pt〜14pt
データセル	10pt〜11pt
注釈・備考	9pt

通貨フォーマット（¥）

日本円の表示形式を設定します：

from openpyxl.styles.numbers import FORMAT_NUMBER_COMMA_SEPARATED1

# 方法1: ¥記号付き桁区切り
yen_format = '¥#,##0'

# 方法2: マイナス値の表示（赤字）
yen_format_with_negative = '¥#,##0;[Red]-¥#,##0'

# 方法3: 税込・税抜表示用
yen_format_tax_included = '¥#,##0"(税込)"'

# 適用例
cell = ws['E5']
cell.value = 1500000
cell.number_format = yen_format

数値フォーマット一覧

フォーマット	表示例	用途
¥#,##0	¥1,500,000	基本的な金額表示
¥#,##0;[Red]-¥#,##0	-¥500 （赤字）	赤字表示付き
#,##0	1,500,000	金額（¥なし）
0.0%	10.0%	税率表示
#,##0.0"時間"	160.0時間	労働時間

和暦（日本の年号）対応

from datetime import date

def to_wareki(d):
    """西暦から和暦に変換する"""
    wareki_eras = [
        (date(2019, 5, 1), '令和'),
        (date(1989, 1, 8), '平成'),
        (date(1926, 12, 25), '昭和'),
        (date(1912, 7, 30), '大正'),
    ]
    for start_date, era_name in wareki_eras:
        if d >= start_date:
            year = d.year - start_date.year + 1
            year_str = '元' if year == 1 else str(year)
            return f'{era_name}{year_str}年{d.month}月{d.day}日'
    return f'{d.year}年{d.month}月{d.day}日'

# 使用例
today = date.today()
ws['B3'] = to_wareki(today)  # 例: 令和8年3月4日

Excel セルでの和暦表示

from openpyxl.styles import numbers

cell = ws['B3']
cell.value = date(2026, 3, 4)
cell.number_format = '[$-ja-JP-x-gannen]ggge"年"m"月"d"日"'
# 表示: 令和8年3月4日

消費税計算

標準税率（10%）と軽減税率（8%）

TAX_RATE_STANDARD = 0.10   # 標準税率 10%
TAX_RATE_REDUCED = 0.08    # 軽減税率 8%（食品・新聞等）

def calculate_tax(amount, rate=TAX_RATE_STANDARD):
    """消費税を計算する（端数切り捨て）"""
    import math
    return math.floor(amount * rate)

# Excel数式での計算
ws['F10'] = '=FLOOR(F9*0.1, 1)'   # 標準税率（10%）
ws['F11'] = '=FLOOR(F9*0.08, 1)'  # 軽減税率（8%）
ws['F12'] = '=F9+F10'              # 合計（10%対象）

インボイス制度対応

適格請求書（インボイス）に必要な項目：

項目	内容
登録番号	T + 13桁の数字（例: T1234567890123）
税率ごとの区分	10%対象 / 8%対象（軽減税率）を分けて記載
税率ごとの消費税額	それぞれの税率に対する消費税額を明記

印鑑欄の作成

def add_inkan_area(ws, start_row, start_col, labels=None):
    """印鑑欄を作成する"""
    if labels is None:
        labels = ['承認', '確認', '担当']

    thin_border = Border(
        left=Side(style='thin'),
        right=Side(style='thin'),
        top=Side(style='thin'),
        bottom=Side(style='thin'),
    )
    center_align = Alignment(horizontal='center', vertical='center')

    for i, label in enumerate(labels):
        col = start_col + i
        # ラベルセル
        cell = ws.cell(row=start_row, column=col, value=label)
        cell.font = Font(name='游ゴシック', size=8)
        cell.alignment = center_align
        cell.border = thin_border

        # 印鑑スペース（下の行を結合して高さを確保）
        stamp_cell = ws.cell(row=start_row + 1, column=col)
        stamp_cell.border = thin_border
        stamp_cell.alignment = center_align

    # 印鑑スペースの行の高さを設定
    ws.row_dimensions[start_row + 1].height = 60

セルスタイルのユーティリティ

ヘッダー行のスタイル

header_font = Font(name='游ゴシック', size=10, bold=True, color='FFFFFF')
header_fill = PatternFill(start_color='4472C4', end_color='4472C4', fill_type='solid')
header_align = Alignment(horizontal='center', vertical='center', wrap_text=True)
header_border = Border(
    left=Side(style='thin'),
    right=Side(style='thin'),
    top=Side(style='thin'),
    bottom=Side(style='thin'),
)

def apply_header_style(ws, row, start_col, end_col):
    """ヘッダー行にスタイルを適用する"""
    for col in range(start_col, end_col + 1):
        cell = ws.cell(row=row, column=col)
        cell.font = header_font
        cell.fill = header_fill
        cell.alignment = header_align
        cell.border = header_border

罫線パターン

# 細い実線（帳票データ行）
thin_border = Border(
    left=Side(style='thin'),
    right=Side(style='thin'),
    top=Side(style='thin'),
    bottom=Side(style='thin'),
)

# 太い外枠線（合計行など）
thick_bottom = Border(
    left=Side(style='thin'),
    right=Side(style='thin'),
    top=Side(style='thin'),
    bottom=Side(style='thick'),
)

# 二重線（最終合計行の下）
double_bottom = Border(
    bottom=Side(style='double'),
)

ビジネステンプレート

見積書

日本のビジネスで使用する標準的な見積書を Excel で作成します。

• 参照: templates/mitsumori.md

勤怠管理表

月次の勤怠管理表（出退勤、休憩、残業時間を管理）を作成します。

• 参照: templates/kintai.md

印刷設定

from openpyxl.worksheet.page import PageMargins

# 用紙サイズ（A4）
ws.page_setup.paperSize = ws.PAPERSIZE_A4

# 印刷方向（縦）
ws.page_setup.orientation = 'portrait'

# 余白設定（インチ単位）
ws.page_margins = PageMargins(
    left=0.75, right=0.75,
    top=1.0, bottom=1.0,
    header=0.5, footer=0.5,
)

# 1ページに収める
ws.page_setup.fitToWidth = 1
ws.page_setup.fitToHeight = 1
ws.sheet_properties.pageSetUpPr.fitToPage = True

# ヘッダー・フッター
ws.oddHeader.center.text = '【会社名】'
ws.oddFooter.center.text = 'Page &P of &N'

生成時の確認事項

帳票を生成する前に、以下をユーザーに確認してください：

1. 帳票の種類: 見積書 / 請求書 / 勤怠管理表 / その他
2. フォント: 游ゴシック（デフォルト）/ 游明朝 / MS ゴシック
3. 日付形式: 和暦（デフォルト）/ 西暦
4. 消費税率: 10%（デフォルト）/ 8%（軽減税率）/ 混合
5. 印鑑欄: 必要（承認・確認・担当）/ 不要 / カスタム
6. 印刷設定: A4 縦（デフォルト）/ A4 横 / B4 / A3
7. シート名: 日本語で指定（例: 「見積書」「勤怠管理」）

不明な項目はデフォルト値を使用し、プレースホルダーには 【〇〇】 を使用してください。

出力時の注意事項

• ファイル名は英数字を推奨: mitsumori_20260304.xlsx
• シート名は日本語可: ws.title = '見積書'
• 列幅は内容に応じて適切に調整する
• 数式を使用する場合、保存後に Excel で再計算が必要な場合がある
• wb.save('filename.xlsx') で保存する