convertTo

'excel'

自 1900 年 1 月 0 日起计的天数，表示 Excel^® 日期值。此选项等效于 exceltime 函数。

注意：Excel 日期值舍入为最近的微秒。

请注意：Excel 错误地假设 1900 年是闰年。因此，计算 Excel 日期值时，1900 年 2 月 28 日与 1900 年 3 月 1 日之间因为多了一天而中断。

double

'excel1904'

自 1904 年 1 月 0 日起计的天数，表示 Excel 日期值。此选项等效于 exceltime 函数。

注意：Excel 日期值舍入为最近的微秒。

请注意：Excel 错误地假设 1900 年是闰年。因此，计算 Excel 日期值时，1900 年 2 月 28 日与 1900 年 3 月 1 日之间因为多了一天而中断。

double

'juliandate'

自 UTC 时间公元前 4714 年 11 月 24 日中午（外推格里历）起计的天数，表示儒略日期。此选项等效于 juliandate 函数。

注意：如果未指定 D 的时区，则 convertTo 会将 D 中的值视为 UTC 时间，而不是本地时间。要表示本地时间，请在调用 convertTo 函数之前，使用 D 的 TimeZone 属性指定时区。

示例：使用东京的时区转换 D。

D.TimeZone = 'Asia/Tokyo';
X = convertTo(D,'juliandate')

double

'modifiedjuliandate'

自 UTC 时间 1858 年 11 月 17 日午夜起计的天数，表示修改后的儒略日期。此选项等效于 juliandate 函数。

注意：如果未指定 D 的时区，则 convertTo 会将 D 中的值视为 UTC 时间，而不是本地时间。要表示本地时间，请在调用 convertTo 函数之前，使用 D 的 TimeZone 属性指定时区。

示例：使用东京的时区转换 D。

D.TimeZone = 'Asia/Tokyo';
X = convertTo(D,'modifiedjuliandate')

double

'posixtime'

自 UTC 时间 1970 年 1 月 1 日 00:00:00（该时间点称为 Unix 纪元）起计的秒数。此选项等效于 posixtime 函数。

Unix 时间，也称为 UNIX 纪元时间或 POSIX 时间，是针对 Unix 纪元测量时间的系统。（Unix 时间会忽略闰秒，因此不能真正表示 UTC 时间。）

注意：如果未指定 D 的时区，则 convertTo 会将 D 中的值视为 UTC 时间，而不是本地时间。要表示本地时间，请在调用 convertTo 函数之前，使用 D 的 TimeZone 属性指定时区。

示例：转换 D，将其时区指定为东京所在的时区。

D.TimeZone = 'Asia/Tokyo';
X = convertTo(D,'posixtime')

double

'yyyymmdd'

以 YYYYMMDD 数值形式表示的日期。例如，20140402 表示 2014 年 4 月 2 日。

double

'datenum'

自 0000 年 1 月 0 日（外推 ISO 日历）起计的天数。

double

'ntp'

自 UTC 时间 1900 年 1 月 1 日 00:00:00 起计的“时钟计时单元”数，表示网络时间协议 (NTP) 时间戳，其中每个时钟计时单元为 2^-32 秒。

uint64

'.net'

自 UTC 时间 0001 年 1 月 1 日 00:00:00 起计的“时钟计时单元”数，表示 Microsoft^® .NET 时间戳，其中每个时钟计时单元为 100 纳秒。

uint64

'ntfs'

自 UTC 时间 1601 年 1 月 1 日 00:00:00 起计的“时钟计时单元”数，表示 NTFS 时间戳，其中每个时钟计时单元为 100 纳秒。

uint64

'tt2000'

自 J2000 以来经过的纳秒数。常用数据格式 (CDF) 将 CDF_TIME_TT2000（或 TT2000）数据类型定义为高分辨率时间类型，用于处理 CDF 文件中数据的闰秒。有关详细信息，请参阅在 CDF 中处理闰秒的要求。

要将 datetime 数组转换为 TT2000 时间数组，请将输入 datatime 数组的 TimeZone 属性设置为 UTCLeapSeconds。UTCLeapSeconds 时区是唯一考虑闰秒的时区。

注意：J2000 是 2000 年 1 月 1 日 12:00 的地球时 (TT)。TT 与 UTC 的不同之处在于两个因素：

因此，J2000 实际上发生在 UTCLeapSeconds 时区中午前 64.184 秒，时间是：

D = datetime(2000,1,1,11,58,55,816,"TimeZone","UTCLeapSeconds")

D = 2000-01-01T11:58:55.816Z

示例：将 D 的时区设置为 UTCLeapSeconds。然后将 D 转换为一个 TT2000 时间数组。

D = datetime(2022,4,1:3,9,30,45, ...
             "TimeZone","UTCLeapSeconds");
D = D'

D = 
  3x1 datetime array
   2022-04-01T09:30:45.000Z
   2022-04-02T09:30:45.000Z
   2022-04-03T09:30:45.000Z

X = convertTo(D,"tt2000")

X =
  3x1 int64 column vector
   702077514184000000
   702163914184000000
   702250314184000000

int64

'epochtime'

自指定纪元起计的秒数。将此选项与 'Epoch' 和 'TicksPerSecond' 名称-值对组参量结合使用。

注意：如果未指定 D 的时区，则 convertTo 会将 D 中的值视为 UTC 时间，而不是本地时间。要表示本地时间，请在调用 convertTo 函数之前，使用 D 的 TimeZone 属性指定时区。

示例：指定 D 的时区。然后将其转换为自 2001 年 1 月 1 日以来经过的秒数。

D.TimeZone = 'Asia/Tokyo';
X = convertTo(D,'epochtime','Epoch','2001-01-01')

int64