DateTimeValue (NotesItem - LotusScript®)

Read-write. Returns a NotesDateTime object representing the value of the item.

Defined in


Data type



To get: Set notesDateTime = notesItem .DateTimeValue

To set: Set notesItem .DateTimeValue = notesDateTime


This works best if the item is of a date/time type. If not, Notes® tries to interpret the value as a date/time (e.g. if it's Text but contains a value that looks like a date). If that fails, this property returns Nothing.

Unlike LotusScript® date-time variants, Notes® date-time items and NotesDateTime objects store a time zone and hundredths of a second. Use the DateTimeValue property if you need to retain an item's time zone or hundredths of a second component.