主要内容

dateshift

转变日期或生成的日期和时间序列

描述

例子

t2 = dateshift (t“开始”,单位)每个值的变化datetime数组t回到指定的单位时间的开始单位。输出t2一样的尺寸吗t

例如,如果您改变九14点。,June 27, 2021 to the start of the hour, then the shifted value is 9:00 a.m., June 27, 2021. If you shift it to the start of the month, then the shifted value is 12:00 a.m., June 1, 2021.

例子

t2 = dateshift (t“结束”,单位)未来值转移到指定的单位时间的结束单位

  • 一天,小时,分钟,或第二也开始的第二天,小时,分钟,或第二。例如,如果您改变九14点。,June 27, 2021 to the end of the hour, then the shifted value is 10:00 a.m., June 27, 2021.

  • 一年,季度末、月或周午夜开始的最后一天,那一年,季度,月或周。例如,如果您改变九14点。,June 27, 2021 to the end of the month, then the shifted value is 12:00 a.m., June 30, 2021.

例子

t2 = dateshift (t“dayofweek”,陶氏)转移到指定的一天每星期或之后发生的datetime值数组t。如果一个日期t已经落在指定的星期,dateshift返回相同的日期。

例子

t2 = dateshift (t、“dayofweek”、“周末”)转移到周末一天(周六或周日)或之后发生的datetime值数组t

例子

t2 = dateshift (t、“dayofweek”“工作日”)转向或之后发生的工作日(Monday-Friday)datetime值数组t

例子

t2 = dateshift (___,规则)数组中的每一个值变化t根据指定的模式规则。您可以使用该语法的任何参数在前面的语法。

例子

全部折叠

创建一个datetime价值与当前日期。

t = datetime (“今天”)
t =datetime03 - mar - 2023

转变的日期开始。

t2 = dateshift (t)“开始”,“年”)
t2 =datetime01 - 1月- 2023

创建一个datetime价值与当前日期。

t = datetime (“今天”)
t =datetime03 - mar - 2023

日期转移到同一个月的结束。

t2 = dateshift (t)“结束”,“月”)
t2 =datetime31 - 3月- 2023

创建一个datetime价值。

t = datetime (“今天”)
t =datetime03 - mar - 2023

改变下个月的日期开始。

t2 = dateshift (t)“开始”,“月”,“下一个”)
t2 =datetime01 - 4月- 2023

结束日期转移到下个月。

t3 = dateshift (t)“结束”,“月”,“下一个”)
t3 =datetime2023年- 4月30日

创建一个datetime数组中。格式显示星期和日期。

改变数组的日期下周五。

t = [datetime(2014, 08年,03)datetime (2014、04、15)];t。格式=“eeee, dd嗯yyyy”
t =1 x2 datetime星期日,2014年8月3日2014年4月15日,星期二

把日期在下周五。

t2 = dateshift (t)“dayofweek”,“星期五”)
t2 =1 x2 datetime星期五,星期五2014年08年8月,2014年4月18日

的日期向后转移到前面的周一。

t3 = dateshift (t)“dayofweek”,“周一”,“以前”)
t3 =1 x2 datetime周一,2014年7月28日星期一,2014年4月14日

创建一个datetime数组中。格式显示星期和日期。

5 t = [datetime(2021年,30)datetime (2021、6、4)];t。格式=“eeee, dd嗯yyyy”
t =1 x2 datetime星期日,2021年5月30日星期五,04年6月2021年

转向后的第一个周末发生在或每个值t。因为星期天是已经周末的一天,第一个datetime值不是发生了变化。但第二个值变化从周五到周六。

t2 = dateshift (t)“dayofweek”,“周末”)
t2 =1 x2 datetime星期日,2021年5月30日星期六,05年6月2021年

创建一个datetime数组中。格式显示星期和日期。

5 t = [datetime(2021年,30)datetime (2021、6、4)];t。格式=“eeee, dd嗯yyyy”
t =1 x2 datetime星期日,2021年5月30日星期五,04年6月2021年

转向后的第一个工作日或发生的每个值t。周日周一转向。但是因为周五已经是一个工作日,第二datetime值不是发生了变化。

t2 = dateshift (t)“dayofweek”,“工作日”)
t2 =1 x2 datetime星期一,2021年5月31日星期五,04年6月2021年

发现日期落在今天的第五周。

t = datetime (“今天”);t。格式=“eeee, dd嗯yyyy”
t =datetime星期五,2023年3月3日
t2 = dateshift (t)“结束”,“周”5)
t2 =datetime周六,08年4月2023年

生成的日期组成的序列未来三周五出现的。

t = datetime (“今天”)
t =datetime03 - mar - 2023
t2 = dateshift (t)“dayofweek”,“星期五”1:3)
t2 =1 x3 datetime03 - 3月- 2023年3月10 - 17 - 2023 - 3 - 2023

输入参数

全部折叠

输入的日期和时间,指定为一个datetime数组中。

的时间单位,指定这些值之一:

  • “年”

  • “季”

  • “月”

  • “周”

  • “天”

  • “小时”

  • “一分钟”

  • “第二”

例子:t2 = dateshift (t,“开始”,“小时”)

例子:t2 = dateshift (t,“结束”,“月”)

姓名或号码一天的星期,指定为字符串标量或特征向量是一个本地化名称或之间的一个整数1- - - - - -7

之间的整数1- - - - - -7对应的星期,如表所示。

1

周日

2

周一

3

周二

4

周三

5

周四

6

星期五

7

周六

例子:t2 = dateshift (t ' dayofweek ' '星期天')

例子:t2 = dateshift (t, dayofweek, 1)

规则变化datetime值,指定为“下一个”,“以前”,“最近的”,“当前”、一个标量整数或一个整数数组。

表描述了转移的规则datetime值。

规则 描述

“下一个”

转变datetime值下的时间单位或指定天的星期。

注意:这条规则的默认规则“dayofweek”输入参数。

“以前”

转变datetime值前的时间单位或指定天的星期。

“最近的”

转变datetime价值最近出现的时间单位或指定天的星期。

您可以使用这条规则datetime值。

“当前”

转变datetime值在当前的时间单位星期在当前或指定的天。

注意:这条规则的默认规则“开始”“结束”输入参数。

1

相当于“下一个”规则。

n,在那里n>1

相当于“下一个”规则应用n次了。

0

相当于“当前”规则。

1

相当于“以前”规则。

- n,在那里n>1

相当于“以前”规则应用n次了。

整数的数组

变化中的每个值t根据指定的规则对应的整数规则

输入参数t规则必须具有相同的大小或其中之一必须标量。

时的行为datetime值匹配“dayofweek”论点

如果您指定“dayofweek”t包含datetime值落在指定的星期,dateshift对待那些datetime值作为下一个或前出现的指定的星期。

例如,dateshift (datetime (2015、12、24),“dayofweek”,“日”,规则)返回一个datetime值的日期2015年12月24日规则“下一个”,“以前”,“最近的”,1,或12015年12月24日,因为是周四。

扩展功能

版本历史

介绍了R2014b

另请参阅

|