Ext.util.Format

Files
Format.js

此类是一个用于格式化函数集中的类。它包括要格式化的各种不同类型数据的函数，如文本、日期和数值。

本地化 此类包含本地化的一些选项。当类库加载完后才可以将这些选项设置进去, 从这里对函数的所有调用将都使用指定的语言环境设置。选项包括:
- thousandSeparator - decimalSeparator - currenyPrecision - currencySign - currencyAtEnd 此类还在这里使用定义的默认日期格式: Ext.Date.defaultFormat.

使用渲染器 这里有两个辅助函数应用在表格的渲染器当中，并返回一个新函数来渲染字段:

columns: [{
    dataIndex: 'date',
    renderer: Ext.util.Format.dateRenderer('Y-m-d')
}, {
    dataIndex: 'time',
    renderer: Ext.util.Format.numberRenderer('0.000')
}]

也可以直接传递只带一个参数的函数:

columns: [{
    dataIndex: 'cost',
    renderer: Ext.util.Format.usMoney
}, {
    dataIndex: 'productCode',
    renderer: Ext.util.Format.uppercase
}]

使用XTemplates XTemplates也可以直接使用Ext.util.Format的函数:

new Ext.XTemplate([
    'Date: {startDate:date("Y-m-d")}',
    'Cost: {cost:usMoney}'
]);

Defined By

Properties

Ext.util.Format

currencyAtEnd : Boolean

此属性可以设置成true以使currency函数将货币符号追加到格式化的值。

此属性可能被本地文件所覆盖。

Defaults to: false

Ext.util.Format

currencyPrecision : Number

currency函数显示的小数位数。

此属性可能被本地文件所覆盖。

Defaults to: 2

Ext.util.Format

currencySign : String

currency货币函数显示的货币符号。

此属性可能被本地文件所覆盖。

Defaults to: "$"

Ext.util.Format

decimalSeparator : String

number函数使用作为小数点的字符。

此属性可能被本地文件所覆盖。

Defaults to: "."

Ext.util.Format

thousandSeparator : String

number函数使用作为千位分隔符的字符。

此属性可能被本地文件所覆盖。

Defaults to: ","

Defined By

Methods

Ext.util.Format

capitalize( String string ) : String

Ext.String.capitalize的别名。

返回一个字符串，该字符串中第一个字母为大写字母

Parameters

string : String
要转换的字符串

Returns

String
转换后的字符串

Ext.util.Format

currency( Number/String value, String sign, Number decimals, Boolean end ) : String

将一个数值格式化成货币形式

Parameters

value : Number/String
需要进行格式化的数值
sign : String
使用的货币符号(缺省值为currencySign)
decimals : Number
使用的货币值小数点后的位数(缺省值为currencyPrecision)
end : Boolean
如果为true则货币符号应追加在字符串的结尾(缺省值为currencyAtEnd)

Returns

String
格式化后的货币字符串

Ext.util.Format

date( String/Date value, String format ) : String

将某个值解析成为一个特定格式的日期。

Parameters

value : String/Date
需要格式化的值(字符串必须符合 javascript Date对象的parse()方法期望的格式)。
format : String
(可选)任何有效的日期格式字符串。默认为Ext.Date.defaultFormat.

Returns

String
格式化后的日期字符串。

Ext.util.Format

dateRenderer( String format ) : Function

返回一个日期渲染函数，它可以高效地，多次反复应用到日期格式上

Parameters

format : String
任何有效的日期格式字符串。默认为Ext.Date.defaultFormat.

Returns

Function
日期格式函数

Ext.util.Format

defaultValue( Object value, String defaultValue ) : String

检查一个引用，如果它为空则转换成一个默认值

Parameters

value : Object
要检查的引用值
defaultValue : String
如果为undefined时插入的值(默认为"")

Returns

String

Ext.util.Format

ellipsis( String value, Number length, Boolean word ) : String

Ext.String.ellipsis的别名。

对大于指定长度的字符串，进行裁剪，增加省略号('...')的显示

