cellstr

转换为字符向量元胞数组

全页折叠

语法

C = cellstr(A)
C = cellstr(D,datefmt)
C = cellstr(D,datefmt,locale)

说明

转换数组

C = cellstr(A) 将 A 转换为字符向量元胞数组。例如，如果 A 是字符串 "foo"，则 C 是包含字符向量 {'foo'} 的元胞数组。

示例

转换日期和时间

C = cellstr(D,datefmt)（其中 D 是 datetime 或 duration 数组）应用指定的格式，如 "HH:mm:ss"。

示例

C = cellstr(D,datefmt,locale) 指定区域设置，例如 "en_US"。

示例

示例

全部折叠

打开实时脚本

您可以创建字符串数组来包含多段文本。但是，您可能需要使用接受字符向量元胞数组作为输入参量，但不接受字符串数组的函数。要将字符串数组中的数据传递给此类函数，请使用 cellstr 函数将字符串数组转换为字符向量元胞数组。

创建一个字符串数组。您可以使用双引号创建字符串。

A = ["Past","Present","Future"]
A = 1×3 string
    "Past"    "Present"    "Future"

将字符串数组转换为一个 1×3 的字符向量元胞数组。

C = cellstr(A)
C = 1×3 cell
    {'Past'}    {'Present'}    {'Future'}
打开实时脚本

创建一个字符数组。包括结尾空格以使每行的长度相同，生成一个 3×4 的数组。 

A = ['abc ';'defg';'hi  ']
A = 3×4 char array
    'abc '
    'defg'
    'hi  '


class(A)
ans = 
'char'

将字符数组转换为一个 3×1 的字符向量元胞数组。 

C = cellstr(A)
C = 3×1 cell
    {'abc' }
    {'defg'}
    {'hi'  }


class(C)
ans = 
'cell'
打开实时脚本

创建一个 calendarDuration 数组。 

D = calmonths(15:17) + caldays(8) + hours(1.2345)
D = 1×3 calendarDuration
   1y 3mo 8d 1h 14m 4.2s   1y 4mo 8d 1h 14m 4.2s   1y 5mo 8d 1h 14m 4.2s

将数组转换为字符向量元胞数组。 

C = cellstr(D)
C = 1×3 cell
    {'1y 3mo 8d 1h 14m 4.2s'}    {'1y 4mo 8d 1h 14m 4.2s'}    {'1y 5mo 8d 1h 14m 4.2s'}


class(C)
ans = 
'cell'
打开实时脚本

创建一个 datetime。 

D = datetime
D = datetime
   13-Jul-2025 18:36:14

将 datetime 转换为格式化并本地化为法国的字符向量。

C = cellstr(D,'eeee, MMMM d, yyyy HH:mm:ss',"fr_FR")
C = 1×1 cell array
    {'dimanche, juillet 13, 2025 18:36:14'}

输入参数

全部折叠

输入数组。A 的数据类型确定 cellstr 如何将 A 转换为字符向量元胞数组。

输入类型

转换说明

示例输入

示例输出

string

将每个元素转换为字符向量，并将其赋给某个元胞。

如果 A 为空，即 ""，则输出是包含一个空字符数组（即 0×0 字符向量）的元胞。

1×1 string array
    "foo"

 
1×1 cell array
    {'foo'}
1×2 string array
    "foo"    "bar"
 
1×2 cell array
    {'foo'}    {'bar'}

字符数组

将输入的每行赋给一个元胞。cellstr 删除每行中的尾随空白字符，但实义空白字符除外，如不间断空白字符。

 
2×3 char array
    'foo'
    'bar'
 
 2×1 cell array
    {'foo'}
    {'bar'}

分类数组

将输入数组的每个元素转换为一个字符向量，并将该向量赋给新元胞数组中的一个元胞。

 
1x3 categorical array
    red    green    blue
 
1×3 cell array
    {'red'}    {'green'}    {'blue'}

日期或持续时间数组，指定为 datetime、duration 或 calendarDuration 数组。D 的数据类型确定 cellstr 如何将 A 转换为字符向量元胞数组。

输入类型

转换说明

示例输入

示例输出

datetime 数组

将每个元素转换为字符向量，并将其赋给某个元胞。要指定格式和区域设置，请参阅 datefmt。

datetime(2020,6,1)

1x1 cell array
   {'01-Jun-2020'}

duration 数组

将每个元素转换为字符向量，并将其赋给某个元胞。要指定格式和区域设置，请参阅 datefmt。

duration(5:6,12,21)

 
1x2 cell array
    {'05:12:21'}    {'06:12:21'}

calendarDuration 数组

将每个元素转换为字符向量，并将其赋给某个元胞。要指定格式和区域设置，请参阅 datefmt。

calmonths(15) + caldays(8) + hours(1.2345)

 
1x1 cell array
    {'1y 3mo 8d 1h 14m 4.2s'}

日期格式和区域设置，指定为单独字符向量或字符串标量。A 输入必须是 datetime、duration 或 calendarDuration 类型。

如果不指定格式，cellstr 将使用 A 的 Format 属性中的值。

示例: cellstr(A,"yyyy-MM-dd")

示例: cellstr(A,"dd:hh:mm:ss","en_US")

支持的格式取决于 A 的数据类型。

  • datetime 格式可以包括单位和分隔符的组合，例如 "yyyy-MMM-dd HH:mm:ss.SSS"。有关详细信息，请参阅 datetime 数组的 Format 属性。

  • duration 格式为单个字符（y、d、h、m 或 s）或者以下组合之一：

    • "dd:hh:mm:ss"

    • "hh:mm:ss"

    • "mm:ss"

    • "hh:mm"

    • 以上任意项，用最多九个 S 字符指示秒小数位，例如 "hh:mm:ss.SSSS"

  • calendarDuration 格式可以按从最大到最小时间单位的顺序包括字符 y、q、m、w、d 和 t 的组合，例如 "ym"。有关 duration 和 calendarDuration 格式的详细信息，请参阅设置日期时间显示格式。

区域设置，指定为下列值之一：

  • "system"，用于指定您的系统区域设置。

  • xx_YY 形式的字符串标量，其中 xx 是用于指定语言的小写 ISO 639-1 双字母代码，YY 是用于指定国家/地区的大写 ISO 3166-1 alpha-2 代码。有关示例值，请参阅 datetime 函数的 Locale 名称-值参量。

要仅指定区域设置，请使用空数组作为格式的占位符，即 []。

示例: cellstr(A, "yyyy-MM-dd","en_US")

示例: cellstr(A, [],"en_US")

区域设置影响用于表示日期和时间的某些分量（例如月份名称）的语言。有效值包括：

下表列出了区域设置的某些常用值。

区域设置 语言国家/地区
"de_DE"德语德国
"en_GB"英语英国
"en_US"英语美国
"es_ES"西班牙语西班牙
"fr_FR"法语法国
"it_IT"意大利语意大利
"ja_JP"日语日本
"ko_KR"韩语韩国
"nl_NL"荷兰荷兰
"zh_CN"简体中文中国

扩展功能

全部展开

版本历史记录

在 R2006a 之前推出

另请参阅

| | | | | |