2008年12月29日

EXT核心API詳解(二)-Array/Date/Function/Number/String

Array類

indexOf( Object o ) : Number
object是否在數組中,找不到返回-1;找到返回位置
remove( Object o ) : Array
從數組中刪除指定的對象object,如果找不到object則數組無變化

Number類
constrain( Number min, Number max ) : Number
檢查數值是否介於min與max之間, 如果大於max 返回max,如果小於min返回min, 否則返回當前值

String類
escape( String string ) : String
將string中的'和\替換為\' \\

format( String string, String value1, String value2 ) : String
格式化字符串,例:
var cls = 'my-class', text = 'Some text';
var s = String.format('

{1}
', cls, text);// 結果
Some text


leftPad( String string, Number size, [String char] ) : String
以char將string補齊為size長度,char默認定義空格

toggle( String value, String other ) : String
交換值,如果當前值等於value,則被賦值other,反之等於value,例:
sort = sort.toggle('ASC', 'DESC');

trim() : String
去除開頭或結尾多餘的空格


Date類
Date.parseDate( String input, String format ) : Date
將字符串string依指定的格式format轉換為時間,其中格式定義詳見format方法
例:dt = Date.parseDate("2006-01-15 3:20:01 PM", "Y-m-d h:i:s A" );


add( String interval, Number value ) : Date
增加時間段,String interval在Data類中已定義
Date.MILLI = "ms";
Date.SECOND = "s";
Date.MINUTE = "mi";
Date.HOUR = "h";
Date.DAY = "d";
Date.MONTH = "mo";
Date.YEAR = "y";
例var dt2 = new Date('10/1/2006').add(Date.DAY, -5);

between( Date start, Date end ) : Boolean
是否在兩個指定的時間之間

clearTime( Boolean clone ) : Date
清除時間信息,如果clone為真,則克隆自已並返回新Date,本身的值並不改變,反之則修改自身的值

clone() : Date
克隆

format( String format ) : String
格式化時間
d 兩位數的日期 01 至 31
D 三字母的星期名 Mon 至 Sun
j 一位數的日期 1 至 31
l 完整的星期名 Sunday 至 Saturday
S 日期的英文順序刻詞尾,兩個字符 st, nd, rd or th.
w 一週中的第幾天 0 (星期天) 至 6 (星期六)
z 一年中的第幾天 0 至 364 (閏年365 )
W ISO-8601 星期數, 週一算一個星期的開始 1 至 53
F 月的完整英文名 January 至 December
m 月,以0前導 01 至 12
M 三字母的簡寫月名 Jan 至 Dec
n 月 1 至 12
t 本月有多少天 28 至 31
L 是否閏年 1/0
Y 完整的年份 例: 1999 或 2003
y 年的後兩位 例: 99 或 03
a 上午/下午小寫 am 或 pm
A 上午/下午大寫 AM 或 PM
g 小時/12小時制 1 至 12
G 小時/24小時制 0 至 23
h 小時/12小時制 01 至 12
H 小時/24小時制 00 至 23
i 分鐘 00 至 59
s 秒 00 至 59
u 毫秒 001 至 999
O 時區,與格林威治標準時間之差 例: +0200
T 時區簡寫 例: EST, MDT ...
Z 時區間距 -43200 至 50400
其中Date類內置了幾種格式
Date.patterns = {
ISO8601Long:"Y-m-d H:i:s",
ISO8601Short:"Y-m-d",
ShortDate: "n/j/Y",
LongDate: "l, F d, Y",
FullDateTime: "l, F d, Y g:i:s A",
MonthDay: "F d",
ShortTime: "g:i A",
LongTime: "g:i:s A",
SortableDateTime: "Y-m-d\\TH:i:s",
UniversalSortableDateTime: "Y-m-d H:i:sO",
YearMonth: "F, Y"
};
當然ISO8601Long和ISO8601Short還是非常招人喜歡的
例:
dt.format(Date.patterns.ISO8601Long);
dt.format('Y-m-d H:i:s');

getDayOfYear() : Number
一年中的第幾天,從0開始

getDaysInMonth() : Number
本月有多少天,

getElapsed( [Date date] ) : Number
當前日期對象與date之間相差的毫秒數

getFirstDateOfMonth() : Date
本月的第一天

getFirstDayOfMonth() : Number
本月第一天是星期幾

getGMTOffset() : String
時區信息(見格式定義中的'O')
getFirstDateOfMonth() : Date
本月最後一天

getFirstDayOfMonth() : Number
本月最後一天是星期幾

getSuffix() : String
日期後導符(見格式定義中的S)

getTimezone() : String
時區(見T)

getWeekOfYear() : Number
一年中的第幾週(見W)

isLeapYear() : Boolean
是否閏年


Function類
createCallback(/*args...*/) : Function
創建回叫方法

createDelegate( [Object obj], [Array args], [Boolean/Number appendArgs] ) :
創建委託
這兩個記法除了傳參方式不同,看不出有什麼差異都是調用method.apply,createCallback可以看作一個簡化版的createDelegate
createCallback==>return method.apply(window, args);
createDelegate==>return method.apply(obj || window, callArgs);
前者參數比較簡單,直接傳過去了,後者的規則比較複雜點,如果appendArgs為真,args將附加在參數列表之後,如果是數值,args將在參數列表的appendargs位置插入,其它情況下原參將不起作用
例:
var fn = func1.createDelegate(scope, [arg1,arg2], true)
//fn(a,b,c) === scope.func1(a,b,c,arg1,arg2);
var fn = func1.createDelegate(scope, [arg1,arg2])
//fn(a,b,c) === scope.func1(arg1,arg2);
var fn = func1.createDelegate(scope, [arg1,arg2], 1)
//fn(a,b,c) === scope.func1(a,arg1,arg2,b,c);
var fn = func1.createCallback(arg1, arg2);
//fn() === func1(arg1, arg2)


createCallback : function(/*args...*/)


createInterceptor( Function fcn, [Object scope] ) : Function
創建阻斷方法,如果fcn返回false,原方法將不會被執行

createSequence( Function fcn, [Object scope] ) : Function
創建組合方法,執行原方法+fcn

defer( Number millis, [Object obj], [Array args], [Boolean/Number appendArgs] ):Number
定時執行,隔millis毫秒後執行原方法