exceltime

MATLAB datetime の Excel 日付値への変換

構文

e = exceltime(t)

e = exceltime(t,dateType)

説明

e = exceltime(t) は t 内の datetime 値と等しい Excel^® のシリアル日付値を含む double 配列を返します。Excel のシリアル日付値は、1900 年 1 月 0 日 00:00:00 からの日数と端数の日数であり、タイム ゾーンやうるう秒は考慮されません。

e = exceltime(t,dateType) は dateType で指定されたタイプの Excel のシリアル日付値を返します。たとえば、datetime 値を 1904 年 1 月 1 日 00:00:00 からの日数に変換できます。

例

datetime 配列の Excel 日付値への変換

datetime 配列を作成します。次に、この日付を等価な Excel® シリアル日付値に変換します。

t = datetime('now') + calmonths(1:3)

t = 1×3 datetime
   09-Sep-2025 11:58:06   09-Oct-2025 11:58:06   09-Nov-2025 11:58:06

e = exceltime(t)

e = 1×3
104 ×

    4.5909    4.5939    4.5970

入力引数

t — 入力の日付と時刻

datetime 配列

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

dateType — Excel のシリアル日付値のタイプ

'1900' (既定値) | '1904'

Excel のシリアル日付値のタイプ。'1900' または '1904' のいずれかで指定します。

• dateType が '1900' の場合、exceltime は t 内の datetime 値を 1900 年 1 月 0 日 00:00:00 からの日数と端数の日数に等しい値に変換します。

• dateType が '1904' の場合、exceltime は t 内の datetime 値を 1904 年 1 月 1 日 00:00:00 からの日数と端数の日数に等しい値に変換します。

exceltime はタイム ゾーンを考慮しません。

出力引数

e — Excel のシリアル日付値

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

Excel のシリアル日付値。double 型のスカラー、ベクトル、行列または多次元配列として返されます。Excel のシリアル日付値はその開始日時 (1900 年 1 月 0 日または 1904 年 1 月 1 日) 以前は定義されません。Excel のシリアル日付値は 1900 年をうるう年として扱います。このため、1900 年 2 月 28 日よりも後の日付は MATLAB^® のシリアル日付値に対して 1 日ずれており、1900 年 2 月 28 日と 1900 年 3 月 1 日の間は 1 日分不連続になります。

拡張機能

tall 配列

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

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

スレッドベースの環境

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

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

分散配列

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

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

バージョン履歴

R2014b で導入

参考

convertTo | posixtime | yyyymmdd | datetime | juliandate