Parameters

value : String
要裁剪的字符串
length : Number
要裁剪允许的最大长度
word : Boolean
如果为 true，则试图找到一个共同的词符

Returns

String
转换后的文本

Ext.util.Format

escapeRegex( String str ) : String

避免所传递的字符串用在一个正则表达式中

Parameters

str : String

Returns

String

Ext.util.Format

fileSize( Number/String size ) : String

对文件大小进行简单的格式化(xxx bytes, xxx KB, xxx MB)

Parameters

size : Number/String
需要格式化的数值

Returns

String
格式化后的文件大小

Ext.util.Format

format( String string, String value1, String value2 ) : String

Ext.String.format的别名。

定义带标记的字符串，并用传入的字符替换标记。每个标记必须是唯一的，而且必须要像{0},{1}...{n}这样地自增长。例如：

    var cls = 'my-class', text = 'Some text';
    var s = Ext.String.format('<div class="{0}">{1}</div>', cls, text);
    // s 现在是字符串: '<div class="my-class">Some text</div>'

Parameters

string : String
带标记的字符串。
value1 : String
第一个值，替换{0}。
value2 : String
第二个值，替换{1}...等等（可以有任意多个）。

Returns

String
转化过的字符串。

Ext.util.Format

htmlDecode( String value ) : String

Ext.String.htmlDecode的别名。

