萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python xlrd 讀取 Excel 日期類型完整指南:兩種轉換方法與單元格存取技巧

xlrd 讀取 Excel 日期儲存為浮點數(Excel 日期序列值)。本文詳細解析兩種轉換為 Python datetime 的方法、datemode 參數意義、單元格存取語法,並提供原始碼層級解析。

基礎結構與單元格存取

import xlrd

data = xlrd.open_workbook(EXCEL_PATH)
table = data.sheet_by_index(0)  # 或 sheet_by_name('Sheet1')
rows = table.nrows
cols = table.ncols

# 單元格存取:行、列從 0 開始
value = table.cell(rowx, colx).value
# 或
value = table.cell_value(rowx, colx)
# 或
value = table.row(rowx)[colx].value

日期類型識別

>>> table.cell_type(2, 2)
3  # xlrd.XL_CELL_DATE = 3

>&>> table.cell(2, 2).value
41828.0  # Excel 內部序列值

方法一:xldate_as_tuple → 元組 → datetime

import xlrd
from datetime import datetime

# 參數:excel日期值, datemode
# datemode: 0=1900基準(Windows預設), 1=1904基準(Mac舊版)
date_tuple = xlrd.xldate_as_tuple(table.cell(2, 2).value, 0)
# (2014, 7, 8, 0, 0, 0)

dt = datetime(*date_tuple)
# datetime.datetime(2014, 7, 8, 0, 0)

方法二:xldate_as_datetime 直接轉 datetime(推薦)

dt = xlrd.xldate.xldate_as_datetime(table.cell(2, 2).value, 1)
# datetime.datetime(2018, 7, 9, 0, 0)  # 直接得到 datetime 物件

datemode 參數深度解析

datemode基準日期適用環境備註
01900-01-01Windows Excel、大多數情況包含 1900 年閏年 Bug 相容
11904-01-01Mac Excel 2004 之前無 1900 閏年 Bug

來源:book.datemode 屬性自動從檔案讀取,建議直接使用:

dt = xlrd.xldate_as_datetime(cell.value, book.datemode)

原始碼層級簽名

# xlrd/xldate.py
def xldate_as_tuple(xldate, datemode):
    """Convert Excel date number to tuple (year, month, day, hour, minute, second)"""
    ...

def xldate_as_datetime(xldate, datemode):
    """Convert Excel date number to datetime.datetime object"""
    return datetime.datetime(*xldate_as_tuple(xldate, datemode))

反向轉換:Python datetime → Excel 數值

from xlrd import xldate
from datetime import datetime

excel_value = xldate.xldate_from_datetime_tuple((2024, 1, 15, 10, 30, 0), 0)
# 45308.4375

常見坑點與避坑指南

問題原因解決
日期偏移 1 天datemode 錯誤或 1900 閏年 Bug使用 book.datemode、驗證已知日期
時間為 00:00:00儲存格式僅含日期正常,Excel 日期預設午夜
讀出亂碼/錯誤數值儲存格非日期型別(文字/常數)先檢查 cell_type == 3
xlrd 2.0+ 不支援 .xlsx僅支援 .xls改用 openpyxl 處理 .xlsx

現代替代方案:openpyxl

from openpyxl import load_workbook
from datetime import datetime

wb = load_workbook('data.xlsx')
ws = wb.active
cell = ws['B3']
if isinstance(cell.value, datetime):
    print(cell.value)  # 直接是 datetime 物件,無需轉換
copyright © 萬盛學電腦網 all rights reserved