split

将日历持续时间拆分为数值和持续时间单位

全页折叠

语法

[X1,X2,...] = split(t,units)

说明

[X1,X2,...] = split(t,units) 以单独的数值数组形式返回 t 中指定的日历持续时间值，其各个元素分别对应于 units 所指定的各个日期或时间单位。units 指定的日期和时间单位的数目确定输出参量的数目。

示例

示例

全部折叠

打开实时脚本

创建一个 calendarDuration 数组。 

T = calmonths(15:17) + caldays(8) + hours(1.2345)
T = 1×3 calendarDuration
   1y 3mo 8d 1h 14m 4.2s   1y 4mo 8d 1h 14m 4.2s   1y 5mo 8d 1h 14m 4.2s

获取月、日和时间。 

[m,d,t] = split(T,{'months','days','time'})
m = 1×3

    15    16    17


d = 1×3

     8     8     8


t = 1×3 duration
   01:14:04   01:14:04   01:14:04

获取年、月、日和时间。

[y,m,d,t] = split(T,{'years','months','days','time'})
y = 1×3

     1     1     1


m = 1×3

     3     4     5


d = 1×3

     8     8     8


t = 1×3 duration
   01:14:04   01:14:04   01:14:04

当同时请求年和月份时，split 会将大于 12 的月份值进位到年值。

输入参数

全部折叠

输入日历持续时间，指定为 calendarDuration 数组。

数据类型: calendarDuration

日期和时间单位，指定为一个字符向量、字符向量元胞数组或字符串数组。仅当第一个输入参量为 calendarDuration 数组 t 时才指定 units。

单位可以是下表中的一个或多个值。

值单位 t 拆分为
'years'年
'quarters'季度
'months'月
'weeks'周
'days'天
'time'时间，格式为 hours:minutes:seconds

必须从最大到最小指定日期和时间单位。例如，{'years','months'} 有效，但 {'months','years'} 无效。

示例: split(t,{'years','months','days'})

数据类型: char | cell | string

输出参量

全部折叠

输出数值和 duration 值，以数组的形式返回。split 在数值数组中返回年、月、日值，在 duration 数组中返回时间值。

数据类型: double | duration

扩展功能

全部展开

基于线程的环境
使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

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

版本历史记录

在 R2014b 中推出

另请参阅

| | | | |