datestr

将日期和时间转换为字符串格式

描述

例子

DateString= datestr(t)转换输入数组中的日期时间值t文字表示的日期和时间。

datestr函数返回一个字符数组行,其中是否有日期时间值的总数t。默认情况下,datestr返回文本格式,日 - 月 - 年时:分:秒。如果小时:分钟:第二个是就是,则返回的文本具有格式,日-月-年。

请注意

datestr代表日期和时间返回文本,建议您使用约会时间值来表示时间点,然后使用它们转换为文本烧焦,cellstr, 要么职能。

例子

DateString= datestr(DateVector)日期向量转换成表示日期和时间的文本。的datestr函数返回一个字符数组行,其中是日期向量的总数DateVector

例子

DateString= datestr(DateNumber)序列日期数字转换为代表日期和时间的文本。的datestr函数返回一个字符数组行,其中是日期数字的总数DateNumber

例子

DateString= datestr(___,formatOut)指定使用输出文本的格式formatOut。您可以使用formatOut与任何在前面的语法输入参数。

DateString= datestr(DateStringIn)转换DateStringIn文本格式,日-月-年小时:分:秒。所有日期和时间用表示DateStringIn必须具有相同的格式。

例子

DateString= datestr(DateStringIn,formatOut,PivotYear)转换DateStringInDateString,格式由formatOut,并使用可选PivotYear将指定年份的日期解释为两个字符。

例子

DateString= datestr(___,“本地”)返回当前语言环境的语言的日期。这种语言是您通过您的计算机的操作系统来选择语言。如果你走“本地”从参数列表,datestr返回默认的语言,这是美国英语文本。利用“本地”与任何以前的语法。的“本地”参数必须是最后的参数序列。

例子

全部折叠

t = [datetime ('现在');datetime ('明天')]
T =2 x1 datetime29月-2020 0时09分24秒01-MAR-2020 00:00:00
DateString = datestr(t)的
DateString =2 x20的字符数组'29-Feb-2020 00:09:24' '01-Mar-2020 00:00:00'

datestr代表格式的日期和时间返回文本,日 - 月 - 年时:分:秒。

DateVector = [2009,4,2,11,7,18];datestr(DateVector)
ans = '02-Apr-2009 11:07:18'

datestr返回以默认格式表示日期和时间的文本。

格式化的当前日期MM / DD / YY格式。

可以使用符号标识符指定此格式。

formatOut ='MM / DD / YY';formatOut datestr(现在)
ans = ' 02/29/20 '

另外,您也可以使用数字标识符指定此格式。

formatOut = 2;formatOut datestr(现在)
ans = ' 02/29/20 '

您可以重新格式化日期和时间,并且还显示毫秒。

DT = datestr(现在,'MMMM DD,YYYY HH:MM:SS.FFF AM')
2020年2月29日12:09:04.579 AM

转换的12小时时间下午5点32其24小时等量。

datestr(“05:32点”,'HH:MM')
ANS = '17:32'

转换的24小时时间05:32到其12小时等量。

datestr('05:32','HH:MM PM')
ANS =“上午5点32”

指某东西的用途要么下午在里面formatOut输出文本不影响其角色都成为文本的一部分;他们只确定是否要包括的字符。MATLAB®选择要么下午根据输入的时间。

呼叫datenum代替datestr指定表示日期的输入文本的格式。

formatOut ='DD MMM YYYY';datestr(datenum('16 -04-55','DD-MM-YY',1900),formatOut)
ANS = '16 1955' 年4月

通过使它们在一个单元阵列转换表示日期多个字符向量。

所有输入日期必须使用相同的格式。例如,下面的命令传递三个日期,它们都使用毫米/日/年格式。

datestr(datenum({'09 / 16 / 2007' 的;'05 / 14 / 1996' 的所有;'11 / 29 / 2010'},...“毫米/日/年”))
ans =3x11 char数组'16 -sep-2007' '14  -  5月 -  1996' 年'29 -nov-2010'

