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 (DateVectors)

t = datetime (Y, M, D)

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

t = datetime (Y、M D H MI,年代,MS)

t = datetime (X, ConvertFrom, dateType)

t = datetime (＿＿＿、名称、值)

描述

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

例子

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

t= datetime (DateStrings）从文本中创建一个datetime值数组DateStrings表示时间点。

例子

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

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

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

例子

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

t= datetime (Y、M, D）属性的对应元素创建一个datetime值数组Y，米,D(year, month, day)数组。数组必须具有相同的大小(或者any可以是标量)。您还可以将输入参数指定为日期向量，[Y M D]．

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

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

例子

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

如果X包含POSIX^®times或表示本地时间的Julian日期，然后指定适当的时区t使用“时区”名称-值对的论点。如果没有指定时区，则POSIX时间或Julian日期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`）
`“嗯d, yyyy”`	`2014年4月19日`
`'eee, MMMM d, yyyy h:mm a'`	`2014年4月19日，星期六，晚上9:41`
`' mm 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最多9个年代用来表示小数位数的第二个数字的字符。例如,“yyyy-MM-dd HH: mm: ss。瑞士的是一种文本格式，表示精确到毫秒的日期和时间。

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

请注意

字母标识datetime对象使用的标识符不同datestr，datenum,datevec功能。

数据类型:字符|字符串

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

日期向量，指定为米6或米3矩阵包含米全部或部分日期向量，分别。完整的日期向量有6个元素，依次指定年、月、日、时、分和秒。部分日期向量有三个元素，依次指定年、月和日。的每个元素DateVector应该是正的或负的整数值，除了秒元素，它可以是小数。如果一个元素超出了常规范围，datetime调整日期向量元素和前一个元素。例如，如果minutes元素是70,然后datetime调整小时元素1并将分钟元素设置为10．如果minutes元素为-15,然后datetime减少小时元素1并将分钟元素设置为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”`	从0- 1 -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”`	从UTC 24- 11月24日中午到公元前4714年(预期公历)的天数。如果你把`X`到一个`datetime`数组而不指定时区，则`datetime`值表示UTC时间，而不是本地时间。要表示本地时间，请使用`“时区”`名称-值对的论点。例子:转换`X`使用纽约的时区 T = datetime (X,‘ConvertFrom’,‘juliandate’,……“时区”、“美国/ New_York”) 然后，您可以转换`T`一个unzoned`datetime`数组通过赋值空字符向量表示局部时间`时区`． T.TimeZone = "
`“modifiedjuliandate”`	UTC 17- 11月1858年午夜以来的天数。如果你把`X`到一个`datetime`数组而不指定时区，则`datetime`值表示UTC时间，而不是本地时间。要表示本地时间，请使用`“时区”`名称-值对的论点。例子:转换`X`使用纽约的时区 T = datetime (X,‘ConvertFrom’,‘modifiedjuliandate’,……“时区”、“美国/ New_York”) 然后，您可以转换`T`一个unzoned`datetime`数组通过赋值空字符向量表示局部时间`时区`． T.TimeZone = "
`“posixtime”`	从UTC时间1-Jan-1970 00:00:00开始的秒数，不包括闰秒。如果你把`X`到一个`datetime`数组而不指定时区，则`datetime`值表示UTC时间，而不是本地时间。要表示本地时间，请使用`“时区”`名称-值对的论点。例子:转换`X`使用纽约的时区 T = datetime (X,‘ConvertFrom’,‘posixtime’,……“时区”、“美国/ New_York”) 然后，您可以转换`T`一个unzoned`datetime`数组通过赋值空字符向量表示局部时间`时区`． T.TimeZone = "
`“名称”`	日期为YYYYMMDD数值。例如,`20140402`代表2014年4月2日。
`国家结核控制规划的`	自UTC时间1-Jan-1900 00:00:00以来的“时钟滴答数”，其中每个时钟滴答是2^-32秒。
`“net”`	自1-Jan-0001 00:00:00 UTC以来的“时钟滴答”的数量，其中每个时钟滴答是100纳秒。
`“ntfs”`	自UTC时间1-Jan-1601 00:00:00以来的“时钟滴答数”，其中每个时钟滴答数为100纳秒。
`“epochtime”、“时代”,epochValue`	从纪元开始的秒数。您还必须指定`epochValue`它是一个标量`datetime`，或表示历元时间的字符向量或字符串标量。例子:转换`X`以2000年1月1日的午夜为纪元。 T = datetime (X,‘ConvertFrom’,……“epochtime”、“时代”,“2000-01-01”)
`“epochtime”、“时代”,epochValue“TicksPerSecond”,n`	一个纪元以来“时钟滴答”的次数。除了指定`epochValue`，您也可以指定`n`，它是一个标量整数，指定每秒的“时钟滴答数”。例子:转换`X`以2000年1月1日的午夜为纪元。这个转换解释中的值`X`因为它被指定为每秒有1000个“时钟滴答”。 T = datetime (X,‘ConvertFrom’,……“epochtime”、“时代”、“2000-01-01”、“TicksPerSecond”,1000年)

名称-值对的观点

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

例子:'Format'，'eeee MMMM d, y'，'TimeZone'，'local'将显示格式应用于datetime值并指定本地时区。

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

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

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

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

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

如果你指定DateStrings输入，但不指定“InputFormat”参数,那么datetime试图使用格式价值解读DateStrings．

例子:'Format'，'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”

请注意

的语言环境值决定如何解释输入文本值。属性指定的语言总是显示输出的datetime值语言环境选项Datetime格式部分。

要更改默认datetime区域设置以供显示，请参见设置命令窗口首选项．
要使用不同的区域设置将datetime值转换为文本，请使用字符，cellstr,或字符串功能。

数据类型:字符|字符串

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

两个字符年份所在的100年日期范围的开始年份，指定为逗号分隔的对，由“PivotYear”和一个整数。使用pivot year来解释将年份指定为两个字符的日期。也就是说，支点年只有在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格式．

常用格式示例

该表列出了常用的显示格式。示例显示日期(2014年4月9日，星期三，晚上9:41:06.12345)的格式化输出。

的价值`格式`	例子
`“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`）
`“嗯d, yyyy”`	`2014年4月9日`
`'eee, MMMM d, yyyy h:mm a'`	`2014年4月9日，星期三，晚上9:41`
`' mm 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`	季度,全名	`第二季度`
`米`	月，用一或两位数字表示	`4`
`毫米`	月，用两位数表示	`04`
`嗯`	月,缩写的名字	`4月`
`嗯`	月,全名	`4月`
`嗯`	月，首字母大写	`一个`
`W`	每个月的第几周，用一个数字	`2`
`d`	一个月的一天，用一或两位数	`9`
`dd`	用两位数字表示	`09`
`D`	一年中的一天，用一、二或三位数表示	`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可能无法正确读取年月日的数字。使用国际标准化组织年份(u代替y．
使用一个或多个u字符,而不是y当处理接近零的年份时，用字符表示年份。
日期时间值在公元144683年之后或在公元前140743年之前只显示年份，不管指定的年份是多少格式价值。

时区偏移格式

使用这些标识符指定时区偏移的显示格式。时区偏移量是特定日期时间与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`，则时间偏移量为零显示为ISO 8601 UTC指示器“Z”。	`-04年`
`xx`或`XX`	ISO 8601基本格式，带有小时和分钟字段。如果您指定`XX`，则时间偏移量为零显示为ISO 8601 UTC指示器“Z”。	`-0400年`
`xxx`或`XXX`	ISO 8601扩展格式，带有小时和分钟字段。如果您指定`XXX`，则时间偏移量为零显示为ISO 8601 UTC指示器“Z”。	`内`
`xxxx`或`XXXX`	ISO 8601基本格式，包含小时、分钟和可选的秒字段。如果您指定`XXXX`，则时间偏移量为零显示为ISO 8601 UTC指示器“Z”。	`-0400年`
`xxxxx`或`XXXXX`	ISO 8601扩展格式，带有小时、分钟和可选的秒字段。如果您指定`XXXXX`，则时间偏移量为零显示为ISO 8601 UTC指示器“Z”。	`内`

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

时区，指定为字符向量或字符串标量。创建时区后，可以使用此属性更改时区datetime数组中。

当需要设置时区和计算时区偏移量时，使用datetime数据类型使用Internet Assigned Numbers Authority (IANA)提供的代码和数据IANA时区数据库．当前使用的版本datetime包括IANA的最新更新。(获取由datetime的第二个输出时区函数)。

的价值时区可以是:

＇＇，创建一个“未分区”datetime不属于特定时区的数组。
IANA时区数据库中时区区域的名称;例如,“美国/ Los_Angeles”．时区区域的名称说明了在一个地理区域中观察到的与UTC的标准和日光偏移量的当前和历史规则。
格式的ISO 8601字符向量+ HH: mm或hh: mm；例如,' + 01:00 '，以指定一个与UTC有固定偏移量的时区。
UTC的，创建一个datetime通用协调时间数组。
“UTCLeapSeconds”，创建一个datetime用于计算闰秒的通用协调时间数组。的支持的闰秒列表金宝appdatetime数据类型,看到leapseconds．
“本地”，创建一个datetime系统时区的阵列。当您查询时区属性时，返回IANA值。

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

的价值`时区`	UTC抵消	UTC DST抵消
`“非洲/约翰内斯堡”`	+ 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，具体取值取决于月份和年份。如果设置的值超出该范围，则月和一年属性会相应地调整一天物业保持在适当的范围内。例如，第0天对应于前一个月的最后一天。对于历史日期，日期是基于预测的公历。

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

中每个值的小时数datetime数组，指定为大小和形状与datetime数组中。每小时的数值为0 ~ 23之间的整数。如果设置的值超出该范围，则一天，月,一年属性会相应地调整小时物业保持在适当的范围内。例如，hour -1对应前一天的第23个小时。

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

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

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

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

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

中每个值的第二个数字datetime数组，指定为大小和形状与datetime数组中。每一秒的值是一个浮点值，通常范围从0到小于60。如果设置的值超出该范围，则一分钟，小时，一天，月,一年属性会相应地调整第二个物业保持在适当的范围内。例如，秒-1对应于前一分钟的秒59。

一个datetime数组和一个时区的价值“UTCLeapSeconds”秒的范围是0到小于61。从60到61的值表示在一个闰秒期间发生的日期时间。的支持的闰秒列表金宝appdatetime数据类型,看到leapseconds．）

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

此属性是只读的。

系统时区设置，指定为字符向量或字符串标量。在MATLAB中^®运行确定此时区设置。

例子:美国/ New_York

例子

全部折叠

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

打开生活的脚本

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

t = datetime (“现在”，“时区”，“本地”，“格式”，“d-MMM-y HH: mm: ss Z”）

t =datetime1 - 9月- 2021年10:20:52 -0400年

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

t = datetime (“现在”，“时区”，“亚洲/首尔”，“格式”，“d-MMM-y HH: mm: ss Z”）

t =datetime2021年1 - 9月- 23:20:53 + 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 datetime26- 5 -2014 18:30:00 26- 8 -2014 17:30:00 26- 9 -2014 13:30:00

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

日期和时间从文本在外语

打开生活的脚本

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

C = {“2013年四月8日”，“麦2013”；“juin 2014”，“2014年juillet 11日”｝

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

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

t = datetime (C,“InputFormat”，“d嗯yyyy”，“场所”，“fr_FR”）

t =2 x2 datetime08- 4 -2013 09- 5 -2013 10- 6 -2014 11- 7 -2014

中的datetime值t显示的默认格式，并使用MATLAB使用的语言，这取决于您的系统区域设置。

日期和时间从向量

打开生活的脚本

创建一个datetime数组来自包含年、月和日值的单个数组。

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

Y = (2014; 2013; 2012);M = 1;D =(31日、30、31);

创建datetime数组中。

t = datetime (Y, M, D)

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

属性指定输出的自定义显示格式格式名称-值对的论点。

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

转换中的值Xdatetime值。

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

t =2 x2 datetime20- 4月2008 01- 6月2008 09- 9月2008 18- 12月

提示

查看datetime功能,请参阅日期和时间．
获取接受的核心MATLAB函数列表datetime数组作为输入参数，请参阅支持日期和时间数组的核心函数金宝app．

兼容性的考虑

全部展开

`“InputFormat”`标识符`e`，`ee`，`米`，`毫米`，`问`,`QQ`不识别名字，而识别`eee`，`嗯`,`回调`不认识全名

行为在R2020a中改变

从R2020a开始，当您为中星期、月或季度指定一个或两个字母标识符时“InputFormat”参数Name-value时，这些标识符不再识别名称。他们只能识别数字。

类似地，周、月和季度缩写名称的三个字母标识符不再识别全名。他们只认得缩写。

该表显示了这些标识符，并举例说明了已识别和未识别的值。

标识符	公认的例子	未识别的例子
`e`	`4`	`结婚` `周三`
`ee`	`04`	`结婚` `周三`
`eee`	`结婚`	`周三`
`米`	`4`	`4月` `4月`
`毫米`	`04`	`4月` `4月`
`嗯`	`4月`	`4月`
`问`	`2`	`第二季` `第二季度`
`QQ`	`02`	`第二季` `第二季度`
`回调`	`第二季`	`第二季度`

在以前的版本中，所有这些一、二和三个字母的标识符分别识别星期、月和季度的缩写和全名。例如,ee公认的结婚周三,毫米公认的4月4月,QQ公认的第二季作为第二季度。同样的,eee公认的周三，嗯公认的4月,回调公认的第二季度．

有关格式标识符的更多信息，请参见格式的属性datetime．

扩展功能

高大的数组
使用具有大于内存容量的行数的数组进行计算。

使用注意事项及限制:

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

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

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

使用注意事项及限制:

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

分布式阵列
使用Parallel Computing Toolbox™在集群的组合内存中对大型数组进行分区。

使用注意事项及限制:

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

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

另请参阅

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

主题

介绍了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”标识符e，ee，米，毫米，问,QQ不识别名字，而识别eee，嗯,回调不认识全名

扩展功能

高大的数组使用具有大于内存容量的行数的数组进行计算。

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

分布式阵列使用Parallel Computing Toolbox™在集群的组合内存中对大型数组进行分区。

另请参阅

主题

MATLAB的文档

金宝app

介绍基于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”`标识符`e`，`ee`，`米`，`毫米`，`问`,`QQ`不识别名字，而识别`eee`，`嗯`,`回调`不认识全名

高大的数组
使用具有大于内存容量的行数的数组进行计算。

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

分布式阵列
使用Parallel Computing Toolbox™在集群的组合内存中对大型数组进行分区。