DateTimeZone.FromText

Syntax

DateTimeZone.FromText(text as nullable text, optional options as any) as nullable datetimezone

About

Creates a datetimezone value from a textual representation, text. An optional record parameter, options, may be provided to specify additional properties. The record can contain the following fields:

• Format: A text value indicating the format to use. For more details, go to https://go.microsoft.com/fwlink/?linkid=2180104 and https://go.microsoft.com/fwlink/?linkid=2180105. Omitting this field or providing null will result in parsing the date using a best effort.

• Culture: When Format is not null, Culture controls some format specifiers. For example, in "en-US" "MMM" is "Jan", "Feb", "Mar", ..., while in "ru-RU" "MMM" is "янв", "фев", "мар", .... When Format is null, Culture controls the default format to use. When Culture is null or omitted, Culture.Current is used.

To support legacy workflows, options may also be a text value. This has the same behavior as if options = [Format = null, Culture = options].

Example 1

Convert "2010-12-31T01:30:00-08:00" into a datetimezone value.

Usage

DateTimeZone.FromText("2010-12-31T01:30:00-08:00")

Output

#datetimezone(2010, 12, 31, 1, 30, 0, -8, 0)

Example 2

Convert using a custom format and the German culture.

Usage

DateTimeZone.FromText("30 Dez 2010 02:04:50.369730 +02:00", [Format="dd MMM yyyy HH:mm:ss.ffffff zzz", Culture="de-DE"])

Output

#datetimezone(2010, 12, 30, 2, 4, 50.36973, 2, 0)

Example 3

Convert using ISO 8601.

Usage

DateTimeZone.FromText("2009-06-15T13:45:30.0000000-07:00", [Format="O", Culture="en-US"])

Output

#datetimezone(2009, 6, 15, 13, 45, 30, -7, 0)