文档

datestr

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

datestr函数创建一个字符数组,显示一个或多个时间点。然而,表示时间点的最好方法是使用datetime数据类型。

语法

DateString = datestr(t)
DateString = datestr(DateVector)
DateString = datestr(DateNumber)
DateString = datestr(___formatOut)
DateString = datestr(DateStringIn)
DateString = datestr(DateStringIn,formatOut,PivotYear)
DateString = datestr(___“本地”)

描述

例子

DateString= datestr (t中的日期时间值进行转换datetime数组t表示日期和时间的文本。datestr返回一个字符数组行,日期时间值的总数是t

默认情况下,datestr返回日-月-年小时:分钟:秒格式的文本。如果小时:分钟:秒=就是,则返回的文本格式为日-月-年。

例子

DateString= datestr (DateVector将日期向量转换为表示日期和时间的文本。datestr返回一个字符数组行,日期向量的总数在吗DateVector

例子

DateString= datestr (DateNumber将序列日期数字转换为表示日期和时间的文本。datestr返回一个字符数组行,总日期数在吗DateNumber

例子

DateString= datestr (___formatOut指定输出文本的格式formatOut。你可以用formatOut使用上述语法中的任何输入参数。

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

例子

DateString= datestr (DateStringInformatOutPivotYear转换DateStringInDateString,格式为formatOut,并使用optionalPivotYear将指定年份的日期解释为两个字符。

例子

DateString= datestr (___“本地”以当前区域设置的语言返回日期。这是您通过计算机操作系统选择的语言。如果你离开当地的在参数列表之外,datestr返回默认语言的文本,即美式英语。使用当地的使用任何前面的语法。的当地的参数必须是参数序列的最后一个。

例子

全部折叠

T = [datetime()]“现在”); datetime (“明天”)]
t =2×1日期时间数组2017年2月24日12:26:31
DateString = datestr(t)
DateString =2×20字符数组'24-Feb-2017 12:26:31' '25-Feb-2017 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/24/17'

或者,您可以使用数字标识符指定此格式。

formatOut = 2;formatOut datestr(现在)
Ans = '02/24/17'

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

Dt = datestr(现在,“嗯……”“嗯……”“嗯……”FFF“
dt = ' feb 24, 2017 11:57:03.550 AM'

把12小时制的下午5点32分换算成24小时制。

datestr (“05:32点”“HH: MM”
Ans = '17:32'

将24小时的时间05:32转换为12小时的等效时间。

datestr (“05:32”“HH: MM点”
ans = ' 5:32 AM'

的使用formatOut输出文本不影响哪些字符实际成为文本的一部分;它们只决定是否包含字符。MATLAB®选择根据输入的时间。

调用datenum里面的datestr指定表示日期的输入文本的格式。

formatOut =“dd MMM yyyy”;datestr (datenum (“16-04-55”“dd-mm-yy”, 1900), formatOut)
ans = ' 1955年4月16日'

通过在单元格数组中传递表示日期的多个字符向量来转换它们。

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

datestr (datenum ({“09/16/2007”;“05/14/1996”;“11/29/2010”},“mm / dd / yyyy”))
ans =3×11字符数组2007年9月16日1996年5月14日2010年11月29日

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

调用datenum里面的datestr返回期望值,因为下面的日期使用了正常范围之外的值(month=13)。

datestr (datenum (“13/24/88”“mm / dd / yy”))
ans = ' 1989年1月24日'

更改枢轴年以更改年份范围。

以1900年为枢轴年。

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

对于同一日期,使用2000年为枢轴年。

pivot = 2000;datestr (DateStringIn formatOut PivotYear)
ans = ' 2055年4月16日'

将日期数字转换为当前区域设置语言的文本。

使用当地的参数在法语区域设置中。

DateNumber = 725935;formatOut =“mmmm-dd-yyyy”;str = datestr(DateNumber,formatOut,“本地”
朱丽叶-17-1987

您可以拨打相同的电话,而无需指定“本地”

str = datestr(DateNumber,formatOut)
str = july 17-1987

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

输入参数

全部折叠

datetime值,指定为标量、向量、矩阵或多维datetime数组中。

日期向量,指定为- × 6矩阵,其中是完整(六元素)日期向量的个数。的每个元素DateVector应该是一个正整数值或负整数值,但seconds元素除外,它可以是小数。如果一个元素超出了常规范围,datestr调整该日期向量元素和前一个元素。例如,如果minutes元素是70datestr按调整小时元素1并将minutes元素设置为10。如果minutes元素是-15,然后datestr减少小时元素1并将minutes元素设置为45。月份值是个例外。datestr设置小于的月份值11

例子:24[2003, 10日,12日,45岁的07]

数据类型:

串行日期数,指定为标量、矢量、矩阵或正双精度数数组。

例子:731878

数据类型:

表示日期和时间的输出格式,指定为符号标识符的字符向量或与预定义格式对应的整数。如果不指定formatOut,然后datestr返回默认格式的文本dd-mmm-yyyy HH: MM: SS“日-月-年”(小时:分钟:秒)。默认情况下,如果Hh: mm: ss = 00:00:00然后返回的文本具有该格式dd-mmm-yyyy

的符号标识符formatOut特征向量。可以使用连字符、空格或冒号等字符来分隔字段。

    注意:描述日期和时间格式的符号标识符与描述的显示格式的符号标识符不同datetime数组。

符号标识符

描述

例子

yyyy

全年

19902002

yy

两位数年份

9002

QQ

季度使用字母一个数字

第一季度

使用全名的月份

3月12月

使用月的前三个字母

3月12月

毫米

两位数的月份

0312

月首字母大写

D

dddd

使用全名的日子

周一周二

ddd

使用前三个字母

我的星期二

dd

两位数的天数

0520.

d

使用首字母大写的日期

T

HH

两位数小时数
(符号标识符时没有前导零使用)

055

毫米

两位数分钟

1202

党卫军

两位数排名第二

0759

FFF

毫秒,三位数

057

上午或下午

插入到表示时间的文本中

3:45:02

formatOut字符矢量必须遵循以下准则:

  • 您不能多次指定任何字段。例如,您不能使用“yy-mmm-dd-m”因为它有两个月的标识符。的一个例外是,您可以组合的一个实例dd使用任何其他日期标识符的一个实例。例如,“dddd MMM dd yyyy”是有效的输入。

  • 当你使用,HH字段也是必需的。

  • 你只能用QQ单独使用或使用年份说明符。

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

数字标识符

日期和时间格式

例子

1(默认)

“dd-mmm-yyyy HH: MM: SS”“dd-mmm-yyyy”如果=就是HH: MM: SS

01 - 3月- 2000 15:45:1701 - 3月- 2000

0

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

01 - 3月- 2000 15:45:17

1

“dd-mmm-yyyy”

01 - 3月- 2000

2

“mm / dd / yy”

03/01/00

3.

“嗯”

3月

4

“米”

5

“毫米”

03

6

“mm / dd”

03/01

7

“弟弟”

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点”

下午3:45的时候

17

“QQ-YY”

Q1-01

18

“QQ”

第一季度

19

“dd / mm”

01/03

20.

“dd / mm / yy”

01/03/00

21

“嗯。dd,yyyyHH: MM: SS'

2000年Mar.01 15:45:17

22

“mmm.dd yyyy、“

Mar.01 2000

23

“mm / dd / yyyy”

03/01/2000

24

“dd / mm / yyyy”

01/03/2000

25

“yy / mm / dd”

00/03/01

26

“mm / dd / yyyy”

2000/03/01

27

“QQ-YYYY”

q1 - 2001

28

“mmmyyyy”

Mar2000

29

“yyyy-mm-dd”
(ISO 8601)

2000-03-01

30.

“yyyymmddTHHMMSS”
(ISO 8601)

20000301 t154517

31

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

2000-03-01 15:45:17

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

datestr考虑两个字符的年份(例如,“79”)落在以当年为中心的100年范围内。

所有表示日期和时间的文本必须具有相同的日期格式,并且必须是下列日期格式之一。

表示日期和时间的文本格式

例子

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

01 - 3月- 2000 15:45:17

“dd-mmm-yyyy”

01 - 3月- 2000

“mm / dd / yyyy”

03/01/2000

“mm / dd / yy”

03/01/00

“mm / dd”

03/01

“嗯。dd,yyyyHH: MM: SS'

2000年Mar.01 15:45:17

“mmm.dd yyyy、“

Mar.01 2000

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

2000-03-01 15:45:17

“yyyy-mm-dd”

2000-03-01

“mm / dd / yyyy”

2000/03/01

“HH: MM: SS”

15:45:17

“HH: MM: SS点”

3:45:17点

“HH: MM”

15:45

“HH: MM点”

下午3:45的时候

    注意:将一种日期和时间格式转换为另一种格式时,应首先将文本传递给datenum函数,以便您可以指定输入的格式。这确保了正确解释输入日期和时间的格式。例如,参见从自定义格式转换日期字符串

两个字符的年份所在的100年日期范围的起始年份,以整数形式指定。使用枢轴年来解释将年份指定为两个字符的日期。

如果formatIn包含每天的时间,从当前日、月和年的当前时间计算枢轴年。否则,从当前日、月、年的午夜开始计算。

例子:2000

    注意:如果输入日期格式指定了四个字符的年份,那么最后两个字符将被截断,并且第一个两个字符指定年份。例如,如果将日期和pivot年指定为(' 25122015 ', ' ddmmyyyy ', 2000),则结果日期为25-12-2020,而不是25-12-2015

数据类型:

输出参数

全部折叠

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

提示

  • 转换文本不在预定义的MATLAB®日期格式,首先将文本转换为日期数字,使用datenumdatevec

扩展功能

R2006a之前引入

这个话题有帮助吗?