timeofday

datetime 配列の深夜からの経過時間

ページ内をすべて折りたたむ

構文

T = timeofday(DT)
[T,D] = timeofday(DT)

説明

T = timeofday(DT) は、入力 datetime 配列内のすべての日についてクロック時間を返します。この関数は、クロック時間を duration 配列として返します。配列の値は、datetime 配列内の各要素の午前 0 時からの経過時間と等しくなります。

タイム ゾーンのない datetime 配列、および他のほとんどのケースでは、午前 0 時からの経過時間 E は次と等しくなります。

E = hours(DT.Hour) + minutes(DT.Minute) + seconds(DT.Second)

DT の TimeZone プロパティが夏時間 (DST) を考慮するタイム ゾーンに設定されている場合、timeofday で DST が考慮されます。詳細については、アルゴリズムを参照してください。

出力引数 T は DT - dateshift(DT,'start','day') とも等価です。

例

[T,D] = timeofday(DT) は、datetime 配列 D として DT の値の日付部分も返します。

出力引数 D は dateshift(DT,'start','day') と等価です。

例

例

すべて折りたたむ

ライブ スクリプトを開く

datetime 配列を作成します。

DT = datetime('now') + hours(1:3)
DT = 1×3 datetime
   09-Aug-2025 13:00:45   09-Aug-2025 14:00:45   09-Aug-2025 15:00:45

各入力値について深夜からの経過時間を計算します。時間を時、分、秒で表示します。

T = timeofday(DT)
T = 1×3 duration
   13:00:45   14:00:45   15:00:45
ライブ スクリプトを開く

datetime 配列を作成します。

DT = datetime('now') + hours(1:3)
DT = 1×3 datetime
   09-Aug-2025 12:28:52   09-Aug-2025 13:28:52   09-Aug-2025 14:28:52

DT の日付部分を 2 番目の datetime 配列として返します。D の時、分、秒の成分がすべて深夜 (24 時間形式では 00:00:00) に設定されているため、D は日付のみを表示します。

[T,D] = timeofday(DT)
T = 1×3 duration
   12:28:52   13:28:52   14:28:52


D = 1×3 datetime
   09-Aug-2025   09-Aug-2025   09-Aug-2025
ライブ スクリプトを開く

夏時間 (DST) シフトが適用される日の深夜以降の経過時間を計算します。

datetime 配列を作成します。TimeZone プロパティを、DST が実施されるタイム ゾーンに設定します。日付を DST シフトが発生した日に設定します。

tz = 'America/New_York';
fmt = 'dd-MMM-yyyy HH:mm:ss z';
DT = datetime(2015,3,8,'TimeZone',tz,'Format',fmt) + hours(1:4)
DT = 1×4 datetime
   08-Mar-2015 01:00:00 EST   08-Mar-2015 03:00:00 EDT   08-Mar-2015 04:00:00 EDT   08-Mar-2015 05:00:00 EDT

経過時間を計算します。このタイム ゾーンでは DST シフトが 2015 年 3 月 8 日の午前 2 時に発生しました。timeofday では、この日の午前 2 時以降の時刻にシフトが適用されます。経過時間を時間数で表示するように T の書式を設定します。

T = timeofday(DT);
T.Format = 'h'
T = 1×4 duration
   1 hr   2 hr   3 hr   4 hr

比較のために、DT の時、分、秒の成分を使用して経過時間を計算します。この計算では DST シフトは考慮されません。

E = hours(DT.Hour) + minutes(DT.Minute) + seconds(DT.Second)
E = 1×4 duration
   1 hr   3 hr   4 hr   5 hr
ライブ スクリプトを開く

別の datetime 配列内の時刻に基づいて、datetime 配列の時刻を設定します。

時刻を設定する方法は 2 つあります。

  • timeofday を使用して最初の datetime 配列から時刻部分を分割し、2 番目の datetime 配列に時刻部分を追加します。

  • 2 番目の datetime 配列の Hour、Minute、Second の成分を最初の datetime 配列の Hour、Minute、Second の成分と等しくなるように設定します。

最初の方法を使用した場合、夏時間 (DST) シフトが常に正しく考慮されるとは限りません。DST シフトを常に正しく処理できるのは 2 番目の方法だけです。

