@AttachmentModifiedTimes (Formula Language)

Returns a datetime that displays the date on which the file attachment associated with the current document was last modified. If the document contains more than one file attachment, returns the modification dates in a datetime list.

Note: This @function is new with Release 6.

Syntax

@AttachmentModifiedTimes( excludeMIMEBody )

Parameters

excludeMIMEBody

Boolean. Optional.

  • Specify True (1) to exclude large MIME parts that are stored as attachments (but displayed in-line). This is the default.
  • Specify False (0) to include large MIME parts that are stored as attachments (but displayed in-line).

Return value

modificationDate

Datetime or datetime list.

  • If the current document contains one attachment, the modificationDate is a datetime value representing the date on which the attachment was last modified.
  • If the current document contains more than one attachment, the modificationDate is a datetime list value representing the dates on which the attachments were last modified. The order in which the dates display in the list matches the order in which the file names display in the text list returned by @AttachmentNames.
  • If the current document has no attachments, returns a null string ("").

Examples

  1. For a document that contains a rich text field containing one attached file, this code, when added to a computed datetime field, returns 09/26/2001, the date on which the attached file was last modified.
    @AttachmentModifiedTimes
  2. If the document contains a rich text field to which the domino.dtd, whitepaper.pdf, and myreport.wk1 files were attached on August 7th, the following code, when added to a computed datetime field, returns: 09/25/2001;05/10/2001;09/26/2001, which are the respective dates on which the attached files were last modified.
    @AttachmentModifiedTimes
  3. If a form contains two rich text fields and you attach the domino.dtd file to the first field, save the document, and reopen it, this code, in a computed datetime field, displays 09/25/2001.
    @AttachmentModifiedTimes

    If you then attach the whitepaper.pdf file to the second rich text field and refresh the document, the computed field changes to display 09/25/2001;05/10/2001. Attaching the myreport.wk1 file to the first rich text field and refreshing the document causes the computed field to return 09/25/2001;05/10/2001;09/26/2001.