设置日期时间显示格式
单个日期和持续时间数组的格式
datetime
、duration
和 calendarDuration
数组有一个 Format
属性,可控制每个数组中各值的显示方式。当您创建一个日期时间数组时,除非您明确提供格式,否则将使用 MATLAB® 的全球默认日期时间显示格式。可使用圆点表示法访问 Format
属性以查看或更改其值。例如,要将 datetime
数组 t
的显示格式设置为默认格式,请键入:
t.Format = 'default'
更改 Format
属性并不会更改数组中的值,它只会更改其显示方式。例如,以下可能是同一个 datetime
值的表示方式(后两种不显示任何时间分量):
Thursday, August 23, 2012 12:35:00 August 23, 2012 23-Aug-2012
datetime
、duration
和 calendarDuration
数据类型的 Format
属性可接受不同的格式作为输入。
datetime
显示格式
您可以将 Format
属性设置为下述字符向量之一。
Format 的值 | 描述 |
---|---|
| 使用默认的显示格式。 |
| 使用默认的日期显示格式,不显示时间分量。 |
如要更改默认格式,请参考 默认 datetime 格式。
您也可以指定包含 Unicode® 字符作为字面文本的自定义日期格式。下表列举了多种常见的显示格式和纽约市 2014 年 4 月 19 日(星期六)下午 9:41:06 的格式化输出示例。在这种格式中,您可以使用非字母 ASCII 字符(如连字符、空格或冒号)或任何非 ASCII 字符来分隔日期和时间字段。要在格式中包含 ASCII 字母 A
-Z
和 a
-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
可接受的字母标识符与 datestr
、datenum
和 datevec
函数所使用的字母标识符不同。
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
属性指定为一个字符向量,其中可依序包含以下字符 y
、q
、m
、w
、d
和 t
。格式必须包含 m
、d
和 t
。
下表描述了用这些字符表示的日期时间分量。
字符 | 单位 | 必需? |
---|---|---|
y | 年 | 否 |
q | 季度(3 个月的倍数) | 否 |
m | 月 | 是 |
w | 周 | 否 |
d | 天 | 是 |
t | 时间(小时、分钟和秒) | 是 |
要指定秒数显示的小数位数,请使用 format
函数。
如果时间分量的日期或时间值为零,将不显示该值。
更改 Format
属性并不会更改数组中的值,它只会更改其显示方式。
默认 datetime
格式
对于那些在创建时未显式设置显示格式的 datetime
组,您可以设置默认格式来控制其显示方式。当您将 datetime
数组的 Format
属性设置为 'default'
或 'defaultdate'
时,也将适用这些格式。当您更改默认设置时,设置为使用默认格式的 datetime
数组将自动按新设置显示。
对默认格式的更改将在各个 MATLAB 会话间保持一致。
要指定默认格式,请键入
datetime.setDefaultFormats('default',fmt)
fmt
是由字母 A
-Z
和 a
-z
组成的字符向量,用于对上面所提到的 datetime
数组的 Format
属性进行描述。例如, datetime.setDefaultFormats('default','yyyy-MM-dd hh:mm:ss')
此外,您还可以为所创建的不含时间分量的日期时间指定一个默认格式。例如,
datetime.setDefaultFormats('defaultdate','yyyy-MM-dd')
如要将默认格式和默认的仅日期格式重置为出厂默认设置,请键入
datetime.setDefaultFormats('reset')
您也可以在预设对话框中设置默认格式。有关详细信息,请参阅设置命令行窗口预设项。