主要内容

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函数返回一个字符数组米行,米总数是多少datetime值t．默认情况下,datestr返回格式为日-月-年小时:分:秒的文本。若小时:分:秒为00:00:00，则返回的文本格式为日-月-年。

例子

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

注意:在某些情况下，datestr将日期向量解释为六个日期数的向量。有关更多信息，请参见转换日期向量返回意外的输出．

例子

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

例子

DateString= datestr (___，formatOut）指定输出文本的格式formatOut．你可以使用formatOut使用前面语法中的任何输入参数。

DateString= datestr (DateStringIn）转换DateStringIn以日、月、年小时:分:秒的格式进行文本输入。中表示的所有日期和时间DateStringIn必须具有相同的格式。

例子

DateString= datestr (DateStringIn，formatOut，PivotYear）转换DateStringIn来DateString的指定格式formatOut，并使用optionalPivotYear解释以两个字符指定年份的日期。

例子

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

例子

全部折叠

打开实时脚本 
T = [datetime(“现在”); datetime (“明天”）]
t =2 x1 datetime03-03-2023 06:56:51 04-03-2023 00:00:00
DateString = datestr(t)
DateString =2x20字符数组2023年3月04日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 = '03/03/23'

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

formatOut = 2;formatOut datestr(现在)
Ans = '03/03/23'

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

Dt = datestr(现在，'mmmm dd, yyyy HH:MM:SS。FFF“）
dt = ' 2023年3月3日6:56:48.901 AM'
打开实时脚本

将12小时的时间下午05: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 =3x11字符数组“2007年9月16日”“1996年5月14日”“2010年11月29日”

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

打开实时脚本

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

datestr (datenum (“13/24/88”，“mm / dd / yy”）)
ans = ' 1月24日-1989'
打开实时脚本

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

使用1900年作为轴心年。

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

对于相同的日期，使用2000年作为枢轴年。

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

将日期编号转换为当前区域语言的文本。

使用“本地”在法国进行辩论。

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

你可以打同样的电话而不指定“本地”．

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

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

输入参数

全部折叠

日期和时间，指定为datetime数组中。

注意:的datestr函数不接受datetime价值观是NaTS作为输入。

数据类型:datetime

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

例子: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

全年

1990，2002

yy

两位数的年份

90，02

QQ

季度年使用字母问一个数字

第一季度

嗯

月份使用全名

3月，12月

嗯

Month的前三个字母

3月，12月

毫米

两位数字的月份

03，12

米

月，首字母大写

米，D

dddd

使用全名的日子

周一，周二

ddd

日使用前三个字母

我的，星期二

dd

两位数的日子

05，20.

d

使用首字母大写的日子

米，T

HH

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

05，5我

毫米

两位数的分钟

12，02

党卫军

两位数字中的第二位

07，59

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:17或01 - 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

请注意

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

数据类型:双

输出参数

全部折叠

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

提示

  • 转换非预定义MATLAB中的文本®日期格式，首先将文本转换为日期数字，使用datenum或datevec功能。

扩展功能

版本历史

R2006a之前介绍

全部展开

另请参阅

||||

主题