tzoffset

UTC からのタイム ゾーン オフセット

構文

dt = tzoffset(t)

[dt,dst] = tzoffset(t)

説明

dt = tzoffset(t) は、t の各 datetime 値の UTC からのタイム ゾーン オフセットと等しい duration の配列を返します。つまり、dt は、UTC からの t の各 datetime の時差です。夏時間 (DST) の間に発生する datetime 値の場合、dt には DST の時間シフトが含まれます。ゾーンなしの datetime 値のオフセットは定義されません。

[dt,dst] = tzoffset(t) は、t の各 datetime の夏時間の時間シフトも追加で返します。

例

タイム ゾーン オフセットの計算

ニューヨーク市のタイム ゾーンで datetime 配列を作成します。

t1 = datetime('today','TimeZone','America/New_York');
t = dateshift(t1,'end','month',[1:3:9])

t = 1×3 datetime
   30-Sep-2025   31-Dec-2025   31-Mar-2026

datetime の各値に対して、UTC からのタイム ゾーン オフセットと夏時間の時間シフトを求めます。

[dt,dst] = tzoffset(t)

dt = 1×3 duration
   -04:00   -05:00   -04:00

dst = 1×3 duration
   01:00   00:00   01:00

入力引数

t — 入力の日付と時刻

datetime 配列

入力の日付と時刻。datetime 配列として指定します。

出力引数

dt — UTC からのタイム ゾーン オフセット

スカラー | ベクトル | 行列 | 多次元配列

UTC からのタイム ゾーン オフセット。スカラー、ベクトル、行列または多次元の duration 配列として返されます。dt は t と同じサイズになります。

dst — 夏時間の時間シフト

スカラー | ベクトル | 行列 | 多次元配列

夏時間の時間シフト。スカラー、ベクトル、行列または多次元の duration 配列として返されます。dt は t と同じサイズになります。01:00 の値は、t の対応する datetime が、夏時間を実施している場所で夏時間の間に発生することを示します。夏時間を実施していない場所の場合、dst 配列の要素はすべて 00:00 です。

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

tzoffset 関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2014b で導入

参考

isdst