将 (&, <, >, ', 和 ") 字符从HTML显示的格式还原。

Parameters

value : String
要解码的字符串

Returns

String
解码后的文本

Ext.util.Format

htmlEncode( String value ) : String

Ext.String.htmlEncode的别名。

转义 (&, <, >, ', 和 ") 为能在HTML中显示的字符。

Parameters

value : String
要编码的字符串

Returns

String
编码后的文本

Ext.util.Format

leftPad( String string, Number size, String character ) : String

Ext.String.leftPad的别名。

在字符串左边填充指定字符。这对于统一字符或日期标准格式非常有用。例如：

    var s = Ext.String.leftPad('123', 5, '0');
    // s 现在是：'00123'

Parameters

string : String
源字符串
size : Number
源加上填充字符串的总长度
character : String
（可选的）填充字符串（默认是" "）

Returns

String
填充后的字符串

Ext.util.Format

lowercase( String value ) : String

返回一个字符串，该字符串中的字母被转换为小写字母

Parameters

value : String
要转换的字符串

Returns

String
转换后的字符串

Ext.util.Format

math( ) : Function

进行简单的匹配，以便用在一个模板中，例如: var tpl = new Ext.Template('{value} * 10 = {value:math("* 10")}'); ...

进行简单的匹配，以便用在一个模板中，例如:

var tpl = new Ext.Template('{value} * 10 = {value:math("* 10")}');

Returns

Function
在传递的值上进行操作的函数。

Ext.util.Format

nl2br( String v ) : String

将换行字符串格式化成HTML标签 <br/>

Parameters

v : String
需要格式化的字符串值。

Returns

String
包含内嵌<br/>标签的字符串，用来替代换行。

Ext.util.Format

number( Number v, String formatString ) : String

根据传入的格式字符串将传递的数字格式化。

小数分隔符数字的数量，精确了小数位在字条串的位置。在结果中使用区域特定设置的小数位字符。

出现在格式字符串中的千位分隔字符将被插入到区域特定设置(如果存在)的千位分隔符列表中。

默认情况下，","预期作为千位分隔符，和"."预期作为小数点分隔符。

Ext JS 4 新特性

当插入千位和小数分隔符进行格式化输出时总是使用区域设置的特定字符。

根据美国/英国的惯例，格式化字符串必须指定分隔字符 ("," 作为千位分隔符, 和 "." 作为小数点分隔符)。

允许字符串的格式规范根据当地惯例的分隔字符,将字符串 /i添加到格式字符串的末尾。

例如 (123456.789):

0 - (123456) 只显示整数，没有小数
0.00 - (123456.78) 精确到两位小数
0.0000 - (123456.7890) 精确到四位小数
0,000 - (123,456) 显示逗号和整数，没有小数
0,000.00 - (123,456.78) 显示逗号和两位小数
0,0.00 - (123,456.78) 快捷方法，显示逗号和两位小数
在一些国际化的场合需要反转分组（,）和小数位（.），那么就在后面加上/i. 例如: 0.000,00/i

Parameters

v : Number
需要格式化的数字。
formatString : String
你需要格式化文本的方式。

Returns

String
格式化后的数字。

Ext.util.Format

numberRenderer( String format ) : Function

返回一个数值渲染函数，它可以高效地，多次反复应用到数值格式上

Parameters

format : String
对number任何有效的数值格式字符串

Returns

Function
数值格式化函数

Ext.util.Format

parseBox( Number/String v ) : Object

解析一个数字或字符串，表示成一个对象的边距大小。支持CSS-style声明中设置的外边距属性 (例如 10, "10", "10 10", "10 10 10" 和 "10 10 10 10" 均是有效的选项，并将返回相同的结果) ...

解析一个数字或字符串，表示成一个对象的边距大小。支持CSS-style声明中设置的外边距属性 (例如 10, "10", "10 10", "10 10 10" 和 "10 10 10 10" 均是有效的选项，并将返回相同的结果)

Parameters

v : Number/String
已编码的边距

Returns

Object
一个具有上，右，下，左边距宽度的对象

Ext.util.Format

plural( Number v, String s, String p )

根据一个数值，可对单词选用一个复数形式。例如，在模板中， {commentCount:plural("Comment")} 如果commentCount为1 ，那么结果就是"1 Comment"，如果值为0或者大于1就是"x Com...

根据一个数值，可对单词选用一个复数形式。例如，在模板中， {commentCount:plural("Comment")} 如果commentCount为1 ，那么结果就是"1 Comment"，如果值为0或者大于1就是"x Comments"。

Parameters

v : Number
需要用来对比的值
s : String
单词的单数格式
p : String
(可选)单词的复数形式(默认为单数格式加一个"s")

Ext.util.Format

round( Number/String value, Number precision ) : Number

将所传递的数字四舍五入到所需的精度。

Parameters

value : Number/String
需要四舍五入的数值。
precision : Number
用来四舍五入第一个参数值的小数位数值。

Returns

Number
四舍五入后的值。

Ext.util.Format

stripScripts( Object value ) : String

去掉所有script标签

Parameters

value : Object
需要去除script标签的文本

Returns

String
去掉script标签后的文本

Ext.util.Format

stripTags( Object value ) : String

去除所有HTML标签

Parameters

value : Object
需要从其中去掉标签的文本

Returns

String
去除标签后的文本

Ext.util.Format

substr( String value, Number start, Number length ) : String

返回原字符串中的一个子串

Parameters

value : String
原始文本
start : Number
子串的起始索引位置
length : Number
子串的长度

Returns

String
指定长度的子字符串

Ext.util.Format

trim( String string ) : String

Ext.String.trim的别名。

裁剪字符串两旁的空白符，保留中间空白符，例如： @example

var s = '  foo bar  ';
alert('-' + s + '-');         //打印 "- foo bar -"
alert('-' + Ext.String.trim(s) + '-');  //打印 "-foo bar-"

Parameters

string : String
要裁剪的字符串

Returns

String
已裁剪的字符串

Ext.util.Format

undef( Object value ) : Object

检查一个引用，如果它是undefined则将它转换成空字符串

Parameters

value : Object
要检查的引用值

Returns

Object
如果转换过，则为空字符串，否则为原先的值

Ext.util.Format

uppercase( String value ) : String

返回一个字符串，该字符串中的字母被转换为大写字母

Parameters

value : String
要转换的字符串

Returns

String
转换后的字符串

Ext.util.Format

usMoney( Number/String value ) : String

将一个数值格式化成美元形式

Parameters

value : Number/String
需要进行格式化的数值

Returns

String
格式化后的美元字符串