ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

juliandate

MATLAB の datetime をユリウス日に変換

構文

d = juliandate(t)
d = juliandate(t,dateType)

説明

d = juliandate(t) は、tdatetime 値と等価なユリウス日を返します。

  • t のタイム ゾーンが指定されていない場合、juliandatet の時刻を UTC 時刻として扱います。この解釈は、他のコンテキストで "ゾーンなし" の datetime 配列を扱う場合と異なることがあります。たとえば、datetime('now') は現地時間を返すように思うかもしれません。しかし、juliandate はこれを UTC 時間と解釈します。

  • t のタイム ゾーンが指定されている場合、juliandate はタイム ゾーンのオフセットを使用して、UTC を基準としたユリウス日を計算します。

  • juliandate は、t のタイム ゾーンが UTCLeapSeconds である場合を除き、うるう秒を無視します。

ベスト プラクティスは、juliandate を呼び出す前に t のタイム ゾーンを指定することです。

d = juliandate(t,dateType) は、dateType で指定されたユリウス日の形式を返します。たとえば、datetime 値を修正ユリウス日に変換できます。

すべて折りたたむ

datetime 値を作成し、等価のユリウス日に変換します。ゾーン付きとゾーンなしの datetime 値の間の差を、ユリウス日で表示します。ベスト プラクティスは、juliandate を呼び出す前に datetime 配列のタイム ゾーンを指定することです。

datetime 配列を作成し、タイム ゾーンを指定します。

t1 = datetime('2016-07-29 10:05:24') + calmonths(1:3);
t1.TimeZone = 'America/New_York'
t1 = 1x3 datetime array
   29-Aug-2016 10:05:24   29-Sep-2016 10:05:24   29-Oct-2016 10:05:24

t1 を等価のユリウス日に変換します。juliandate はユリウス日を計算する際にタイム ゾーンを考慮します。

format longG
jd1 = juliandate(t1)
jd1 = 1×3

          2457630.08708333          2457661.08708333          2457691.08708333

t1 と同じ値をもち、タイム ゾーンが設定されていない datetime 配列を作成します。この配列を等価のユリウス日に変換します。juliandatet2 の時間を、タイム ゾーン オフセットがない UTC 時間として扱います。

t2 = datetime('2016-07-29 10:05:24') + calmonths(1:3);
jd2 = juliandate(t2)
jd2 = 1×3

          2457629.92041667          2457660.92041667          2457690.92041667

jd2jd1 の差を表示します。この差は、UTC と jd1 の間の時間オフセット (日単位) と等しくなります。

jd2 - jd1
ans = 1×3

        -0.166666666511446        -0.166666666511446        -0.166666666511446

入力引数

すべて折りたたむ

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

ユリウス日の値の形式。'juliandate' または 'modifiedjuliandate' として指定します。

  • dateType'juliandate' の場合、juliandatet の datetime 値を等価のユリウス日に変換します。ユリウス日は、先発グレゴリオ暦の紀元前 4714 年 11 月 24 日正午以降または先発ユリウス暦の紀元前 4713 年 1 月 1 日以降の日数と端数の日数です。

  • dateType'modifiedjuliandate' の場合、juliandatet の datetime 値を等価の修正ユリウス日に変換します。修正ユリウス日は、1858 年 11 月 17 日 00:00:00 以降の日数と端数の日数です。

詳細

すべて折りたたむ

ユリウス日

ユリウス日は、先発グレゴリオ暦の紀元前 4714 年 11 月 24 日正午以降または先発ユリウス暦の紀元前 4713 年 1 月 1 日以降の日数と端数の日数です。

拡張機能

R2014b で導入