Main Content

设置日期时间显示格式

单个日期和持续时间数组的格式

datetimedurationcalendarDuration 数组有一个 Format 属性,可控制每个数组中各值的显示方式。当您创建一个日期时间数组时,除非您明确提供格式,否则将使用 MATLAB® 的全球默认日期时间显示格式。可使用圆点表示法访问 Format 属性以查看或更改其值。例如,要将 datetime 数组 t 的显示格式设置为默认格式,请键入:

t.Format = 'default'

更改 Format 属性并不会更改数组中的值,它只会更改其显示方式。例如,以下可能是同一个 datetime 值的表示方式(后两种不显示任何时间分量):

Thursday, August 23, 2012 12:35:00
August 23, 2012
23-Aug-2012

datetimedurationcalendarDuration 数据类型的 Format 属性可接受不同的格式作为输入。

datetime 显示格式

您可以将 Format 属性设置为下述字符向量之一。

Format 的值描述

'default'

使用默认的显示格式。

'defaultdate'

使用默认的日期显示格式,不显示时间分量。

如要更改默认格式,请参考 默认 datetime 格式

您也可以指定包含 Unicode® 字符作为字面文本的自定义日期格式。下表列举了多种常见的显示格式和纽约市 2014 年 4 月 19 日(星期六)下午 9:41:06 的格式化输出示例。在这种格式中,您可以使用非字母 ASCII 字符(如连字符、空格或冒号)或任何非 ASCII 字符来分隔日期和时间字段。要在格式中包含 ASCII 字母 A-Za-z 作为字面字符,请用引号将它们引起来。

Format 的值示例
'yyyy-MM-dd'2014-04-19
'dd/MM/yyyy'19/04/2014
'dd.MM.yyyy'19.04.2014
'yyyy年 MM月 dd日'2014年 04月 19日
'MMMM d, yyyy'April 19, 2014
'eeee, MMMM d, yyyy h:mm a'Saturday, April 19, 2014 9:41 PM
'MMMM d, yyyy HH:mm:ss Z'April 19, 2014 21:41:06 -0400
'yyyy-MM-dd''T''HH:mmXXX' 2014-04-19T21:41-04:00

有关有效符号标识符的完整列表,请参阅日期时间数组的 Format 属性。

注意

datetime 可接受的字母标识符与 datestrdatenumdatevec 函数所使用的字母标识符不同。

duration 显示格式

要将持续时间显示为包含小数部分(例如 1.234 小时)的单个数字,请指定以下字符向量之一:

Format 的值 描述
'y'精确定长年的数目。固定长度的一年等于 365.2425 天。
'd'精确固定长度的天数的数目。固定长度的一天等于 24 小时。
'h'小时数
'm'分钟数
's'秒数

要指定显示的小数位数,请使用 format 函数。

要以数字计时器的形式显示持续时间,请指定下列字符向量之一。

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

您还可以通过附加最多 9 个 S 字符来显示最多 9 个秒小数位。例如,'hh:mm:ss.SSS' 以 3 位数显示持续时间的毫秒数。

更改 Format 属性并不会更改数组中的值,它只会更改其显示方式。

calendarDuration 显示格式

calendarDuration 数组的 Format 属性指定为一个字符向量,其中可依序包含以下字符 yqmwdt。格式必须包含 mdt

下表描述了用这些字符表示的日期时间分量。

字符单位必需?
y
q季度(3 个月的倍数)
m
w
d
t时间(小时、分钟和秒)

要指定秒数显示的小数位数,请使用 format 函数。

如果时间分量的日期或时间值为零,将不显示该值。

更改 Format 属性并不会更改数组中的值,它只会更改其显示方式。

默认 datetime 格式

对于那些在创建时未显式设置显示格式的 datetime 组,您可以设置默认格式来控制其显示方式。当您将 datetime 数组的 Format 属性设置为 'default''defaultdate' 时,也将适用这些格式。当您更改默认设置时,设置为使用默认格式的 datetime 数组将自动按新设置显示。

对默认格式的更改将在各个 MATLAB 会话间保持一致。

要指定默认格式,请键入

datetime.setDefaultFormats('default',fmt)
其中 fmt 是由字母 A-Za-z 组成的字符向量,用于对上面所提到的 datetime 数组的 Format 属性进行描述。例如,
datetime.setDefaultFormats('default','yyyy-MM-dd hh:mm:ss')
将默认日期时间格式设置为包含 4 位数的年份、2 位数的月份、2 位数的天数以及小时、分钟和秒数值。

此外,您还可以为所创建的不含时间分量的日期时间指定一个默认格式。例如,

datetime.setDefaultFormats('defaultdate','yyyy-MM-dd')
将默认日期格式设置为包含 4 位数的年份、2 位数的月份以及 2 位数的天数。

如要将默认格式和默认的仅日期格式重置为出厂默认设置,请键入

datetime.setDefaultFormats('reset')
出厂默认格式取决于您的系统区域设置。

您也可以在预设对话框中设置默认格式。有关详细信息,请参阅设置命令行窗口预设项

另请参阅

| | |