datestr以日-月-年的格式返回转换日期的字符数组。

呼叫datenum代替datestr到其正常范围之外(月= 13)返回预期的值,因为日期以下用途的值。

datestr(datenum(“13/24/88”,'MM / DD / YY'))
ANS = '24 -Jan-1989'

更改枢轴一年来改变年份范围。

使用的1900枢轴一年。

DateStringIn =“4/16/55”;formatOut = 1;PivotYear = 1900;datestr (DateStringIn formatOut PivotYear)
ans = ' 16 - 4月- 1955 '

同样的日期,使用2000年为关键年。

PivotYear = 2000;datestr (DateStringIn formatOut PivotYear)
ans = ' 16 - 4月- 2055 '

将日期号转换为当前语言环境中的文本。

使用“本地”参数在法语语言环境中。

DateNumber = 725935;formatOut ='MMMM-DD-YYYY';str = datestr (DateNumber formatOut,“本地”)
str = juillet - 17 - 1987

您可以进行相同的调用,而不指定“本地”

str = datestr (DateNumber formatOut)
海峡=月-17-1987

在本例中,输出默认为英语。

输入参数

全部折叠

日期和时间,指定为约会时间数组中。

数据类型:约会时间

日期矢量,指定为6矩阵,已满(六元件)日期矢量的数量。中的每个元素DateVector除了可以是小数的seconds元素外,必须是正整数或负整数。如果一个元素不在常规范围内,datestr调整两个该日期向量元素和前一个元素。例如,如果分元件是70,然后datestr调整小时元素1并将minutes元素设置为10。如果minutes元素是 -15,然后datestr减小由小时元件1并将minutes元素设置为45。月值是一个例外。datestr设置月份值小于11

例:[2003,10,24,12,45,07]

数据类型:

串行日期数字,指定为正双精度数的阵列。

例:731878

数据类型:

表示日期和时间的输出格式,指定为符号标识符的字符向量或字符串标量或与预定义格式相对应的整数。如果您没有指定formatOut,然后datestr返回默认格式的文本dd-mmm-yyyy HH: MM: SS(日 - 月 - 年时:分:秒)。默认情况下,如果HH: MM: SS =就是然后返回的文本的格式dd-mmm-yyyy

下表显示了符号标志,您可以使用构建formatOut特征向量。可以包括字符,如一个连字符,空间,或结肠分隔字段。

请注意

描述日期和时间格式的符号标识符与描述的显示格式的标识符不同约会时间阵列。

符号标识

描述

例子

YYYY

在全年

1990年,2002

YY

两位数年

90,02

QQ

使用信件的季度和一个数字

Q1

MMMM

使用全名月

游行,12月

MMM

使用前三个字母月

损伤,十二月

毫米

本月两位数

03,12

使用大写首字母月

,D

dddd

天使用全名

周一,星期二

DDD

每天使用前三个字母

周一,星期二

dd

两位数的一天

05,20

d

使用天大写首字母

,T

HH

两位数小时
(无前导零当符号标识符要么下午用来)

05,5

MM

分钟两位数

12,02

SS

两位数第二

07,59

FFF

三位数的毫秒

057

上午或下午

要么下午插入表示文本时间

3:45:02下午

formatOut特征向量必须遵循以下原则:

  • 您不能指定任何字段不止一次。例如,您不能使用“yy-mmm-dd-m”因为它有两个月份标识符。唯一的例外情况是,你可以结合一个实例dd与任何其他一天的标识符的一个实例。例如,'DDDD MMM DD YYYY'是一个有效的输入。

  • 当您使用要么下午,HH还需要场。

  • 您只能使用QQ单独或者与上年符。

预定义的日期格式,你可以使用此表列出了datestr

数字标识

日期和时间格式

例子

-1(默认)

“日 - 月 - 年HH:MM:SS”要么“dd-mmm-yyyy”如果=就是HH: MM: SS

01-MAR-2000 15时45分17秒要么01-MAR-2000

0

“日 - 月 - 年HH:MM:SS”

