datetime

数组表示的时间点

扩展所有的页面

描述

的datetime数据类型表示的时间点,如8月24日,2020年,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)创建一个列向量的datetime值向量DateVectors。

t= datetime (Y、M, D)创建一个datetime值对应的元素的数组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`)
`“嗯d, yyyy”`	`2014年4月19日`
`“eeee,嗯,yyyy h:毫米的`	`2014年4月19日,星期六,41点`
`“嗯,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.SSS”`	`2014-04-19 21:41:06.123`

输入文本表示分数秒,您可以指定infmt高达9年代字符显示分数第二位数。例如,“yyyy-MM-dd HH: mm: ss.SSS”是文本表示日期和时间的格式毫秒精度。

有效的字母标识的完整列表,请参阅格式财产datetime数组。

请注意

信中标识符,datetime接受不同于使用的标识符datestr,datenum,datevec功能。

数据类型:字符|字符串

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

日期向量,作为指定米6或米3矩阵包含米全部或部分日期向量,分别。一个完整的日期向量有六个元素,指定年,月,日,小时,分钟,第二,这个顺序。部分日期向量有三个元素,指定一年,月,一天,在秩序。的每个元素DateVector应该是一个积极或消极的整数值除了秒元素,可以分级。如果一个元素不在常规范围内,datetime调整日期向量元素和前一个元素。例如,如果分钟元素70年,然后datetime调整时间元素1并设置分钟元素10。如果分钟元素-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日历)。
`“超越”`	0 - 1月- 1900年以来的天数。 Excel^®日期数字四舍五入为最接近的微秒。注意:Excel错误地认为1900年是一个闰年。因此,当计算Excel日期数字之间有一个额外的一天的不连续2月28日,1900年和1900年3月1日。
`“excel1904”`	0 - 1月- 1904年以来的天数。 Excel日期数字四舍五入为最接近的微秒。注意:Excel错误地认为1900年是一个闰年。因此,当计算Excel日期数字之间有一个额外的一天的不连续2月28日,1900年和1900年3月1日。
`“juliandate”`	天数自中午UTC 24 - 11月公元前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”`	1 - 1月- 1970年以来的秒数)就是UTC,不包括闰秒。如果你把`X`到一个`datetime`数组不指定时区,然后`datetime`价值观代表UTC时间,不是当地的情况。代表当地的时候,指定时区使用`“时区”`名称-值对的论点。例子:转换`X`使用了纽约的时区。 T = datetime (X,‘ConvertFrom’,‘posixtime’,……“时区”、“美国/ New_York”) 然后,您可以转换`T`一个unzoned`datetime`数组代表当地时间通过分配一个空的特征向量`时区`。 T。TimeZone = ''
`“名称”`	日期名称数值。例如,`20140402`代表4月2日,2014年。
`国家结核控制规划的`	的“时钟”,因为1 - 1月- 1900就是UTC,每个时钟周期是2 ^ -32秒。
`“net”`	的“时钟”,因为1 - 1月- 0001就是UTC,每个时钟周期是100 ns。
`“ntfs”`	的“时钟”,因为1 - 1月- 1601就是UTC,每个时钟周期是100 ns。
`“tt2000”`	的纳秒数J2000以来运行。常见的数据格式(CDF)定义了`CDF_TIME_TT2000`(或`TT2000`)数据类型作为一个高分辨率时间类型提供数据文件处理闰秒。有关更多信息,请参见要求提供处理闰秒。输入`X`必须是一个`int64`数组的元素代表了次`TT2000`时代。转换`TT2000`次,电话`datetime`使用`“ConvertFrom”、“tt2000”`和`“时区”、“UTCLeapSeconds”`名称-值参数。的`UTCLeapSeconds`时区是唯一的时区,占闰秒。注意:J2000是2000年1月1日,12点地面时间(TT)。TT与UTC取决于两个因素: 闰秒 TT和原子之间的差异32.184秒的时钟计时因此,J2000实际上发生在中午前64.184秒`UTCLeapSeconds`时区,: D = datetime(58 2000, 1, 1, 11日,55816年,“时区”,“UTCLeapSeconds”) 2000 - 01 - 01 t11:58:55.816z D = 例子:创建一个`int64`数组表示`TT2000`次了。然后将它转换成一个`datetime`数组中。 X = int64 ([702077514184000000;…702163914184000000;…702250314184000000)) X = 3 x1int64列向量702077514184000000 702163914184000000 702077514184000000 D = datetime (X,“ConvertFrom”,“tt2000”,“时区”,“UTCLeapSeconds”) D = 3 x1datetime数组2022 - 04 - 01 t09:30:45.000z 2022 - 04 - 02 - 2022 - 04 - 03年t09:30:45.000z t09:30:45.000z
`“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`2000年1月1日午夜以来的毫秒,因为它指定“时钟嘀嗒”有1000每秒。 T = datetime (X,‘ConvertFrom’,……“epochtime”、“时代”、“2000-01-01”、“TicksPerSecond”, 1000年)

