DateTimeZone.From
Syntax
DateTimeZone.From(value as any, optional culture as nullable text) as nullable datetimezone
About
Returns a datetimezone
value from the given value
. An optional culture
may also be provided (for example, "en-US"). If the given value
is null
, DateTimeZone.From returns null
. If the given value
is datetimezone
, value
is returned. Values of the following types can be converted to a datetimezone
value:
text
: Adatetimezone
value from textual representation. Refer to DateTimeZone.FromText for details.date
: Adatetimezone
withvalue
as the date component,12:00:00 AM
as the time component, and the offset corresponding the local time zone.datetime
: Adatetimezone
withvalue
as the datetime and the offset corresponding the local time zone.time
: Adatetimezone
with the date equivalent of the OLE Automation Date of0
as the date component,value
as the time component, and the offset corresponding the local time zone.number
: Adatetimezone
with the datetime equivalent to the OLE Automation Date expressed byvalue
and the offset corresponding the local time zone.
If value
is of any other type, an error is returned.
Example 1
Convert "2020-10-30T01:30:00-08:00"
to a datetimezone
value.
Usage
DateTimeZone.From("2020-10-30T01:30:00-08:00")
Output
#datetimezone(2020, 10, 30, 01, 30, 00, -8, 00)