String

不可变的 Unicode 字符序列。

静态方法

format

format(template: String, values: any): String

将字符串作为模板进行格式化，用提供的值替换带索引的占位符。

占位符语法：{N}、{N, number} 或 {N, number, 说明符}，其中 N 是 values 中从零开始的索引。

数字说明符（用法：{N, number, 说明符}）：

• （省略）— 千位分隔符，最多 3 位小数
• integer — 取整，带千位分隔符
• currency — 前缀 $，精确 2 位小数，带千位分隔符
• percent — 乘以 100，添加 %
• 模式 — 自定义格式模式（见下）

自定义数字模式字符：

• # — 可选数字（省略尾随零）
• 0 — 必需数字（小数部分用 0 补齐）
• , — 分组分隔符；分组大小由整数部分 , 后的数字个数决定
• . — 小数点
• % — 将值乘以 100 并添加 %
• 其他字符作为字面量前缀或后缀
• 'text' — 字面量文本（引号内不解析占位符）
• '' — 字面量单引号字符

na 值显示为 "Na"。

参数

名称	类型	默认值	说明
template	String		包含 {N} 占位符的格式模板字符串。
values	any		要替换到模板中的可变数量的值。

返回: String

---

format_time

format_time(
    time: int,
    format: String,
    timezone: String = symbol_info.timezone
  ): String

使用格式令牌模式和时区，将时间戳（自纪元以来的毫秒数）格式化为字符串。

日期令牌：

• yyyy — 4 位年份（如 2024）
• yy — 2 位年份（如 24）
• MM — 带前导零的月份（01–12）
• M — 不带前导零的月份（1–12）
• dd — 带前导零的日期（01–31）
• d — 不带前导零的日期（1–31）

时间令牌：

• HH — 24 小时制小时，带前导零（00–23）
• H — 24 小时制小时，不带前导零（0–23）
• hh — 12 小时制小时，带前导零（01–12）
• h — 12 小时制小时，不带前导零（1–12）
• a — AM/PM 标识
• mm — 分钟，带前导零（00–59）
• m — 分钟，不带前导零（0–59）
• ss — 秒，带前导零（00–59）
• s — 秒，不带前导零（0–59）
• S — 十分之一秒（1 位）
• SS — 百分之一秒（2 位）
• SSS — 毫秒（3 位）

时区令牌：

• Z — UTC 偏移量，格式为 ±HHmm（如 +0000、-0530）

非格式令牌的字符（如 -、:、.、空格）作为字面量输出。 y 和 z 为保留字符，不能单独使用（仅 yy/yyyy 有效；z 始终报错）。

参数

名称	类型	默认值	说明
time	int		要格式化的时间戳（自纪元以来的毫秒数）。
format	String		格式模式字符串（参见函数说明中的令牌表）。
timezone	String	symbol_info.timezone	输出使用的时区（如 "UTC+8"、"UTC-5:30"）。默认为 symbol_info.timezone。

返回: String

---

from

使用自定义数字模式将整数转换为字符串。

format 字符串与 format 中 {N, number, pattern} 说明符使用相同的模式语法： # 可选数字、0 必需数字、, 分组分隔符、. 小数点、% 百分比、 其他字符作为字面量前缀/后缀、'text' 字面量文本、'' 字面量单引号。

参数

名称	类型	默认值	说明
value	int		要转换的整数值。
format	String		控制输出格式的数字模式字符串。

返回: String

使用自定义数字模式将浮点数转换为字符串。

format 字符串与 format 中 {N, number, pattern} 说明符使用相同的模式语法： # 可选数字、0 必需数字、, 分组分隔符、. 小数点、% 百分比、 其他字符作为字面量前缀/后缀、'text' 字面量文本、'' 字面量单引号。

参数

名称	类型	默认值	说明
value	float		要转换的浮点值。
format	String		控制输出格式的数字模式字符串。

返回: String

使用 Format 常量将整数转换为字符串。

• Format.Inherit — 继承所在系列上下文的格式
• Format.Price — 以价格形式呈现（精度取决于交易品种）
• Format.Volume — 以成交量形式呈现（大数字使用紧凑表示法）
• Format.Percent — 以百分比形式呈现
• Format.Mintick — 四舍五入到交易品种的 mintick，保留尾部零

参数

名称	类型	默认值	说明
value	int		要转换的整数值。
format	Format		控制格式化的 Format 常量。

返回: String

使用 Format 常量将浮点数转换为字符串。

• Format.Inherit — 继承所在系列上下文的格式
• Format.Price — 以价格形式呈现（精度取决于交易品种）
• Format.Volume — 以成交量形式呈现（大数字使用紧凑表示法）
• Format.Percent — 以百分比形式呈现
• Format.Mintick — 四舍五入到交易品种的 mintick，保留尾部零