datetime 配列を作成します。各要素に時刻の異なる時刻の成分を含めます。

DT1 = datetime(2015,3,7) + hours(1:4)
DT1 = 1×4 datetime
   07-Mar-2015 01:00:00   07-Mar-2015 02:00:00   07-Mar-2015 03:00:00   07-Mar-2015 04:00:00

2 番目の datetime 配列を作成します。各要素に同じ日付と時刻の成分を含めます。

DT2 = datetime(2015,3,[8 8 8 8])
DT2 = 1×4 datetime
   08-Mar-2015   08-Mar-2015   08-Mar-2015   08-Mar-2015

DT1 の時刻に基づいて DT2 の時刻を設定します。DT1 と DT2 にはタイム ゾーンがないため、それらの時刻の成分は同じになります。

DT2 = dateshift(DT2,'start','day') + timeofday(DT1)
DT2 = 1×4 datetime
   08-Mar-2015 01:00:00   08-Mar-2015 02:00:00   08-Mar-2015 03:00:00   08-Mar-2015 04:00:00

datetime 配列を作成し、各要素の TimeZone プロパティを 'America/New_York' に設定します。DT3 にはタイム ゾーンがあり、DST シフトが 2015 年 3 月 8 日に発生しているため、DT3 の時刻の成分は DT1 と同じになりません。

tz = 'America/New_York';
fmt = 'dd-MMM-yyyy HH:mm:ss z';
DT3 = datetime(2015,3,8,'TimeZone',tz,'Format',fmt) + timeofday(DT1)
DT3 = 1×4 datetime
   08-Mar-2015 01:00:00 EST   08-Mar-2015 03:00:00 EDT   08-Mar-2015 04:00:00 EDT   08-Mar-2015 05:00:00 EDT

深夜からの経過時間を計算します。timeofday で DST シフトが考慮されます。経過時間から DT3 の時刻が正しくないことがわかります。DT3 の最後の時刻は午前 5 時に対応します。しかし、DT1 では深夜から 4 時間しか経過していません。

T = timeofday(DT3)
T = 1×4 duration
   01:00:00   02:00:00   03:00:00   04:00:00

タイム ゾーンや日付に関係なく DT4 の時刻を正しく設定するには、DT1 の Hour、Minute、および Second のプロパティを使用します。

DT4 = datetime(2015,3,[8 8 8 8],'TimeZone',tz,'Format',fmt);
DT4.Hour = DT1.Hour;
DT4.Minute = DT1.Minute;
DT4.Second = DT1.Second;
DT4
DT4 = 1×4 datetime
   08-Mar-2015 01:00:00 EST   08-Mar-2015 03:00:00 EDT   08-Mar-2015 03:00:00 EDT   08-Mar-2015 04:00:00 EDT

このタイム ゾーンでは DST シフトがその時刻に発生したため、東部標準時 2015 年 3 月 8 日午前 2 時という時刻は存在しません。結果の 2 番目の要素は時刻の成分が東部夏時間の午前 3 時になります。

入力引数

すべて折りたたむ

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

出力引数

すべて折りたたむ

入力配列の時刻部分。duration 配列として返されます。

入力配列の日付部分。datetime 配列として返されます。

アルゴリズム

datetime 配列の TimeZone プロパティを夏時間 (DST) が実施されるタイム ゾーンに設定できます。関数 timeofday では DST が考慮されます。

  • 入力引数 DT がタイム ゾーンのない datetime 配列の場合、出力 T は次とも等しくなります。

    E = hours(DT.Hour) + minutes(DT.Minute) + seconds(DT.Second)

  • DT の TimeZone プロパティが DST が実施されないタイム ゾーンに設定されている場合、T は E と等しくなります。

  • DT の TimeZone プロパティが DST が実施されるタイム ゾーンに設定されている場合、DST シフトが発生した後の日の timeofday に DST シフトが適用されます。DST シフトが発生した後の日の時刻では、T と E の間にそのシフト分の差が生じます。

拡張機能

すべて展開する

バージョン履歴

R2014b で導入

参考

| | | | |