datetime

表示时间点的数组

展开全部页面

描述

的datetime数据类型表示时间点，例如2020年8月24日上午10:50:30。一个datetime数组指定与存储在数组中的每个时间点相关的年、月、日、小时、分钟和秒组件(使用预期的ISO日历)。

同时,datetime数组提供:

输出显示和输入文本解析的灵活格式。
从小数秒到纳秒精度的存储。
属性来考虑时区、夏令时和闰秒。

创建

语法

T = datetime

t = datetime(relativeDay)

t = datetime(DateStrings)

t = datetime(DateStrings，'InputFormat'，infmt)

t = datetime(datevtors)

t = date (Y,M,D)

t = datetime(Y,M,D,H,MI,S)

t = date (Y,M,D,H,MI,S,MS)

t = date (X，'ConvertFrom'，dateType)

T =日期时间(___、名称、值)

描述

t= datetime返回一个标量datetime对应于当前日期和时间的数组。

例子

t= datetime (relativeDay）使用指定的日期relativeDay．的relativeDay输入可以是“今天”，“明天”，“昨天”,或“现在”．

t= datetime (DateStrings）中的文本创建日期时间值数组DateStrings表示时间点。

例子

t= datetime (DateStringsInputFormat”,infmt）解释DateStrings所指定的格式infmt．输入参数中的所有值DateStrings必须具有相同的格式。

要避免相似格式之间的歧义，请指定“InputFormat”和它对应的值，infmt．

控件的显示格式t，指定“格式”名称-值对参数，或设置格式的属性t．

例子

t= datetime (DateVectors）中的日期向量创建日期时间值的列向量DateVectors．

t= datetime (Y、M, D）属性的相应元素创建日期时间值数组Y，米,D(年，月，日)数组。数组必须具有相同的大小(或者任何数组都可以是标量)。你也可以将输入参数指定为日期向量，[y m d]．

t= datetime (Y、M D H MI S）还创建了H，心肌梗死,年代(小时，分钟和秒)数组。所有数组必须具有相同的大小(或者任何数组都可以是标量)。你也可以将输入参数指定为日期向量，[y m d h mi s]．

t= datetime (Y、M D H MI,年代,女士）增加了一个女士(毫秒)数组。所有数组必须具有相同的大小(或者任何数组都可以是标量)。

例子

t= datetime (X“ConvertFrom”,dateType）将数值转换为X到一个datetime数组t．的dateType参数中值的类型X．

如果X包含POSIX^®表示本地时间的时间或儒略历日期，然后指定适当的时区t使用“时区”名称-值对参数。如果没有指定时区，则POSIX时间或朱利安日期X被视为UTC时间，而不是本地时间。

t= datetime (___，名称,值）除前面语法中的任何输入参数外，使用一个或多个名称-值对参数指定其他选项。例如，指定的显示格式t使用“格式”名称-值对参数。

为了从文本创建datetime值时获得最佳性能，请指定其中任何一个“格式”或“InputFormat”和它对应的值，infmt．

输入参数

全部展开

`relativeDay`- - - - - -相对于当前日期的日期
`“昨天”`|`“今天”`|`“明天”`|`“现在”`

相对于当前日期的日期，指定为以下值之一。

的价值`relativeDay`	描述
`“昨天”`	前一天午夜的日期
`“今天”`	当前日期，午夜
`“明天”`	第二天的日期，午夜
`“现在”`	当前日期和时间

`DateStrings`- - - - - -表示日期和时间的文本
字符数组|字符向量的单元格数组|字符串数组

表示日期和时间的文本，指定为字符数组、字符向量的单元格数组或字符串数组。的datetime函数首次尝试匹配的格式DateStrings到常用格式。如果您知道格式，请指定“InputFormat”和它对应的infmt值，或“格式”名称-值对参数。

例子:“24 - 10月2014 12:45:07”

例子:{' 15 - 10月- 2013 ',' 20 - 11月- 2014 '}

例子:[" 11 - 11月- 2016”,“12 - 12月- 2016”)

数据类型:字符|细胞|字符串

`infmt`- - - - - -输入文本的格式
特征向量|字符串标量

表示日期和时间的输入文本格式，指定为字符向量或包含字母标识符的字符串标量:

如果infmt不包括日期说明符，那么datetime假设中的值DateStrings发生在当天。
如果infmt不包括时间说明符，那么datetime假设中的值DateStrings发生在午夜。

此表显示了几种常见的输入格式，并包括日期，2014年4月19日星期六，纽约市晚上9:41:06.12345的格式化输入示例。

的价值`infmt`	例子
`“yyyy-MM-dd”`	`2014-04-19`
`“dd / MM / yyyy”`	`19/04/2014`
`“dd.MM.yyyy”`	`19.04.2014`
`'yyyy年MM月dd日'`	`2014年 04月 19日`(日语地区的字符，`ja_JP`）
`'MMMM d, yyyy'`	`4月19日`
`'eeee, MMMM d, yyyy h:mm a'`	`2014年4月19日星期六晚上9:41`
`'MMMM d, yyyy HH:mm:ss Z'`	`2014年4月19日21:41:06 -0400`
`“yyyy-MM-dd“T”HH: mmXXX`	`2014 - 04 - 19 - t21:41内`
`“yyyy-MM-dd HH: mm: ss。瑞士的`	`2014-04-19 21:41:06.123`

对于表示小数秒的输入文本，可以指定infmt最多九个年代表示分数秒数字的字符。例如,“yyyy-MM-dd HH: mm: ss。瑞士的以毫秒精度表示日期和时间的文本格式。

有关有效字母标识符的完整列表，请参见格式属性用于datetime数组。

请注意

字母标识符datetime属性所使用的标识符不同datestr，datenum,datevec功能。

数据类型:字符|字符串

`DateVectors`- - - - - -日期向量
矩阵

日期向量，指定为米6或米-by-3矩阵包含米分别为完整或部分日期向量。完整的日期向量有六个元素，按此顺序指定年、月、日、小时、分钟和秒。部分日期向量有三个元素，按顺序指定年、月和日。的每个元素DateVector应该是一个正整数或负整数值，除了seconds元素，它可以是小数。如果一个元素超出了常规范围，datetime调整日期向量元素和前一个元素。例如，如果minutes元素是70,然后datetime调整小时元素1并将minutes元素设置为10．如果minutes元素是-15,然后datetime减少小时元素1并将minutes元素设置为45．

例子:[2014 10 24 12 45 07]

例子:[2014 10 24]

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

`Y、M, D`- - - - - -年、月和日数组
数字数组

指定为数值数组的年、月和日数组。这些数组的大小必须相同，否则任何一个数组都可以是标量。Y、M, D应该是整数值。

如果Y、M, D都是标量或列向量，那么你可以将输入参数指定为日期向量，[y m d]．
的元素Y，米,或D那么，输入就超出了常规范围datetime调整该元素和前一个输入的相同元素。具体操作请参见DateVectors输入参数。

例子:2003、10、24

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

`Y、M D H MI S`- - - - - -年、月、日、小时、分钟和秒数组
数字数组

年、月、日、小时、分钟和秒数组指定为数值数组。这些数组的大小必须相同，否则任何一个数组都可以是标量。指定小数秒作为秒输入的一部分，年代．的Y、M D H MI数组必须包含整数值。

如果Y、M D H MI S都是标量或列向量，那么你可以指定输入参数作为一个日期向量[y m d h mi s]．
的元素Y，米，D，H，心肌梗死,或年代那么，输入就超出了常规范围datetime调整该元素和前一个输入的相同元素。具体操作请参见DateVectors输入参数。

例子:2003年,10日,24日,12日,45岁的07.451

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

`Y、M D H MI,年代,女士`- - - - - -年、月、日、小时、分钟、秒和毫秒数组
数字数组

年、月、日、小时、分钟、秒和毫秒数组，指定为数值数组。这些数组的大小必须相同，否则任何一个数组都可以是标量。的Y、M D H MI S数组必须包含整数值。女士可以包含分数毫秒。

的元素Y，米，D，H，心肌梗死，年代,或女士那么，输入就超出了常规范围datetime调整该元素和前一个输入的相同元素。具体操作请参见DateVectors输入参数。

例子:12 2003年10,24日,45,07年,10.52

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

`X`- - - - - -数值
数组

数值，指定为数组。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

`dateType`- - - - - -中值的类型`X`
`“datenum”`|`“超越”`|`“excel1904”`|`“juliandate”`|……

中值的类型X，指定为这些值之一。

的价值`dateType`	中值的类型`X`
`“datenum”`	自1月0日至0000日(预期ISO日历)的天数。
`“超越”`	1900年1月0日起的天数。 Excel^®日期数字四舍五入到最接近的微秒。注意:Excel错误地假设1900年是闰年。因此，当计算Excel日期数字时，在1900年2月28日和1900年3月1日之间有一个额外的一天不连续。
`“excel1904”`	自1904年1月0日起的天数。 Excel日期数字四舍五入到最接近的微秒。注意:Excel错误地假设1900年是闰年。因此，当计算Excel日期数字时，在1900年2月28日和1900年3月1日之间有一个额外的一天不连续。
`“juliandate”`	自协调世界时公元前11月24日-4714日中午(预期公历)起的天数。如果你转换`X`到一个`datetime`数组而不指定时区，则`datetime`值表示UTC时间，而不是本地时间。要表示本地时间，请使用`“时区”`名称-值对参数。例子:转换`X`使用纽约的时区 T = date (X，'ConvertFrom'，'juliandate'，…“时区”、“美国/ New_York”) 然后，您可以转换`T`到一个未分区`datetime`数组，通过将空字符向量赋值来表示本地时间`时区`． T.TimeZone = "
`“modifiedjuliandate”`	自协调世界时1858年11月17日午夜起的天数。如果你转换`X`到一个`datetime`数组而不指定时区，则`datetime`值表示UTC时间，而不是本地时间。要表示本地时间，请使用`“时区”`名称-值对参数。例子:转换`X`使用纽约的时区 T = date (X，'ConvertFrom'，'modifiedjuliandate'，…“时区”、“美国/ New_York”) 然后，您可以转换`T`到一个未分区`datetime`数组，通过将空字符向量赋值来表示本地时间`时区`． T.TimeZone = "
`“posixtime”`	自UTC时间1970年1月1日00:00:00开始的秒数，不包括闰秒。如果你转换`X`到一个`datetime`数组而不指定时区，则`datetime`值表示UTC时间，而不是本地时间。要表示本地时间，请使用`“时区”`名称-值对参数。例子:转换`X`使用纽约的时区 T = date (X，'ConvertFrom'，'posixtime'，…“时区”、“美国/ New_York”) 然后，您可以转换`T`到一个未分区`datetime`数组，通过将空字符向量赋值来表示本地时间`时区`． T.TimeZone = "
`“名称”`	日期为YYYYMMDD数值。例如,`20140402`代表2014年4月2日。
`国家结核控制规划的`	自UTC时间1月1日-1900 00:00:00以来的“时钟滴答”数，其中每个时钟滴答为2^-32秒。
`“net”`	从UTC时间1- 1- 0001 00:00:00开始的“时钟滴答”数，其中每个时钟滴答为100ns。
`“ntfs”`	自UTC时间1月1日-1601 00:00:00开始的“时钟滴答”数，其中每个时钟滴答为100ns。
`“epochtime”、“时代”,epochValue`	从一个纪元开始的秒数。您还必须指定`epochValue`，这是一个标量`datetime`，或表示纪元时间的字符向量或字符串标量。例子:返回自2000年1月1日以来的天数。 T = date (X，'ConvertFrom'，…“epochtime”、“时代”,“2000-01-01”)
`“epochtime”、“时代”,epochValue“TicksPerSecond”,n`	一个纪元以来“时钟滴答”的次数。除了指定`epochValue`，也可以指定`n`，这是一个标量整数，指定每秒“时钟滴答”的数量。例子:返回自2000年1月1日以来的天数，其中`X`表示该日期之后或之前的时间(以毫秒为单位)。 T = date (X，'ConvertFrom'，…“epochtime”、“时代”、“2000-01-01”、“TicksPerSecond”,1000年)

名称-值对实参

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

例子:“格式”，“eeee MMMM d, y”，“时区”，“本地”将显示格式应用到datetime值并指定本地时区。

`“格式”`- - - - - -显示格式
`“默认”`|`“preserveinput”`|特征向量|字符串标量

输出数组中值的显示格式，指定为由逗号分隔的对组成“格式”和以下值之一。

的价值`格式`	描述
`“默认”`	使用默认的显示格式。
`“preserveinput”`	使用输入格式指定的格式，`infmt`．如果您没有指定`infmt`,然后`datetime`自动确定格式。
字符向量或字符串标量	使用使用字符向量或字符串标量指定的格式。

如果指定了自己的格式，则必须使用有效的字母标识符。有关有效字母标识符的完整列表，请参见格式财产。

出厂默认格式取决于您的系统区域设置。若要更改默认显示格式，请参见默认datetime格式．

如果您指定DateStrings输入，但不指定“InputFormat”参数,那么datetime尝试使用格式要解释的价值DateStrings．

例子:'格式'，'eeee, MMMM d, yyyy HH:mm:ss'显示日期和时间，例如2014年4月9日星期三21:41:06．

数据类型:字符|字符串

`“场所”`- - - - - -语言环境的`DateStrings`
特征向量|字符串标量

语言环境的DateStrings输入参数值，指定为由逗号分隔的对组成“场所”和字符向量或字符串标量。的语言环境价值决定如何datetime解释DateStrings．但是，它并不决定如何输出datetime值显示。

的语言环境取值为:

“系统”，以指定系统区域设置。
窗体中的字符向量或字符串标量xx＿YY,在那里xx是一个小写的ISO 639-1两个字母的代码，指定一种语言，和YY是一个大写的ISO 3166-1 alpha-2代码，用于指定国家。

该表列出了区域设置的一些常用值。

语言环境	语言	国家
`“de_DE”`	德国	德国
`“en_GB”`	英语	联合王国
`“en_US”`	英语	美国
`“es_ES”`	西班牙语	西班牙
`“fr_FR”`	法国	法国
`“it_IT”`	意大利	意大利
`“ja_JP”`	日本	日本
`“ko_KR”`	朝鲜文	韩国
`“设置nl_NL”`	荷兰	荷兰
`“zh_CN”`	中文(简体)	中国

您可以使用“场所”名称-值对DateStrings输入参数。

例子:“语言环境”、“de_DE”

请注意

的语言环境Value决定如何解释输入文本值。类指定的语言显示输出日期时间值语言环境选项中的Datetime格式部分的Preferences窗口。

若要更改用于显示的默认datetime区域设置，请参见设置命令窗口参数．
要将日期时间值转换为使用不同区域设置的文本，请使用字符，cellstr,或字符串功能。

数据类型:字符|字符串

`“PivotYear”`- - - - - -100年日期范围的开始年份
`(datetime('现在'))-50`(默认)|整数

两个字符年份所在的100年日期范围的开始年份，指定为逗号分隔的对，由“PivotYear”一个整数。使用枢轴年解释将年份指定为两个字符的日期。也就是说，只有当infmt参数包括y或yy．

您可以使用“PivotYear”名称-值对DateStrings输入参数。

例子:“PivotYear”,1900年

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

`“时区”`- - - - - -时区
`”`(默认)|特征向量|字符串标量

时区，指定为逗号分隔的对，由“时区”和指定时区的字符向量或字符串标量。

的datetime函数使用的值“时区”来解释输入数据并设置时区属性。如果输入数据是包含时区的字符向量或字符串，则datetime函数将所有值转换为指定的时区。

有关更多信息和时区列表，请参见时区财产。

数据类型:字符|字符串

属性

全部展开

`格式`- - - - - -显示格式
`“默认”`|特征向量|字符串标量

显示格式，指定为“默认”、字符向量或字符串标量。

的价值`格式`	描述
`“默认”`	使用默认的显示格式。
字符向量或字符串标量	使用使用字符向量或字符串标量指定的格式。

如果指定自己的格式，则必须使用与Unicode对应的有效字母标识符^®区域数据标记语言(LDML)日期和时间的标准。

例子:'eeee, MMMM d, yyyy HH:mm:ss'显示日期和时间，例如2014年4月9日星期三21:41:06．

要分隔字段，可以包括非字母字符，如连字符、空格、冒号或任何非ascii字符。要包括字母无所不包的而且无所不包的作为格式中的文字字符，请将它们括在单引号中。

例子:“uuuu-MM-dd“T”HH: mm: ss”显示日期和时间，例如2014 - 04 - 09 - t21:41:06．

请注意

字母标识符datetime属性所使用的标识符不同datestr，datenum,datevec功能。

出厂默认格式取决于您的系统区域设置。若要更改默认显示格式，请参见默认datetime格式．

常用格式示例

该表列出了常用的显示格式。示例显示了日期的格式化输出，星期三，April 9, 2014，在纽约市的9:41:06.12345 PM。

的价值`格式`	例子
`“yyyy-MM-dd”`	`2014-04-09`
`“dd / MM / yyyy”`	`09/04/2014`
`“dd.MM.yyyy”`	`09.04.2014`
`'yyyy年MM月dd日'`	`2014年 04月 09日`(日语地区的字符，`ja_JP`）
`'MMMM d, yyyy'`	`2014年4月9日`
`'eeee, MMMM d, yyyy h:mm a'`	`2014年4月9日，星期三，晚上9:41`
`'MMMM d, yyyy HH:mm:ss Z'`	`2014年4月9日21:41:06 -0400`
`“yyyy-MM-dd“T”HH: mmXXX`	`2014 - 04 - 09 - t21:41内`
`“yyyy-MM-dd HH: mm: ss。瑞士的`	`2014-04-09 21:41:06.123`

所有日期和时间格式

使用这些标识符指定日期和时间字段的显示格式。显示格式显示日期，星期三，2014年4月9日，晚上9:41:06.12345，在纽约市的输出。

字母标识符	描述	显示
`G`	时代	`CE`
`y`	年，没有前导零。请参阅本表后面的说明。	`2014`
`yy`	年份，用最后两位数字。请参阅本表后面的说明。	`14`
`多`，`yyyy`.．.	年，至少使用实例数指定的位数`“y”`	2014年，`“多”`显示`2014`,而`“yyyyy”`显示`02014`．
`u`，`uu`,……	ISO。年份:表示年份的单个数字ISO年值为CE年赋正值，为BCE年赋负值，1 BCE为0年。	`2014`
`问`	四分之一，用一个数字	`2`
`QQ`	四分之一，用两位数字	`02`
`回调`	季度,缩写	`第二季`
`QQQQ`	Quarter全称	`第二季度`
`米`	月份，数字使用一个或两个数字	`4`
`毫米`	月份，用两位数字表示	`04`
`嗯`	月，缩写	`4月`
`嗯`	月份，全名	`4月`
`嗯`	月，大写的第一个字母	`一个`
`W`	用一个数字表示每月第几周	`2`
`d`	一个月中的一天，用一个或两个数字表示	`9`
`dd`	用两位数字表示的月中的一天	`09`
`D`	一年中的一天，用1、2或3位数字表示	`99`
`DD`	用两位数表示的日期	`99`
`DDD`	用三位数表示的日期	`099`
`e`	星期几(数字，使用一个或两个数字)	`4`在美国，星期天是一周的第一天。
`ee`	星期几(数字，用两位数字)	`04`
`eee`	日，缩写	`结婚`
`eeee`	日，全称	`周三`
`eeeee`	Day，大写的第一个字母	`W`
`一个`	日间时段(上午或下午)	`点`
`h`	小时，用一个或两个数字表示12小时	`9`
`hh`	小时，用两个数字表示12小时	`09`
`H`	小时，用一个或两个数字表示24小时时钟	`21`
`HH`	小时，用两个数字表示24小时的时钟	`21`
`米`	分钟，用一个或两个数字	`41`
`毫米`	分钟，用两个数字	`41`
`年代`	第二，使用一个或两个数字	`6`
`党卫军`	第二，使用两位数字	`06`
`年代`，`党卫军`、……`SSSSSSSSS`	的实例数指定的小数秒`“年代”`(最多9位数字)。	`“SSS”`将6.12345秒截断为`6.123`．

请注意

如果读取两位数的年份，并指定格式为y或yy，则枢轴年决定该年所属的世纪。
如果读取一个日期数字并指定一个格式，该格式包含日期和日期的标识符(D)及公历年(y),然后datetime可能没读对日期。使用ISO年份(u)代替y．
使用一个或多个u字符而不是y使用接近零的年份数字时表示年份的字符。
在CE 144683年之后或b140743年之前的Datetime值只显示年份，无论指定的年份如何格式价值。

时区偏移格式

使用这些标识符指定时区偏移的显示格式。时区偏移量是特定datetime从UTC偏移的时间量。时区具有确定时区偏移量的规则，并且偏移量在一年中的不同时间可能不同。当您希望确保时间组件清晰地显示时，请在datetime数组的显示格式中包含时区偏移标识符。

字母标识符	描述	显示
`z`	时区偏移量的缩写。如果此值不可用，则时区偏移量使用短UTC格式，例如`UTC-4`．	`美国东部时间`
`Z`	具有小时、分钟和可选秒字段的ISO 8601基本格式。	`-0400年`
`睡眠`	长UTC格式。	`UTC-04:00`
`ZZZZZ`	ISO 8601扩展格式，具有小时、分钟和可选的秒字段。当时间偏移量为0时，显示为ISO 8601 UTC指示器“Z”。	`内`
`x`或`X`	ISO 8601基本格式，小时字段和可选的分钟字段。如果你指定`X`，则显示为0的时间偏移量为ISO 8601 UTC指示器“Z”。	`-04年`
`xx`或`XX`	带小时和分钟字段的ISO 8601基本格式。如果你指定`XX`，则显示为0的时间偏移量为ISO 8601 UTC指示器“Z”。	`-0400年`
`xxx`或`XXX`	带小时和分钟字段的ISO 8601扩展格式。如果你指定`XXX`，则显示为0的时间偏移量为ISO 8601 UTC指示器“Z”。	`内`
`xxxx`或`XXXX`	具有小时、分钟和可选秒字段的ISO 8601基本格式。如果你指定`XXXX`，则显示为0的时间偏移量为ISO 8601 UTC指示器“Z”。	`-0400年`
`xxxxx`或`XXXXX`	ISO 8601扩展格式，具有小时、分钟和可选的秒字段。如果你指定`XXXXX`，则显示为0的时间偏移量为ISO 8601 UTC指示器“Z”。	`内`

`时区`- - - - - -时区
`”`(默认)|特征向量|字符串标量

时区，指定为字符向量或字符串标量。创建了datetime数组中。

若要设置时区并计算时区偏移量，请使用datetime数据类型使用互联网数字分配机构(IANA)提供的代码和数据IANA时区数据库．当前使用的版本datetime包括IANA的最新更新。获取所使用的版本datetime的第二个输出时区函数)。

的价值时区可以是:

”，以创建一个“unzoned”datetime不属于特定时区的。
IANA时区数据库中时区区域的名称;例如,“美国/ Los_Angeles”．时区区域的名称说明了在地理区域中观察到的UTC标准偏移和夏令时偏移的当前和历史规则。
格式的ISO 8601字符向量+ HH: mm或hh: mm；例如,' + 01:00 '，以指定与UTC的固定偏移量的时区。
UTC的，以创建datetime通用协调时间数组。
“UTCLeapSeconds”，以创建datetime表示闰秒的通用协调时间数组。控件支持的闰秒列表万博1manbetxdatetime数据类型，请参见leapseconds．
“本地”，以创建datetime数组在系统时区。查询时区属性，返回IANA值。

该表列出了IANA时区数据库中一些常用的时区区域名称。

的价值`时区`	UTC抵消	UTC夏令时偏移量
`“非洲/约翰内斯堡”`	+ 02:00	+ 02:00
`“美国/芝加哥”`	−06:00时	−凌晨5
`美国/丹佛的`	−07:00	−06:00时
`“美国/ Los_Angeles”`	−喂饲	−07:00
`“美国/ New_York”`	−凌晨5	−内
`“美国/ Sao_Paulo”`	−03:00	−02:00
`“亚洲/ Hong_Kong”`	+喂饲	+喂饲
`“亚洲/加尔各答”`	+ 05:30	+ 05:30
`“亚洲/东京”`	上午9点+	上午9点+
`“澳大利亚/悉尼”`	+ 10点	+ 11点
`“欧洲/伦敦”`	+ 00:00	+ 01:00
`“欧洲/苏黎世”`	+ 01:00	+ 02:00

数据类型:字符|字符串

`一年`- - - - - -年数量
数字数组

中每个值的年号datetime对象的大小和形状相同的数字数组datetime数组中。每个年份都是基于ISO日历的整数值。当前时代的年份为正，前一个时代的年份为零或负。例如，公元前1年的年份为0。

如果你设置一年财产以非闰年为一datetime值发生在闰日(2月29日)，则一天而且月3月1日。

`月`- - - - - -月数
数字数组

中每个值的月份号datetime对象的大小和形状相同的数字数组datetime数组中。每个月为1 ~ 12之间的整数。如果将值设置在该范围之外，则一年财产相应地调整，并月属性保持在1到12的范围内。例如，0月对应前一年的12月。对于历史日期，月份数字基于未来的公历。

`一天`- - - - - -月的日期数
数字数组

中的每个值的月日号datetime对象的大小和形状相同的数字数组datetime数组中。根据月份和年份的不同，每个日的数字都是1 ~ 28、29、30或31之间的整数值。如果将值设置在该范围之外，则月而且一年属性相应地进行调整，并且一天物业保持在适当的范围内。例如，day 0对应上个月的最后一天。对于历史日期，日数基于未来的公历。

`小时`- - - - - -小时数
数字数组

中各值的小时数datetime对象的大小和形状相同的数字数组datetime数组中。每个小时的取值范围为0 ~ 23之间的整数。如果将值设置在该范围之外，则一天，月,一年属性相应地进行调整，并且小时物业保持在适当的范围内。例如，hour -1对应前一天的第23小时。

这些条件适用于遵循夏时制的特定时区的datetime数组:

属性指定值时小时属性的值，该属性将在夏令时开始时的小时间隔中创建不存在的datetime小时属性调整到下一个小时。
属性指定值时小时属性，该属性将在夏令时结束时的小时重叠部分创建模糊的datetime，则datetime将调整为与该小时重叠的两个时间中的第二个时间(标准时间)。

`一分钟`- - - - - -分钟数
数字数组

中每个值的分钟数datetime对象的大小和形状相同的数字数组datetime数组中。每一分钟为0 ~ 59之间的整数。如果指定的值超出该范围，则小时，一天，月,一年属性相应地进行调整，并且一分钟物业保持在适当的范围内。例如，分钟-1对应前一小时的59分钟。

`第二个`- - - - - -第二个数字
数字数组

中的每个值的第二个数字datetime对象的大小和形状相同的数字数组datetime数组中。每个秒值都是一个浮点值，通常范围从0到小于60。如果将值设置在该范围之外，则一分钟，小时，一天，月,一年属性相应地进行调整，并且第二个物业保持在适当的范围内。例如，秒-1对应前一分钟的秒59。

一个datetime数组。时区的价值“UTCLeapSeconds”秒的范围从0到小于61。60到61之间的值表示在闰秒内发生的日期时间。控件支持的闰秒列表万博1manbetxdatetime数据类型，请参见leapseconds．）

`SystemTimeZone`- - - - - -系统时区设置
特征向量|字符串标量

此属性是只读的。

系统时区设置，指定为字符向量或字符串标量。该系统由MATLAB编写^®是否运行决定此时区设置。

例子:美国/ New_York

例子

全部折叠

特定时区的当前日期和时间

打开实时脚本

指定本地系统时区的当前日期和时间。

T =日期时间(“现在”，“时区”，“本地”，“格式”，'d-MMM-y HH:mm:ss Z'）

t =datetime2021年2月23日14:56:26 -0500

在韩国首尔所代表的时区中指定当前日期和时间

T =日期时间(“现在”，“时区”，“亚洲/首尔”，“格式”，'d-MMM-y HH:mm:ss Z'）

t =datetime24-Feb-2021 04:56:27 +0900

来自字符向量的日期和时间

打开实时脚本

创建一个datetime字符向量的单元格数组中的数组。

DateStrings = {“2014-05-26”；“2014-08-03”};t = datetime(DateStrings，“InputFormat”，“yyyy-MM-dd”）

t =2 x1 datetime26日- 2014年5月- 03 - 8月- 2014年

中的datetime值t使用默认格式显示，而不是输入日期的格式。

字符串数组中的日期和时间

打开实时脚本

方法创建字符串数组，从R2016b开始字符串函数并将它们转换为datetime值。

STR = [“2016-03-24”，“2016-04-19”］

str =1 x2字符串“2016-03-24”“2016-04-19”

转换字符串，指定输入格式为yyyy-MM-dd．格式必须指定为字符向量，即使str是一个字符串数组。

T = datetime(str，“InputFormat”，“yyyy-MM-dd”）

t =1 x2 datetime24 - 3月19日——2016年4月- 2016

来自文本表示小数秒的时间

打开实时脚本

创建一个datetime值，该值表示精确到毫秒的日期和时间。将文本转换为控件所要求的格式datetime函数如果没有更多信息就无法解析，请指定“InputFormat”名称-值对参数。

d =“2018-06-25 11:23:37.712”；T = datetime(d，“InputFormat”，“yyyy-MM-dd HH: mm: ss。瑞士的）

t =datetime25 - 2018年6月——11:23:37

这种转换确实保留了小数秒。但是，默认情况下datetime数组则不然显示分数秒。要显示它们，请指定“格式”名称-值对或格式财产。

t.Format ='MMM dd, yyyy HH:mm:ss。瑞士的

t =datetime2018年6月25日11:23:37.712

的“InputFormat”参数仅适用于从输入文本的转换。的格式属性指定任何的显示datetime数组中。

日期和时间从文本与文字字符

打开实时脚本

将ISO 8601格式的日期转换为日期时间值。

创建包含ISO 8601格式日期的字符向量单元格数组。在这种格式中，使用字母T作为分隔符，分隔日期和时间。每个字符向量都包含一个时区偏移。字母Z表示与UTC时间没有偏移。

DateStrings = {2014 - 05 - 26 - t13:30凌晨”；2014 - 08 - 26 - t13:30内的；2014 - 09 - 26 t13:30z｝

DateStrings =3 x1细胞{2014 - 05 - 26 - t13:30凌晨'}{' 2014 - 08 - 26 - t13:30内}{' 2014 - 09 - 26 t13:30z '}

将字符向量转换为日期时间值。在指定输入格式时，将字母T括在单引号中，以表明它是一个字面字符。属性指定输出datetime数组的时区时区名称-值对参数。

t = datetime(DateStrings，“InputFormat”，“uuuu-MM-dd“T”HH: mmXXX，“时区”，UTC的）

t =3 x1 datetime2014年5月26日18:30:00 2014年8月26日17:30:00 9月26日13:30:00

中的datetime值t以默认格式显示。

来自外语文本的日期和时间

打开实时脚本

创建包含法文日期的字符向量的单元格数组。

C = {《8 avril 2013》，“9 mai 2013”；“2014年10月”，《2014年11月朱丽叶》｝

C =2 x2细胞{'8 avril 2013'} {'9 mai 2013'} {'10 juin 2014'} {'11 juillet 2014'}

将字符向量转换为C到datetime值。如果将计算机设置为使用英语的区域设置，则必须指定“场所”参数，以指示字符串是法语。

t = datetime(C，“InputFormat”，'d MMMM yyyy'，“场所”，“fr_FR”）

t =2 x2 datetime2013年5月09日2014年6月10日2014年7月11日

中的datetime值t以默认格式和MATLAB使用的语言显示，具体取决于系统区域设置。

来自向量的日期和时间

打开实时脚本

创建一个datetime从年、月和日值的单个数组中获取数组。

创建年值Y和日值d的示例数字数组。在本例中，月值M是一个标量。

Y = [2014;2013;2012];M = 01;D = [31;30;31];

创建datetime数组中。

t = date (Y,M,D)

t =3 x1 datetime2014年1月31日-2013年1月30日-2012年1月31日

属性为输出指定自定义显示格式格式名称-值对参数。

t = datetime(Y,M,D，“格式”，“eeee, MMMM d, y”）

t =3 x1 datetime2014年1月31日星期五2013年1月30日星期三2012年1月31日星期二

转换Excel日期号码为日期时间

打开实时脚本

创建一个Excel®日期数字示例数组，表示自1900年1月0日以来的天数。

X = [39558, 39600;39700年,39800年)

X =2×239558 39600 39700 39800

中的值转换为X到datetime值。

t = datetime(X，“ConvertFrom”，“超越”）

t =2 x2 datetime2008年4月20日-2008年01月-2008年09月-2008年12月18日

提示

有关datetime功能,请参阅日期和时间．
获取接受的核心MATLAB函数列表datetime数组作为输入参数，请参见支持日期和时间数组的核心功能万博1manbetx．

兼容性的考虑

全部展开

`“InputFormat”`月格式`米`而且`毫米`不认识名字，还有`嗯`不认识完整的月份名称

R2020a的行为发生了变化

类型中指定月份格式时，从R2020a开始“InputFormat”名称-值对参数米而且毫米格式不识别月份名称。此外,嗯格式只能识别缩写名称，不能识别完整的月份名称。在以前的版本中，所有这些格式都可以同时识别缩略月名和完整月名。

有关格式的更多信息，请参见格式财产。

扩展功能

高大的数组
使用行数超过内存容量的数组进行计算。

使用注意事项和限制:

在为单元格数组中的字符串数组或字符向量创建高日期时间数组时，始终指定输入日期时间格式。
如果你指定“格式”作为“preserveinput”，则MATLAB可能需要计算tall数组以确定格式。

有关更多信息，请参见高大的数组．

C/ c++代码生成
使用MATLAB®Coder™生成C和c++代码。

使用注意事项和限制:

从R2020a开始，您可以使用datetime数组在MATLAB代码中用于代码生成。有关更多信息，请参见日期时间数组的代码生成(MATLAB编码器)而且代码生成的日期时间数组限制(MATLAB编码器)．

分布式阵列
使用并行计算工具箱™跨集群的组合内存对大型数组进行分区。

使用注意事项和限制:

当你创建datetime数组中的文本DateStrings，指定输入格式infmt．

有关更多信息，请参见运行MATLAB函数与分布式阵列(并行计算工具箱)．

另请参阅

calendarDuration|cellstr|字符|持续时间|leapseconds|NaT|字符串|时区

主题

在R2014b中引入

datetime

描述

创建

语法

描述

输入参数

relativeDay- - - - - -相对于当前日期的日期“昨天”|“今天”|“明天”|“现在”

DateStrings- - - - - -表示日期和时间的文本字符数组|字符向量的单元格数组|字符串数组

infmt- - - - - -输入文本的格式特征向量|字符串标量

DateVectors- - - - - -日期向量矩阵

Y、M, D- - - - - -年、月和日数组数字数组

Y、M D H MI S- - - - - -年、月、日、小时、分钟和秒数组数字数组

Y、M D H MI,年代,女士- - - - - -年、月、日、小时、分钟、秒和毫秒数组数字数组

X- - - - - -数值数组

dateType- - - - - -中值的类型X“datenum”|“超越”|“excel1904”|“juliandate”|……

“格式”- - - - - -显示格式“默认”|“preserveinput”|特征向量|字符串标量

“场所”- - - - - -语言环境的DateStrings特征向量|字符串标量

“PivotYear”- - - - - -100年日期范围的开始年份(datetime('现在'))-50(默认)|整数

“时区”- - - - - -时区”(默认)|特征向量|字符串标量

属性

格式- - - - - -显示格式“默认”|特征向量|字符串标量

常用格式示例

所有日期和时间格式

时区偏移格式

时区- - - - - -时区”(默认)|特征向量|字符串标量

一年- - - - - -年数量数字数组

月- - - - - -月数数字数组

一天- - - - - -月的日期数数字数组

小时- - - - - -小时数数字数组

一分钟- - - - - -分钟数数字数组

第二个- - - - - -第二个数字数字数组

SystemTimeZone- - - - - -系统时区设置特征向量|字符串标量

例子

特定时区的当前日期和时间

来自字符向量的日期和时间

字符串数组中的日期和时间

来自文本表示小数秒的时间

日期和时间从文本与文字字符

来自外语文本的日期和时间

来自向量的日期和时间

转换Excel日期号码为日期时间

提示

兼容性的考虑

“InputFormat”月格式米而且毫米不认识名字，还有嗯不认识完整的月份名称

扩展功能

高大的数组使用行数超过内存容量的数组进行计算。

C/ c++代码生成使用MATLAB®Coder™生成C和c++代码。

分布式阵列使用并行计算工具箱™跨集群的组合内存对大型数组进行分区。

另请参阅

主题

MATLAB的文档

万博1manbetx

用MATLAB介绍深度学习

`relativeDay`- - - - - -相对于当前日期的日期
`“昨天”`|`“今天”`|`“明天”`|`“现在”`

`DateStrings`- - - - - -表示日期和时间的文本
字符数组|字符向量的单元格数组|字符串数组

`infmt`- - - - - -输入文本的格式
特征向量|字符串标量

`DateVectors`- - - - - -日期向量
矩阵

`Y、M, D`- - - - - -年、月和日数组
数字数组

`Y、M D H MI S`- - - - - -年、月、日、小时、分钟和秒数组
数字数组

`Y、M D H MI,年代,女士`- - - - - -年、月、日、小时、分钟、秒和毫秒数组
数字数组

`X`- - - - - -数值
数组

`dateType`- - - - - -中值的类型`X`
`“datenum”`|`“超越”`|`“excel1904”`|`“juliandate”`|……

`“格式”`- - - - - -显示格式
`“默认”`|`“preserveinput”`|特征向量|字符串标量

`“场所”`- - - - - -语言环境的`DateStrings`
特征向量|字符串标量

`“PivotYear”`- - - - - -100年日期范围的开始年份
`(datetime('现在'))-50`(默认)|整数

`“时区”`- - - - - -时区
`”`(默认)|特征向量|字符串标量

`格式`- - - - - -显示格式
`“默认”`|特征向量|字符串标量

`时区`- - - - - -时区
`”`(默认)|特征向量|字符串标量

`一年`- - - - - -年数量
数字数组

`月`- - - - - -月数
数字数组

`一天`- - - - - -月的日期数
数字数组

`小时`- - - - - -小时数
数字数组

`一分钟`- - - - - -分钟数
数字数组

`第二个`- - - - - -第二个数字
数字数组

`SystemTimeZone`- - - - - -系统时区设置
特征向量|字符串标量

`“InputFormat”`月格式`米`而且`毫米`不认识名字，还有`嗯`不认识完整的月份名称

高大的数组
使用行数超过内存容量的数组进行计算。

C/ c++代码生成
使用MATLAB®Coder™生成C和c++代码。

分布式阵列
使用并行计算工具箱™跨集群的组合内存对大型数组进行分区。