Home > @i2analyze/i2connect > data > createZonedDateTime
data.createZonedDateTime() function
Creates a date-time object that has a time zone from an ISO 8601 string ('yyyy-mm-ddThh:mm:ss' or 'yyyy-mm-ddThh:mm:ss.sss') and a time zone identifier.
Signature:
function createZonedDateTime(iso8601: ISO8601LocalDateTime, timeZoneId: TimeZoneId, isDst: boolean): IZonedDateTime;
Introduced: API version 2.0
Parameters
| Parameter | Type | Description |
|---|---|---|
| iso8601 | ISO8601LocalDateTime | An ISO 8601-formatted string that represents the date and time. |
| timeZoneId | TimeZoneId | A time zone identifier. |
| isDst | boolean | true if the date-time is in daylight saving time for the specified time zone; false otherwise. This value is especially important for date-time values that are ambiguous, such as during the period when clocks go back from DST to not-DST and the same local time occurs twice. |
Returns:
The new date-time object.
Exceptions
Error if the string was not in valid ISO 8601 format, or timeZoneId did not specify a valid time zone.