String

不可變的 Unicode 字元序列。

靜態方法

format

navi

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

navi

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

名稱	類型	預設值	說明
`value`	`float`		要轉換的浮點值。
`format`	`String`		控制輸出格式的數字模式字串。

名稱	類型	預設值	說明
`value`	`float`		要轉換的浮點值。
`format`	`Format`		控制格式化的 Format 常數。

名稱	類型	預設值	說明
`value`	`T`		要轉換為字串的值。

方法

contains

navi

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

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

參數

名稱	類型	預設值	說明
`self`	`String`
`str`	`String`		要搜尋的子字串。

返回: bool

ends_with

navi

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

檢查字串是否以指定後綴結尾。

參數

名稱	類型	預設值	說明
`self`	`String`
`str`	`String`		要搜尋的後綴。

返回: bool

參見: String.starts_with

index_of

navi

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

返回子字串第一次出現的從零開始的索引，如果未找到則返回 na。

參數

名稱	類型	預設值	說明
`self`	`String`
`str`	`String`		要搜尋的子字串。

返回: int

length

navi

length(self: String): int

返回字串的長度。

參數

名稱	類型	預設值	說明
`self`	`String`

返回: int

lower

navi

lower(self: String): String

將字串中的所有字元轉換為小寫。

參數

名稱	類型	預設值	說明
`self`	`String`

返回: String

match

navi

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

如果字串符合正規表達式模式，則返回匹配的子字串，否則返回空字串。

參數

名稱	類型	預設值	說明
`self`	`String`
`regex`	`String`		要匹配的正規表達式模式。

返回: String

pad_end

navi

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

用 fill 在字串右側填充，直到長度至少為 len 個字元。

參數

名稱	類型	預設值	說明
`self`	`String`
`len`	`int`		目標最小字元長度。
`fill`	`String`	`" "`	填充字串，預設為 `" "`。

返回: String

參見: String.pad_start

pad_start

navi

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

用 fill 在字串左側填充，直到長度至少為 len 個字元。

參數

名稱	類型	預設值	說明
`self`	`String`
`len`	`int`		目標最小字元長度。
`fill`	`String`	`" "`	填充字串，預設為 `" "`。

返回: String

參見: String.pad_end

repeat

navi

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

返回將字串重複指定次數後的新字串。

參數

名稱	類型	預設值	說明
`self`	`String`
`repeat`	`int`		重複字串的次數。

返回: String

replace

navi

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

navi

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

將目標子字串的所有出現替換為指定內容。

參數

名稱	類型	說明
`self`	`String`
`target`	`String`	要被替換的子字串。
`replacement`	`String`	替換內容。

返回: String

參見: String.replace

split

navi

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

根據分隔符將字串拆分為子字串陣列。

參數

名稱	類型	預設值	說明
`self`	`String`
`separator`	`String`		用於拆分的分隔符字串。

返回: Array<String>

starts_with

navi

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

檢查字串是否以指定前綴開頭。

參數

名稱	類型	預設值	說明
`self`	`String`
`str`	`String`		要搜尋的前綴。

返回: bool

參見: String.ends_with

substring

navi

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

navi

to_number(self: String): float

將字串轉換為浮點數。

參數

名稱	類型	預設值	說明
`self`	`String`

返回: float — 解析後的浮點值，如果字串無法解析則返回 na。

trim

navi

trim(self: String): String

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

參數

名稱	類型	預設值	說明
`self`	`String`

返回: String

參見: String.trim_start, String.trim_end

trim_end

navi

trim_end(self: String): String

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

參數

名稱	類型	預設值	說明
`self`	`String`

返回: String

參見: String.trim, String.trim_start

trim_start

navi

trim_start(self: String): String

去除字串開頭的空白字元。

參數

名稱	類型	預設值	說明
`self`	`String`

返回: String

參見: String.trim, String.trim_end

upper

navi

upper(self: String): String

將字串中的所有字元轉換為大寫。

參數

名稱	類型	預設值	說明
`self`	`String`

返回: String

String ​

靜態方法 ​

format ​

format_time ​

from ​

方法 ​

contains ​

ends_with ​

index_of ​

length ​

lower ​

match ​

pad_end ​

pad_start ​

repeat ​

replace ​

replace_all ​

split ​

starts_with ​

substring ​

to_number ​

trim ​

trim_end ​

trim_start ​

upper ​

String

靜態方法

format

format_time

from

方法

contains

ends_with

index_of

length

lower

match

pad_end

pad_start

repeat

replace

replace_all

split

starts_with

substring

to_number

trim

trim_end

trim_start

upper