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 內部序列值
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)
dt = xlrd.xldate.xldate_as_datetime(table.cell(2, 2).value, 1)
# datetime.datetime(2018, 7, 9, 0, 0) # 直接得到 datetime 物件
| datemode | 基準日期 | 適用環境 | 備註 |
|---|---|---|---|
| 0 | 1900-01-01 | Windows Excel、大多數情況 | 包含 1900 年閏年 Bug 相容 |
| 1 | 1904-01-01 | Mac 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))
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 |
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 物件,無需轉換