01-MAR-2000 15时45分17秒

1

“dd-mmm-yyyy”

01-MAR-2000

2

'MM / DD / YY'

03/01/00

3.

“嗯”

损伤

4

'M'

5

“毫米”

03

6

'MM / DD'

03/01

7

'DD'

01

8

'DDD'

星期三

9

'd'

W

10

'YYYY'

2000

11

'YY'

00

12

'mmmyy'

Mar00

13

'HH:MM:SS'

15点45分17秒

14

“HH: MM: SS点”

下午3时45分17秒

15

'HH:MM'

15:45

16

'HH:MM PM'

3:45 PM

17

'QQ-YY'

Q1-01

18

“QQ”

Q1

19

“dd / mm”

01/03

20

“dd / mm / yy”

00年1月3日

21

'MMM.DD,YYYY HH:MM:SS'

2000年Mar.01 15:45:17

22

“mmm.dd yyyy、“

Mar.01,2000

23

“毫米/日/年”

2000年3月1日

24

“dd / mm / yyyy”

01/03/2000

25

'YY / MM / DD'

00/03/01

26

'YYYY / MM / DD'

2000年3月1日

27

'QQ-YYYY'

Q1-2001

28

“mmmyyyy”

Mar2000

29

'YYYY-MM-DD'
(ISO 8601)

2000-03-01

三十

'YYYYMMDDTHHMMSS'
(ISO 8601)

20000301 t154517

31

“yyyy-mm-dd HH: MM: SS”

2000-03-01十五点45分17秒

表示要转换的日期和时间的文本,指定为单个字符向量、字符向量的单元数组或字符串数组,其中每一行对应一个日期和时间。

datestr考虑两个字符年(例如,'79')将落入100年范围为中心的当前年左右。

代表日期和时间的所有文本必须具有相同的日期格式,而且必须是在以下日期格式之一。

文字代表日期和时间格式

例子

“日 - 月 - 年HH:MM:SS”

01-MAR-2000 15时45分17秒

“dd-mmm-yyyy”

01-MAR-2000

“毫米/日/年”

2000年3月1日

'MM / DD / YY'

03/01/00

'MM / DD'

03/01

'MMM.DD,YYYY HH:MM:SS'

2000年Mar.01 15:45:17

“mmm.dd yyyy、“

Mar.01,2000

“yyyy-mm-dd HH: MM: SS”

2000-03-01十五点45分17秒

'YYYY-MM-DD'

2000-03-01

'YYYY / MM / DD'

2000年3月1日

'HH:MM:SS'

15点45分17秒

“HH: MM: SS点”

下午3时45分17秒

'HH:MM'

15:45

'HH:MM PM'

3:45 PM

请注意

从一种日期和时间格式转换为另一种格式时,首先将文本传递给datenum功能,让您可以指定的输入格式。这种方法确保输入的日期和时间格式的正确解释。例如,看从自定义格式转换的日期字符串

指定为整数的100年日期范围的起始年,其中驻留两个字符的年份。使用数据透视年来解释将年份指定为两个字符的日期。

如果formatIn包含一天的时间,枢轴年从目前的日,月,年的当前时间来计算。否则,它是从当前的日,月,年的午夜计算。

例:2000

请注意

如果输入的日期格式指定了四个字符的年份,然后最后两个字符被截断,并第一两个字符指定年份。例如,如果日期和枢轴年被指定为( '25122015', 'DDMMYYYY',2000),则结果日期为25-12-2020,不25-12-2015

数据类型:

输出参数

全部折叠

表示日期和时间的文本,作为字符数组返回行,其中被输入的日期和时间的总数。默认的输出格式为dd-mmm-yyyy HH: MM: SS(日-月-年小时:分:秒)除非小时、分钟和秒在这种情况下都是0HH: MM: SS被抑制。

提示

  • 将文本转换不是一个预定义的MATLAB®日期格式,首先将文本转换为日期编号,使用datenum要么datevec职能。

扩展功能

R2006a前推出