主要内容

convertTo

转换datetime值到数字表示形式

描述

例子

X = convertTo (DdateType转换datetimeD指定的数字表示形式dateType并返回一个数字数组。例如,如果dateType“posixtime”,然后convertTo转换的每个元素D转换为自时代UTC时间1970年1月1日00:00:00。

所有数字表示都描述了相对于一个称为epoch的时间点的日期和时间。计算机通常用自指定纪元以来的秒数或时钟滴答数来度量时间。

例子

X = convertTo (D“epochtime”,名称,值使用名称-值对参数指定纪元和每秒时钟滴答数。例如,如果指定epoch为“时代”,“2001-01-01”,然后输入每个值X表示2001年1月1日午夜前后的秒数。

例子

全部折叠

创建一个数组datetime值。

十12 D = datetime(2019年,1,12日,0,0)
D =1 x3 datetime01- 10 -2019 12:00:00 01- 11 -2019 12:00:00 01- 12 -2019 12:00:00

转换D到表示Excel日期数字的双精度值数组。(若要显示日期的所有数字,请设置数字显示格式为longg.)

格式longgX = convertTo (D,“超越”
X =1×34.3739 4.3770 4.3800

转换D将日期和时间表示为。net时间的数组。由于。net时间必须是无符号64位整数,convertTo的数组uint64数据类型。

X = convertTo (D,“net”
X =1x3 uint64行向量637055280000000000 637082064000000000 637055280000000000

创建一个datetime数组中。指定时区为东京时区。

D = datetime(2019年十12 1 12 0,0,“时区”“亚洲/东京”
D =1 x3 datetime01- 10 -2019 12:00:00 01- 11 -2019 12:00:00 01- 12 -2019 12:00:00

转换D.要将时间表示为自2001年1月1日以来经过的毫秒数,请指定时代TicksPerSecond名称-值对参数。可以将epoch指定为datetime值或格式化为指定日期和时间的文本。当你指定“epochtime”,输出是一个有符号的64位整数数组。

X = convertTo (D,“epochtime”“时代”“2001-01-01”“TicksPerSecond”, 1000)
X =1x3 int64行向量591624000000 594302400000 591624000000

时区为D,则convertTo函数处理的元素D设置为UTC时间“epochtime”

输入参数

全部折叠

输入日期和时间,指定为datetime数组中。

输出数字表示形式的类型,指定为表中的值。

的价值dateType确定输出数组的数据类型。一些数字表示要求无符号或有符号64位整数。根据这些要求,输出可以有uint64,或int64数据类型。

的价值dateType

输出数字表示法

输出数据类型

“超越”

从0- 1 -1900开始的天数,代表一个Excel®日期的数字。这个选项等价于exceltime函数。

注意:Excel的日期是四舍五入到最近的微秒。

注意:Excel错误地假设1900年是闰年。因此,当计算Excel日期时,1900年2月28日和1900年3月1日之间有一个额外的一天的不连续。

“excel1904”

从0-Jan-1904开始的天数,表示Excel日期号。这个选项等价于exceltime函数。

注意:Excel的日期是四舍五入到最近的微秒。

注意:Excel错误地假设1900年是闰年。因此,当计算Excel日期时,1900年2月28日和1900年3月1日之间有一个额外的一天的不连续。

“juliandate”

从UTC 24- 11月4714日中午开始的天数,在预期的格里高利历中,代表儒略日。这个选项等价于juliandate函数。

注意:时区为D没有指定,那么convertTo处理D作为UTC时间,而不是本地时间。要表示本地时间,请使用时区的属性D在调用之前convertTo函数。

例子:转换D使用东京的时区

D.TimeZone =“亚洲/东京”;X = convertTo (D,“juliandate”

“modifiedjuliandate”

UTC 17- 11 -1858午夜以来的天数,表示修改的儒略日期。这个选项等价于juliandate函数。

注意:时区为D没有指定,那么convertTo处理D作为UTC时间,而不是本地时间。要表示本地时间,请使用时区的属性D在调用之前convertTo函数。

例子:转换D使用东京的时区

D.TimeZone =“亚洲/东京”;X = convertTo (D,“modifiedjuliandate”

“posixtime”

从UTC时间0点0分开始的秒数,一个时间点被称为Unix新纪元.这个选项等价于posixtime函数。

Unix时间,亦称UNIX纪元的时间POSIX时间,是一个相对于Unix时代的时间度量系统。(Unix time忽略了闰秒,因此不能真正代表UTC。)

注意:时区为D没有指定,那么convertTo处理D作为UTC时间,而不是本地时间。要表示本地时间,请使用时区的属性D在调用之前convertTo函数。

例子:转换D,指定其时区为东京时区。

D.TimeZone =“亚洲/东京”;X = convertTo (D,“posixtime”

“名称”

日期为YYYYMMDD数值。例如,20140402代表2014年4月2日。

“datenum”

预计ISO日历中从0- 1 -0000开始的天数。

国家结核控制规划的

从1月1日-1900年00:00:00 UTC开始的“时钟滴答数”,表示一个NTP时间戳,其中每个时钟滴答是2^-32秒。

uint64

“net”

自UTC时间1-Jan-0001 00:00:00以来的“时钟滴答数”,代表一个Microsoft®. net时间戳,其中每个时钟周期为100纳秒。

uint64

“ntfs”

自UTC时间1-Jan-1601 00:00:00以来的“时钟滴答数”,表示一个NTFS时间戳,其中每个时钟滴答数为100 ns。

uint64

“epochtime”

自指定的纪元以来的秒数。使用此选项“时代”“TicksPerSecond”名称-值对参数。

注意:时区为D没有指定,那么convertTo处理D作为UTC时间,而不是本地时间。要表示本地时间,请使用时区的属性D在调用之前convertTo函数。

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

D.TimeZone =“亚洲/东京”;X = convertTo (D,“epochtime”“时代”“2001-01-01”

int64

名称-值参数

指定可选的逗号分隔的对名称,值参数。的名字参数名和价值为对应值。的名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:convertTo (D,“epochtime”、“时代”,“2001-01-01”,“TicksPerSecond”,1000年)返回自2001年1月1日开始的毫秒数。

用于时间度量的点,指定为由逗号分隔的对组成“时代”和一个datetime标量、字符向量或字符串标量。

如果“时代”是字符向量或字符串标量,则它必须以datetime函数识别(例如,“2001-01-01”2001年1月1日)。

缺省值为Unix epoch,表示UTC时间1970年1月1日00:00:00。

单击每秒滴答数,指定为逗号分隔的对,由“TicksPerSecond”和一个数字标量。

介绍了R2018b