datetime
表示时间点的数组
描述
的datetime
数据类型表示时间点,例如2020年8月24日上午10:50:30。一个datetime
数组指定与存储在数组中的每个时间点相关的年、月、日、小时、分钟和秒组件(使用预期的ISO日历)。
同时,datetime
数组提供:
输出显示和输入文本解析的灵活格式。
从小数秒到纳秒精度的存储。
属性来考虑时区、夏令时和闰秒。
创建
语法
描述
返回一个标量t
= datetimedatetime
对应于当前日期和时间的数组。
使用指定的日期t
= datetime (relativeDay
)relativeDay
.的relativeDay
输入可以是“今天”
,“明天”
,“昨天”
,或“现在”
.
中的文本创建日期时间值数组t
= datetime (DateStrings
)DateStrings
表示时间点。
解释t
= datetime (DateStrings
InputFormat”,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 (___,名称,值
)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
,指定为这些值之一。
的价值 |
中值的类型 |
---|---|
|
自1月0日至0000日(预期ISO日历)的天数。 |
|
1900年1月0日起的天数。 Excel®日期数字四舍五入到最接近的微秒。 注意:Excel错误地假设1900年是闰年。因此,当计算Excel日期数字时,在1900年2月28日和1900年3月1日之间有一个额外的一天不连续。 |
|
自1904年1月0日起的天数。 Excel日期数字四舍五入到最接近的微秒。 注意:Excel错误地假设1900年是闰年。因此,当计算Excel日期数字时,在1900年2月28日和1900年3月1日之间有一个额外的一天不连续。 |
|
自协调世界时公元前11月24日-4714日中午(预期公历)起的天数。 如果你转换 例子:转换 T = date (X,'ConvertFrom','juliandate',…“时区”、“美国/ New_York”) 然后,您可以转换 T.TimeZone = " |
|
自协调世界时1858年11月17日午夜起的天数。 如果你转换 例子:转换 T = date (X,'ConvertFrom','modifiedjuliandate',…“时区”、“美国/ New_York”) 然后,您可以转换 T.TimeZone = " |
|
自UTC时间1970年1月1日00:00:00开始的秒数,不包括闰秒。 如果你转换 例子:转换 T = date (X,'ConvertFrom','posixtime',…“时区”、“美国/ New_York”) 然后,您可以转换 T.TimeZone = " |
|
日期为YYYYMMDD数值。例如, |
|
自UTC时间1月1日-1900 00:00:00以来的“时钟滴答”数,其中每个时钟滴答为2^-32秒。 |
|
从UTC时间1- 1- 0001 00:00:00开始的“时钟滴答”数,其中每个时钟滴答为100ns。 |
|
自UTC时间1月1日-1601 00:00:00开始的“时钟滴答”数,其中每个时钟滴答为100ns。 |
|
自J2000以来已经过的纳秒数。通用数据格式(CDF)定义了 输入 转换 注意:J2000是地球时间2000年1月1日12时。TT与UTC的不同有两个原因:
因此,J2000实际上发生在正午前64.184秒 D = datetime(2000,1,1,11,58,55,816,“时区”,“UTCLeapSeconds”) D = 2000-01-01t11:58:55.816z 例子:创建一个 X = int64([702077514184000000;...702163914184000000;...702250314184000000)) X = 3x1int64列向量702077514184000000 702163914184000000 702250314184000000
D = datetime(X,“ConvertFrom”,“tt2000”,“时区”,“UTCLeapSeconds”) D = 3x1datetime数组2022-04-02t9:30:45. 000z
|
|
从一个纪元开始的秒数。 您还必须指定 例子:转换 T = date (X,'ConvertFrom',…“epochtime”、“时代”,“2000-01-01”) |
|
一个纪元以来“时钟滴答”的次数。 除了指定 例子:转换 T = date (X,'ConvertFrom',…“epochtime”、“时代”、“2000-01-01”、“TicksPerSecond”,1000年) |
指定可选参数对为Name1 = Value1,…,以=家
,在那里的名字
参数名称和价值
对应的值。名称-值参数必须出现在其他参数之后,但对的顺序无关紧要。
在R2021a之前,使用逗号分隔每个名称和值,并将其括起来的名字
在报价。
例子:“格式”,“eeee MMMM d, y”,“时区”,“本地”
将显示格式应用到datetime值并指定本地时区。
格式
- - - - - -显示格式
“默认”
|“preserveinput”
|特征向量|字符串标量
输出数组中值的显示格式,指定为由逗号分隔的对组成“格式”
和以下值之一。
的价值格式 |
描述 |
---|---|
|
使用默认的显示格式。 |
|
使用输入格式指定的格式, |
字符向量或字符串标量 |
使用使用字符向量或字符串标量指定的格式。 |
如果指定了自己的格式,则必须使用有效的字母标识符。有关有效字母标识符的完整列表,请参见格式
财产。
出厂默认格式取决于您的系统区域设置。若要更改默认显示格式,请参见默认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窗口。
数据类型:字符
|字符串
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, 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
表示闰秒的协调世界时数组。控件支持的闰秒列表金宝appdatetime
数据类型,请参见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之间的值表示在闰秒内发生的日期时间。控件支持的闰秒列表金宝appdatetime
数据类型,请参见leapseconds
.)
SystemTimeZone
- - - - - -系统时区设置
特征向量|字符串标量
此属性是只读的。
系统时区设置,指定为字符向量或字符串标量。该系统由MATLAB编写®是否运行决定此时区设置。
例子:美国/ New_York
例子
特定时区的当前日期和时间
指定本地系统时区的当前日期和时间。
T =日期时间(“现在”,“时区”,“本地”,“格式”,'d-MMM-y HH:mm:ss Z')
t =datetimeaug - 31- 2022 03:31:42 -0400
在韩国首尔所代表的时区中指定当前日期和时间。
T =日期时间(“现在”,“时区”,“亚洲/首尔”,“格式”,'d-MMM-y HH:mm:ss Z')
t =datetime8月31日-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。瑞士的)
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
数组作为输入参数,请参见支持日期和时间数组的核心功能金宝app.
扩展功能
高大的数组
使用行数超过内存容量的数组进行计算。
使用注意事项和限制:
在为单元格数组中的字符串数组或字符向量创建高日期时间数组时,始终指定输入日期时间格式。
如果你指定
“格式”
作为“preserveinput”
,则MATLAB可能需要计算tall数组以确定格式。
有关更多信息,请参见高大的数组.
C/ c++代码生成
使用MATLAB®Coder™生成C和c++代码。
使用注意事项和限制:
从R2020a开始,您可以使用
datetime
数组在MATLAB代码中用于代码生成。有关更多信息,请参见日期时间数组的代码生成(MATLAB编码器)而且代码生成的日期时间数组限制(MATLAB编码器).
分布式阵列
使用并行计算工具箱™跨集群的组合内存对大型数组进行分区。
版本历史
在R2014b中引入R2020a:“InputFormat”
标识符e
,ee
,米
,毫米
,问
,QQ
不识别名称,而标识符eee
,嗯
,回调
不认识全名
类中为星期、月或季度指定一个或两个字母标识符时,从R2020a开始“InputFormat”
参数时,这些标识符不再识别名称。它们只识别数字。
类似地,用于缩略的星期、月份和季度名称的三个字母标识符不再识别全名。他们只识别缩写。
下表显示了这些标识符,其中包括已识别值和未识别值的示例。
标识符 |
公认的例子 |
未识别的例子 |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
在以前的版本中,所有这些由一个、两个和三个字母组成的标识符分别识别星期、月份和季度的缩写名和全名。例如,ee
公认的结婚
周三,毫米
公认的4月
四月,和QQ
公认的第二季
第二季度。同样的,eee
公认的周三
,嗯
公认的4月
,回调
公认的第二季度
.
有关格式标识符的详细信息,请参见格式
的属性datetime
.
Abrir比如
Tiene una versión modificada de este ejemplo。¿Desea abrir este ejemplo con sus modificaciones?
MATLAB突击队
Ha hecho clic en unenlace que对应一个este commando de MATLAB:
弹射突击队introduciéndolo en la ventana de commandos de MATLAB。Los navegadores web no permission comandos de MATLAB。
您也可以从以下列表中选择一个网站:
如何获得最佳的网站性能
选择中国站点(中文或英文)以获得最佳站点性能。其他MathWorks国家站点没有针对您所在位置的访问进行优化。