参数

名称	类型	默认值	说明
value	float		要转换的浮点值。
format	Format		控制格式化的 Format 常量。

返回: String

将任意类型的值转换为其字符串表示形式。

参数

名称	类型	默认值	说明
value	T		要转换为字符串的值。

返回: String

方法

contains

contains(self: String, str: String): bool

检查字符串是否包含指定的子字符串。

参数

名称	类型	默认值	说明
self	String
str	String		要搜索的子字符串。

返回: bool

---

ends_with

ends_with(self: String, str: String): bool

检查字符串是否以指定的后缀结尾。

参数

名称	类型	默认值	说明
self	String
str	String		要搜索的后缀。

返回: bool

参见: String.starts_with

---

index_of

index_of(self: String, str: String): int

返回子字符串第一次出现的从零开始的索引，如果未找到则返回 na。

参数

名称	类型	默认值	说明
self	String
str	String		要搜索的子字符串。

返回: int

---

length

length(self: String): int

返回字符串的长度。

参数

名称	类型	默认值	说明
self	String

返回: int

---

lower

lower(self: String): String

将字符串中的所有字符转换为小写。

参数

名称	类型	默认值	说明
self	String

返回: String

---

match

match(self: String, regex: String): String

如果字符串匹配正则表达式模式，则返回匹配的子字符串，否则返回空字符串。

参数

名称	类型	默认值	说明
self	String
regex	String		要匹配的正则表达式模式。

返回: String

---

pad_end

pad_end(self: String, len: int, fill: String = " "): String

用 fill 在字符串右侧填充，直到长度至少为 len 个字符。

参数

名称	类型	默认值	说明
self	String
len	int		目标最小字符长度。
fill	String	" "	填充字符串，默认为 " "。

返回: String

参见: String.pad_start

---

pad_start

pad_start(self: String, len: int, fill: String = " "): String

用 fill 在字符串左侧填充，直到长度至少为 len 个字符。

参数

名称	类型	默认值	说明
self	String
len	int		目标最小字符长度。
fill	String	" "	填充字符串，默认为 " "。

返回: String

参见: String.pad_end

---

repeat

repeat(self: String, repeat: int): String

返回将字符串重复指定次数后的新字符串。

参数

名称	类型	默认值	说明
self	String
repeat	int		重复字符串的次数。

返回: String

---

replace

replace(
    self: String,
    target: String,
    replacement: String,
    occurrence: int = 0
  ): String

将目标子字符串第 N 次出现的位置替换为指定内容。

参数

名称	类型	默认值	说明
self	String
target	String		要被替换的子字符串。
replacement	String		替换内容。
occurrence	int	0	要替换的第 N 次出现（从 0 开始）。默认为 0。

返回: String

参见: String.replace_all

---

replace_all

replace_all(self: String, target: String, replacement: String): String

将目标子字符串的所有出现替换为指定内容。

参数

名称	类型	默认值	说明
self	String
target	String		要被替换的子字符串。
replacement	String		替换内容。

返回: String

参见: String.replace

---

split

split(self: String, separator: String): Array<String>

根据分隔符将字符串拆分为子字符串数组。

参数

名称	类型	默认值	说明
self	String
separator	String		用于拆分的分隔符字符串。

返回: Array<String>

---

starts_with

starts_with(self: String, str: String): bool

检查字符串是否以指定前缀开头。

参数

名称	类型	默认值	说明
self	String
str	String		要搜索的前缀。

返回: bool

参见: String.ends_with

---

substring

substring(self: String, begin_pos: int, end_pos: int): String

返回从 begin_pos 到 end_pos（不含）的子字符串。

参数

名称	类型	默认值	说明
self	String
begin_pos	int		起始位置（含）。
end_pos	int		结束位置（不含）。

返回: String

---

to_number

to_number(self: String): float

将字符串转换为浮点数。

参数

名称	类型	默认值	说明
self	String

返回: float — 解析后的浮点值，如果字符串无法解析则返回 na。

---

trim

trim(self: String): String

去除字符串首尾的空白字符。

参数

名称	类型	默认值	说明
self	String

返回: String

参见: String.trim_start, String.trim_end

---

trim_end

trim_end(self: String): String

去除字符串末尾的空白字符。

参数

名称	类型	默认值	说明
self	String

返回: String

参见: String.trim, String.trim_start

---

trim_start

trim_start(self: String): String

去除字符串开头的空白字符。

参数

名称	类型	默认值	说明
self	String

返回: String

参见: String.trim, String.trim_end

---

upper

upper(self: String): String

将字符串中的所有字符转换为大写。

参数

名称	类型	默认值	说明
self	String

返回: String