Converting between Domino® Designer and LotusScript® time
The formats of a Domino® Designer date-time item and a LotusScript® date variant differ. For example, you cannot put a LotusScript® date variant in a Domino® Designer date-time item or manipulate a Domino® Designer time-date item with LotusScript® date functions.
The NotesDateTime class converts between formats by representing both formats as properties. For example, you can get the value of a Domino® Designer date-time item by setting the LocalTime property, which is in Domino® Designer format, and then manipulating the value with LotusScript® functions by accessing the LSLocalTime property of the same object.
The following table lists the NotesDateTime properties:
| Property |
Data type |
Description |
|---|---|---|
| DateOnly |
String |
(Read-only) Date part of Domino® Designer date-time in local time |
| GMTTime |
String |
(Read-only) Domino® Designer date-time in Greenwich Mean Time |
| IsDST |
Boolean |
(Read-only) True if the time is daylight-saving time |
| LocalTime |
String |
(Read-write) Domino® Designer date-time in local time |
| LSGMTTime |
Date variant |
(Read-only) LotusScript® date-time in Greenwich Mean Time |
| LSLocalTime |
Date variant |
(Read-write) LotusScript® date-time in local time |
| Parent |
NotesSession |
(Read-only) The session that contains a DateTime object. For COM only |
| TimeOnly |
String |
(Read-only) Time part of Domino® Designer date-time in local time |
| TimeZone |
Integer |
(Read-only) Hours that must be added to the time to get Greenwich Mean Time |
| ZoneTime |
String |
(Read-only) Domino® Designer date-time adjusted for TimeZone and IsDST, which can be changed with ConvertToZone |
The NotesDateRange class represents a range of dates. The following table lists the NotesDateRange properties. When you set a NotesDateRange object, either write to StartDate and EndDate, or Text, but not both. Values written to StartDate or EndDate are immediately transcribed to Text, and vice versa.
| Property |
Data type |
Description |
|---|---|---|
| EndDateTime |
NotesDateTime |
(Read-write) Domino® Designer date-time in local time |
| Parent |
NotesSession |
(Read-only) The session that contains a DateRange object For COM only. |
| StartDateTime |
NotesDateTime |
(Read-write) The starting date-time of the range |
| Text |
String |
(Read-write) The range as two date-time strings separated by a hyphen |