名称-值参数

指定可选的双参数作为Name1 = Value1,…,以=家,在那里的名字参数名称和吗价值相应的价值。名称-值参数必须出现在其他参数,但对的顺序无关紧要。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:“格式”、“eeee嗯d, y ',“时区”,“当地”一种显示格式适用于datetime值和指定本地时区。

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

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

的价值`格式`	描述
`“默认”`	使用默认显示格式。
`“preserveinput”`	使用指定的格式输入格式,`infmt`。如果你不指定`infmt`,然后`datetime`自动确定格式。
特征向量或字符串标量	使用矢量格式您指定一个字符或字符串标量。

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

恢复出厂设置的格式取决于您的系统语言环境。改变默认的显示格式,请参阅默认的datetime格式。

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

例子:“格式”、“eeee,嗯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α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格式Preferences窗口。

改变显示的默认datetime现场,看到的设置命令窗口的偏好。
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)日期和时间的标准。LDML的更多信息,请参阅Unicode技术标准# 35,特别是日期字段符号表。

例子:“eeee,嗯d, yyyy HH: mm: ss”显示日期和时间等周三,2014年4月9日21:41:06。

单独的字段,您可以包括nonletter字符,如一个连字符,空间,冒号,或任何非ascii字符。包括字母无所不包的和无所不包的文字字符的格式,将它们包含在单引号中。

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

请注意

信中标识符,datetime接受不同于使用的标识符datestr,datenum,datevec功能。

恢复出厂设置的格式取决于您的系统语言环境。改变默认的显示格式,请参阅默认的datetime格式。

常见的例子的格式

此表列出了常见的显示格式。的例子显示格式化输出日期,星期三,4月9日2014 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日`
`“eeee,嗯,yyyy h:毫米的`	`周三,2014年4月9日,41点`
`“嗯,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.SSS”`	`2014-04-09 21:41:06.123`

所有的日期和时间格式

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

字母标识符	描述	显示
`G`	时代	`CE`
`y`	年,没有前导零。注意,遵循这一表。	`2014年`
`yy`	一年,使用最后两位数。注意,遵循这一表。	`14`
`多`,`yyyy`…	至少一年,使用数字指定的数量的实例的数量`“y”`	2014年,`“多”`显示`2014年`,而`“yyyyy”`显示`02014年`。
`u`,`uu`,……	ISO。一个数字指定。一个ISO值分配正值CE年和负公元前年,公元前1年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`	天,大写首字母	`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,那么主决定了世纪年所属。
如果你读day-of-year数量和指定的格式包含标识符的一天(D)和格雷戈里(y),然后datetime可能不读day-of-year数量正确。使用ISO (u在的地方y。
使用一个或多个u字符,而不是y字符来表示在处理去年同期数字接近于零。
Datetime值晚于公元前公元144683年或140743年之前只显示数字,无论指定格式价值。

时区偏移格式

使用这些标识符来指定时区偏移量的显示格式。时区偏移量的时间特定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`,则显示为零的时间抵消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数据类型使用代码和数据提供的互联网地址分配机构(IANA)IANA时区数据库。目前使用的版本datetime包括从IANA的最近更新。(使用的版本datetime,返回第二个的输出时区函数)。

的价值时区可以是:

”,创建一个“unzoned”datetime数组不属于一个特定的时区。
这个名字IANA时区的时区地区数据库;例如,“美国/ Los_Angeles”。时区的名称区域占当前和历史的规则标准和日光补偿从UTC观察地理区域。
一个ISO 8601字符的向量形式+ HH: mm或hh: mm;例如,' + 01:00 '指定一个时区,从UTC固定偏移量。
UTC的,创建一个datetime在协调世界时数组。
“UTCLeapSeconds”,创建一个datetime数组在协调世界时占闰秒。为支持的闰秒的列表datetime数据类型,看到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。

如果你设置一年财产nonleap一年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日。如果你设置超出范围的值,那么一天,月,一年属性作出相应调整,小时财产保持在适当的范围内。例如,1对应于小时23日的前一天。

这些条件适用于datetime数组与一个特定的时区,日光节约时间:

当你指定一个值小时属性,将创建一个不存在的datetime小时差距夏时制开始时,的值小时属性调整到下一个小时。
当你指定一个值小时属性,将创建一个模棱两可的datetime小时重叠夏时制结束时,两次的datetime调整到第二个小时(标准时间)。

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

分钟的每个值datetime数组,指定为一个数值数组相同的大小和形状datetime数组中。每分钟数是一个整数值从0到59。如果你指定一个超出范围的值,那么小时,一天,月,一年属性作出相应调整,一分钟财产保持在适当的范围内。例如,每分钟1对应于前小时59分钟。

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

