Title: python-docx Document Timezone Issue - Help Request · Issue #1542 · python-openxml/python-docx · GitHub
Open Graph Title: python-docx Document Timezone Issue - Help Request · Issue #1542 · python-openxml/python-docx
X Title: python-docx Document Timezone Issue - Help Request · Issue #1542 · python-openxml/python-docx
Description: Issue Description When using python-docx to generate Word documents and setting core_properties.created and core_properties.modified, the file timestamp shown in Windows Explorer is 8 hours ahead of the actual local time (Beijing Time, U...
Open Graph Description: Issue Description When using python-docx to generate Word documents and setting core_properties.created and core_properties.modified, the file timestamp shown in Windows Explorer is 8 hours ahead o...
X Description: Issue Description When using python-docx to generate Word documents and setting core_properties.created and core_properties.modified, the file timestamp shown in Windows Explorer is 8 hours ahead o...
Opengraph URL: https://github.com/python-openxml/python-docx/issues/1542
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"python-docx Document Timezone Issue - Help Request","articleBody":"## Issue Description\n\nWhen using `python-docx` to generate Word documents and setting `core_properties.created` and `core_properties.modified`, the file timestamp shown in Windows Explorer is 8 hours ahead of the actual local time (Beijing Time, UTC+8).\n\n## Environment Information\n\n- **Operating System**: Windows 10/11\n- **Python Version**: Python 3.11\n- **python-docx Version**: Latest\n- **Local Timezone**: Beijing Time (UTC+8)\n- **System Time**: 13:45 (correct)\n- **Word Document Displayed Time**: 21:45 (incorrect, 8 hours ahead)\n\n## Reproduction Code\n\n```python\nfrom docx import Document\nfrom datetime import datetime\n\ndoc = Document()\n\n# Set document metadata timestamps\ncore_props = doc.core_properties\ncore_props.created = datetime.now()\ncore_props.modified = datetime.now()\n\ndoc.save('test.docx')\n```\n\n## Problem Analysis\n\nAfter multiple tests, I found:\n\n1. `python-docx` treats the passed `datetime` object as **UTC time** by default when storing\n2. Windows system converts UTC time to local timezone (UTC+8) when displaying file properties\n3. Result: System time 13:00 → docx stores as UTC 13:00 → Windows displays as 21:00 (UTC+8 conversion)\n\n## Current Workaround\n\n```python\nfrom datetime import datetime, timedelta\n\n# Pass \"current time minus 8 hours\" so Windows adds back 8 hours when displaying\ncorrect_time = datetime.now() - timedelta(hours=8)\ndoc.core_properties.created = correct_time\ndoc.core_properties.modified = correct_time\n```\n\n## Questions\n\n1. Is this a design bug or expected behavior in `python-docx`?\n2. Is there a more elegant solution (without manually subtracting 8 hours)?\n3. Should I pass timezone-aware datetime objects? (Tested but didn't work)\n\n## Expectations\n\nHoping the official team can provide:\n- Clear documentation on time handling\n- Or direct support for local timezone time setting\n\n---\n\n**Dear community experts, is this a known issue? Are there any better solutions?**","author":{"url":"https://github.com/shengcruz","@type":"Person","name":"shengcruz"},"datePublished":"2026-02-18T06:00:22Z","url":"https://github.com/python-openxml/python-docx/issues/1542"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:e2dc782c-277a-bc43-2068-93d0a9fb5c3e |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 8EE8:34BBA0:1E6F86:29975D:6AFF6399 |
| html-safe-nonce | 11d7b37b080f882d25f529e5698b1d246e0dbb47ee5103bfa770feb62b07ec4f |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4RUU4OjM0QkJBMDoxRTZGODY6Mjk5NzVEOjZBRkY2Mzk5IiwidmlzaXRvcl9pZCI6Ijc1OTU1NzcxNzQzMTMxMDAxODUiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | ed1b049c81b044086f1221e774de89afeb689d4dd1a3d4c5f87728465821aca1 |
| hovercard-subject-tag | issue:3956124389 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python-openxml/python-docx/1542/issue_layout |
| twitter:image | https://opengraph.githubassets.com/6e4964d165aeccb2f907ae0135538242d58474dee15473dd1db16c285f16479c/python-openxml/python-docx/issues/1542 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/6e4964d165aeccb2f907ae0135538242d58474dee15473dd1db16c285f16479c/python-openxml/python-docx/issues/1542 |
| og:image:alt | Issue Description When using python-docx to generate Word documents and setting core_properties.created and core_properties.modified, the file timestamp shown in Windows Explorer is 8 hours ahead o... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | shengcruz |
| hostname | github.com |
| expected-hostname | github.com |
| None | 41b58589a1c4eda1e3c8904144a412b88ca4455f63ca2ad3629f2e9f3c3a1d12 |
| turbo-cache-control | no-preview |
| go-import | github.com/python-openxml/python-docx git https://github.com/python-openxml/python-docx.git |
| octolytics-dimension-user_id | 3403760 |
| octolytics-dimension-user_login | python-openxml |
| octolytics-dimension-repository_id | 13592924 |
| octolytics-dimension-repository_nwo | python-openxml/python-docx |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 13592924 |
| octolytics-dimension-repository_network_root_nwo | python-openxml/python-docx |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8968d6d6acc65d74e4df332d23932dd3fd0502a4 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width