update_last_saved_time_property property

SaveOptions.update_last_saved_time_property property

Gets or sets a value determining whether the BuiltInDocumentProperties.last_saved_time property is updated before saving.

@property
def update_last_saved_time_property(self) -> bool:
    ...

@update_last_saved_time_property.setter
def update_last_saved_time_property(self, value: bool):
    ...

Examples

Shows how to determine whether to preserve the document’s “Last saved time” property when saving.

doc = aw.Document(MY_DIR + "Document.docx")

self.assertEqual(datetime(2021, 5, 11, 6, 32, 0, tzinfo=timezone.utc),
    doc.built_in_document_properties.last_saved_time)

# When we save the document to an OOXML format, we can create an OoxmlSaveOptions object
# and then pass it to the document's saving method to modify how we save the document.
# Set the "update_last_saved_time_property" property to "True" to
# set the output document's "Last saved time" built-in property to the current date/time.
# Set the "update_last_saved_time_property" property to "False" to
# preserve the original value of the input document's "Last saved time" built-in property.
save_options = aw.saving.OoxmlSaveOptions()
save_options.update_last_saved_time_property = update_last_saved_time_property

doc.save(ARTIFACTS_DIR + "OoxmlSaveOptions.last_saved_time.docx", save_options)

doc = aw.Document(ARTIFACTS_DIR + "OoxmlSaveOptions.last_saved_time.docx")
last_saved_time_new = doc.built_in_document_properties.last_saved_time

if update_last_saved_time_property:
    self.assertAlmostEqual(datetime.now(timezone.utc), last_saved_time_new, delta=timedelta(days=1))
else:
    self.assertEqual(datetime(2021, 5, 11, 6, 32, 0, tzinfo=timezone.utc), last_saved_time_new)

See Also

SaveOptions.update_last_printed_property property SaveOptions.use_anti_aliasing property