構文
DateTimeZone.From(value as any, optional culture as nullable text) as nullable datetimezone
バージョン情報
指定した値から datetimezone を作成します。
-
value:datetimezoneの作成に使用される値。 -
culture: (省略可能) 値を変換するときに使用するカルチャ (例: "en-US")。
次の型の値は、 datetimezone 値に変換できます。
-
text: テキスト表現からdatetimezone値を返します。 詳細については、 DateTimeZone.FromText を参照してください。 -
date: 日付コンポーネントとしてdatetimezone、時刻コンポーネントとしてvalue、ローカル タイム ゾーンに対応するオフセットを持つ12:00:00 AMを返します。 -
datetime:datetimezoneを日時として、ローカルタイムゾーンに対応するオフセットを持つvalueを返します。 -
datetimezone:valueを返します。 -
time: 日付コンポーネントとして OLE オートメーション日付のdatetimezoneに相当する日付、時刻コンポーネントとして0、ローカル タイム ゾーンに対応するオフセットを持つvalueを返します。 OLE オートメーション日付は、整数部分が 1899 年 12 月 30 日の午前 0 時前後の日数を表し、その日の時刻を 24 で除算した小数部分を表す浮動小数点数で構成されます。 たとえば、1899 年 12 月 31 日の午前 0 時は 1.0 で表されます。1900 年 1 月 1 日午前 6 時は 2.25 で表されます。1899 年 12 月 29 日午前 0 時は -1.0 で表されます。1899 年 12 月 29 日午前 6 時は -1.25 で表されます。 基本値は 1899 年 12 月 30 日午前 0 時です。 最小値は 0100 年 1 月 1 日午前 0 時です。 最大値は、9999 年 12 月 31 日の最後の瞬間です。 -
number:datetimezoneで表される OLE オートメーション日付に相当する datetime とローカル タイム ゾーンに対応するオフセットを持つ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)