第二个数字的每个值datetime数组,指定为一个数值数组相同的大小和形状datetime数组中。每秒钟值通常是一个浮点值从0到不到60。如果你设置超出范围的值,那么一分钟,小时,一天,月,一年属性作出相应调整,第二个财产保持在适当的范围内。例如,第二个1对应于之前的第二个59分钟。

一个datetime数组和一个时区的价值“UTCLeapSeconds”少于61秒内从0。从60到61的值代表日期时间,发生在一个闰秒。(支持的闰秒的列表datetime数据类型,看到leapseconds。)

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

这个属性是只读的。

系统时区设置,指定为一个特征向量或字符串标量。系统在MATLAB^®正在确定这个时区设置。

例子:美国/ New_York

例子

全部折叠

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

打开生活的脚本

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

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

t =datetime31日- 8月- 2022 03:31:42 -0400

指定当前时区的日期和时间由首尔,韩国。

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

t =datetime31日- 8月- 2022 16:31:42 + 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.SSS”)

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

转换并保持分数秒。然而,默认情况下datetime数组不显示分数秒。显示指定的“格式”名称-值对或格式财产。

t。格式=“嗯dd, yyyy HH: mm: ss.SSS”

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

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

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

打开生活的脚本

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

创建一个单元阵列特征向量包含日期的ISO 8601格式。在这种格式中,字母T是用作分隔符分隔一个日期和时间。每个字符向量包含一个时区偏移量。这封信从UTC Z表示没有抵消。

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日—2014年5月——18:30:00 9月26日- 8月- 2014 17:30:00 26 - 2014 13:30:00

datetime值t在默认显示格式。

日期和时间在外语文本

打开生活的脚本

创建一个单元阵列特征向量包含日期在法国。

C = {“2013年四月8日”,“麦2013”;“juin 2014”,“2014年juillet 11日”}

C =2 x2细胞{' 8艾薇儿2013}{' 9麦2013}{‘juin 2014} {' 11 juillet 2014 '}

把特征向量Cdatetime值。如果你的电脑设置为一个使用英语的语言环境,你必须指定“场所”名称-值对参数表明字符串是在法国。

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

t =2 x2 datetime2013年5月- 08 - 4月- 2013年09 - 10 - 2014年6月- 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,嗯d, y ')

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

将Excel日期号码Datetime

打开生活的脚本

创建一个示例的Excel®日期数字代表0,1月以来天数1900。

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

X =2×239558 39600 39700 39800

转换的值Xdatetime值。

t = datetime (X,“ConvertFrom”,“超越”)

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

提示

的列表datetime功能,请参阅日期和时间。
接受的核心MATLAB函数的列表datetime数组作为输入参数,请参阅核心功能支持日期和时间数组。

扩展功能

高大的数组
计算和数组的行比装入内存。

使用笔记和限制:

总是指定输入datetime格式创建高datetime时数组字符串数组或单元阵列特征向量。
如果您指定“格式”作为“preserveinput”,然后用MATLAB可能需要评估高数组来确定格式。

有关更多信息,请参见高大的数组。

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

使用笔记和限制:

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

分布式阵列
分区大数组在内存使用并行计算集群的工具箱相结合™。

使用笔记和限制:

当您创建一个datetime数组的文本DateStrings,指定的输入格式infmt。

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

版本历史

介绍了R2014b

全部展开

R2020a:`“InputFormat”`标识符`e`,`ee`,`米`,`毫米`,`问`,`QQ`不能识别名称,标识符`eee`,`嗯`,`回调`不承认全名吗

从R2020a开始,当您指定一个或两个字母标识符一周中的第几天、月或季度的“InputFormat”名称-值参数,这些标识符不再承认的名字。他们只认识数字。

同样,三个字母标识符缩写一周中的第几天、月、季度名字不再承认全名。他们只承认缩写。

表显示了这些标识符与认识和识别值的例子。

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

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

有关格式标识符的更多信息,请参阅格式的属性datetime。

另请参阅

持续时间|calendarDuration|离散化|NaT|字符串|字符|时区|leapseconds

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日期号码Datetime

提示

扩展功能

高大的数组计算和数组的行比装入内存。

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

分布式阵列分区大数组在内存使用并行计算集群的工具箱相结合™。

版本历史

R2020a:“InputFormat”标识符e,ee,米,毫米,问,QQ不能识别名称,标识符eee,嗯,回调不承认全名吗

另请参阅

主题

`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`- - - - - -系统时区设置
特征向量|字符串标量

高大的数组
计算和数组的行比装入内存。

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

分布式阵列
分区大数组在内存使用并行计算集群的工具箱相结合™。

R2020a:`“InputFormat”`标识符`e`,`ee`,`米`,`毫米`,`问`,`QQ`不能识别名称,标识符`eee`,`嗯`,`回调`不承认全名吗