Syntax
DateTimeZone.From(value as any, optional culture as nullable text) as nullable datetimezone
About
从给定的值创建一个 datetimezone 。
-
value：用于创建datetimezone的值。 -
culture：（可选）转换值时使用的文化（例如，“en-US”）。
可以将以下类型的值转换为 datetimezone 值：
-
text：从文本表示形式返回一个datetimezone值。 有关详细信息，请参阅 DateTimeZone.FromText。 -
date：返回一个datetimezone，其中value作为日期组件，12:00:00 AM作为时间组件，并且偏移量对应于本地时区。 -
datetime：返回一个datetimezone，其中value是日期/时间，并且偏移量对应本地时区。 -
datetimezone：返回value。 -
time：返回一个datetimezone与 OLE 自动化日期0等效的日期作为日期组件，value作为时间组件，以及对应于本地时区的偏移量。 OLE 自动化日期由浮点数组成，其整型部分是 1899 年 12 月 30 日午夜前后的天数，其小数部分表示当天除以 24 的时间。 例如，1899 年 12 月 31 日午夜表示为 1.0;上午 6,1900 年 1 月 1 日，以 2.25 表示：午夜，1899 年 12 月 29 日表示为 -1.0;和上午 6,1899 年 12 月 29 日以 -1.25 表示。 基值为 1899 年 12 月 30 日午夜。 最小值为午夜，公元 0100 年 1 月 1 日。 最大值是 9999 年 12 月 31 日的最后一刻。 -
number：返回一个datetimezone，其日期时间等同于表达为 OLE 自动化日期的value，并带有与本地时区对应的偏移量。 -
null：返回null。
如果 value 为任何其他类型，则返回错误。
本地运行此函数时，其对应于本地时区的偏移量值与在线运行时不同。 在本地运行时，将返回本地时区。 联机运行时，将返回 UTC 时区（+00：00）。
示例 1
将日期、时间和时区的文本表示形式转换为 datetimezone 值。
使用情况
DateTimeZone.From("2020-10-30T01:30:00-08:00")
输出
#datetimezone(2020, 10, 30, 01, 30, 00, -8, 00)
示例 2
将巴西葡萄牙语日期、时间和时区的文本表示形式转换为值 datetimezone 。
使用情况
DateTimeZone.From("13 de agosto de 2025 15:43:00 -03:00", "pt-BR")
输出
#datetimezone(2025, 08, 13, 15, 43, 00, -3, 00)
示例 3
将表示 2025 年 1 月 1 日下午 12 点的数字转换为值 datetimezone 。 结果中的时区取决于示例是在本地运行还是联机运行。
使用情况
DateTimeZone.From(45658.5)
输出
#datetimezone(2025, 01, 01, 12, 00, 00, 0, 00)