JS内置函数参考.docx

JS内置函数参考.docx

《JS内置函数参考.docx》由会员分享，可在线阅读，更多相关《JS内置函数参考.docx（15页珍藏版）》请在冰豆网上搜索。

JS内置函数参考

1replace（）方法用于在字符串中用一些字符替换另一些字符，或替换一个与正则表达式匹配的子串。

语法

stringObject.replace（regexp,replacement）

参数

描述

regexp

必需。

规定了要替换的模式的RegExp对象。

请注意，如果该值是一个字符串，则将它作为要检索的直接量文本模式，而不是首先被转换为RegExp对象。

replacement

必需。

一个字符串值。

规定了替换文本或生成替换文本的函数。

返回值

一个新的字符串，是用replacement替换了regexp的第一次匹配或所有匹配之后得到的。

说明

字符串stringObject的replace（）方法执行的是查找并替换的操作。

它将在stringObject中查找与regexp相匹配的子字符串，然后用replacement来替换这些子串。

如果regexp具有全局标志g，那么replace（）方法将替换所有匹配的子串。

否则，它只替换第一个匹配子串。

replacement可以是字符串，也可以是函数。

如果它是字符串，那么没有匹配都将由字符串替换。

但是replacement中的$字符具有特定的含义。

如下表所示，它说明从模式匹配得到的字符串将用于替换。

字符

替换文本

$1、$2、...、$99

与regexp中的第1到第99个子表达式相匹配的文本。

$&

与regexp相匹配的子串。

$`

位于匹配子串左侧的文本。

$'

位于匹配子串右侧的文本。

$$

直接量符号。

注意：

ECMAScriptv3规定，replace（）方法的参数replacement可以是函数而不是字符串。

在这种情况下，每个匹配都调用该函数，它返回的字符串将作为替换文本使用。

该函数的第一个参数是匹配模式的字符串。

接下来的参数是与模式中的子表达式匹配的字符串，可以有0个或多个这样的参数。

接下来的参数是一个整数，声明了匹配在stringObject中出现的位置。

最后一个参数是stringObject本身。

实例

例子1

在本例中，我们将使用"W3School"替换字符串中的"Microsoft"：

varstr="VisitMicrosoft!

"

document.write（str.replace（/Microsoft/,"W3School"））

输出：

VisitW3School!

例子2

在本例中，我们将执行一次全局替换，每当"Microsoft"被找到，它就被替换为"W3School"：

varstr="WelcometoMicrosoft!

"

str=str+"WeareproudtoannouncethatMicrosofthas"

str=str+"oneofthelargestWebDeveloperssitesintheworld."

document.write（str.replace（/Microsoft/g,"W3School"））

输出：

WelcometoW3School!

WeareproudtoannouncethatW3School

hasoneofthelargestWebDeveloperssitesintheworld.

例子3

您可以使用本例提供的代码来确保匹配字符串大写字符的正确：

text="javascriptTutorial";

text.replace（/javascript/i,"JavaScript"）;

例子4

在本例中，我们将把"Doe,John"转换为"JohnDoe"的形式：

name="Doe,John";

name.replace（/（\w+）\s*,\s*（\w+）/,"$2$1"）;

例子5

在本例中，我们将把所有的花引号替换为直引号：

name='"a","b"';

name.replace（/"（[^"]*）"/g,"'$1'"）;

例子6

在本例中，我们将把字符串中所有单词的首字母都转换为大写：

name='aaabbbccc';

uw=name.replace（/\b\w+\b/g,function（word）{

returnword.substring（0,1）.toUpperCase（）+word.substring

（1）;}

）;

2reverse（）方法用于颠倒数组中元素的顺序。

语法

arrayObject.reverse（）

提示和注释

注释：

该方法会改变原来的数组，而不会创建新的数组。

实例

在本例中，我们将创建一个数组，然后颠倒其元素的顺序：

vararr=newArray（3）

arr[0]="George"

arr[1]="John"

arr[2]="Thomas"

document.write（arr+"
"）

document.write（arr.reverse（））

输出：

George,John,Thomas

Thomas,John,George

3round（）方法可把一个数字舍入为最接近的整数。

语法

Math.round（x）

参数

描述

x

必需。

必须是数字。

返回值

与x最接近的整数。

说明

对于0.5，该方法将进行上舍入。

例如，3.5将舍入为4，而-3.5将舍入为-2。

实例

在下面的例子中，我们将把pow（）运用到不同的数字组合上：

document.write（Math.round（0.60）+"
"）

document.write（Math.round（0.50）+"
"）

document.write（Math.round（0.49）+"
"）

document.write（Math.round（-4.40）+"
"）

document.write（Math.round（-4.60））

输出：

1

1

0

-4

-5

4search（）方法用于检索字符串中指定的子字符串，或检索与正则表达式相匹配的子字符串。

语法

stringObject.search（regexp）

参数

描述

regexp

该参数可以是需要在stringObject中检索的子串，也可以是需要检索的RegExp对象。

注释：

要执行忽略大小写的检索，请追加标志i。

返回值

stringObject中第一个与regexp相匹配的子串的起始位置。

注释：

如果没有找到任何匹配的子串，则返回-1。

说明

search（）方法不执行全局匹配，它将忽略标志g。

它同时忽略regexp的lastIndex属性，并且总是从字符串的开始进行检索，这意味着它总是返回stringObject的第一个匹配的位置。

实例

例子1

在本例中，我们将检索"W3School"：

varstr="VisitW3School!

"

document.write（str.search（/W3School/））

输出：

6

在下面的例子中，无法检索到w3school（因为search（）对大小写敏感）。

varstr="VisitW3School!

"

document.write（str.search（/w3school/））

输出：

-1

例子2

在本例中，我们将执行一次忽略大小写的检索：

varstr="VisitW3School!

"

document.write（str.search（/w3school/i））

输出：

6

5setDate（）方法用于设置一个月的某一天。

语法

dateObject.setDate（day）

参数

描述

day

必需。

表示一个月中的一天的一个数值（1~31）。

返回值

调整过的日期的毫秒表示。

在ECMAScript标准化之前，该方法什么都不返回。

提示和注释：

注释：

该方法总是结合一个Date对象来使用。

实例

在本例中，我们将通过setDate（）方法把当前月的天设置为15：

vard=newDate（）

d.setDate（15）

document.write（d）

输出：

WedFeb1518:

31:

28UTC+08002017

6setFullYear（）方法用于设置年份。

语法

dateObject.setFullYear（year,month,day）

参数

描述

year

必需。

表示年份的四位整数。

用本地时间表示。

month

可选。

表示月份的数值，介于0~11之间。

用本地时间表示。

day

可选。

表示月中某一天的数值，介于1~31之间。

用本地时间表示。

返回值

返回调整过的日期的毫秒表示。

提示和注释：

注释：

该方法总是结合一个Date对象来使用。

实例

例子1

在本例中，我们将通过setFullYear（）把年份设置为1992：

vard=newDate（）

d.setFullYear（1992）

document.write（d）

输出：

FriFeb2118:

31:

44UTC+08001992

例子2

在本例中，我们将通过setFullYear（）把日期设置为November3,1992：

vard=newDate（）

d.setFullYear（1992,10,3）

document.write（d）

输出：

TueNov318:

31:

44UTC+08001992

7setHours（）方法用于设置指定的时间的小时字段。

语法

dateObject.setHours（hour,min,sec,millisec）

参数

描述

hour

必需。

表示小时的数值，介于0（午夜）~23（晚上11点）之间，以本地时间计（下同）。

min

可选。

表示分钟的数值，介于0~59之间。

在EMCAScript标准化之前，不支持该参数。

sec

可选。

表示秒的数值，介于0~59之间。

在EMCAScript标准化之前，不支持该参数。

millisec

可选。

表示毫秒的数值，介于0~999之间。

在EMCAScript标准化之前，不支持该参数。

返回值

调整过的日期的毫秒表示。

在ECMAScript标准化之前，该方法什么都不返回。

提示和注释：

注释：

如果上面的参数之一使用一位的数字来规定，那么JavaScript会在结果中加一或两个前置0。

注释：

该方法总是结合一个Date对象来使用。

实例

例子1

在本例中，我们将通过setHours（）方法把当前时间的小时字段设置为15：

vard=newDate（）

d.setHours（15）

document.write（d）

输出：

TueFeb2115:

32:

00UTC+08002017

例子2

在本例中，我们将通过setHours（）方法把时间设置为15:

35:

01：

vard=newDate（）

d.setHours（15,35,1）

document.write（d）

输出：

TueFeb2115:

35:

01UTC+08002017

8setMilliseconds（）方法用于设置指定时间的毫秒字段。

语法

dateObject.setMilliseconds（millisec）

参数

描述

millisec

必需。

用于设置dateObject毫秒字段，该参数是介于0~999之间的整数。

返回值

调整过的日期的毫秒表示。

提示和注释：

注释：

如果上面的参数之一使用一位的数字来规定，那么JavaScript会在结果中加一或两个前置0。

注释：

该方法总是结合一个Date对象来使用。

实例

在本例中，我们将通过setMilliseconds（）方法把当前时间的毫秒字段设置为001：

vard=newDate（）

d.setMilliseconds

（1）

document.write（d）

输出：

TueFeb2118:

32:

31UTC+08002017

9setMinutes（）方法用于设置指定时间的分钟字段。

语法

dateObject.setMinutes（min,sec,millisec）

参数

描述

min

必需。

表示分钟的数值，介于0~59之间，以本地时间计（下同）。

sec

可选。

表示秒的数值，介于0~59之间。

在EMCAScript标准化之前，不支持该参数。

millisec

可选。

表示毫秒的数值，介于0~999之间。

在EMCAScript标准化之前，不支持该参数。

返回值

调整过的日期的毫秒表示。

在ECMAScript标准化之前，该方法什么都不返回。

提示和注释：

注释：

如果上面的参数之一使用一位的数字来规定，那么JavaScript会在结果中加一或两个前置0。

注释：

该方法总是结合一个Date对象来使用。

实例

在本例中，我们将通过setMinutes（）方法把当前时间的分钟字段设置为01：

vard=newDate（）

d.setMinutes

（1）

document.write（d）

输出：

TueFeb2118:

01:

06UTC+08002017

10setMonth（）方法用于设置月份。

语法

dateObject.setMonth（month,day）

参数

描述

month

必需。

一个表示月份的数值，该值介于0（一月）~11（十二月）之间。

day

可选。

一个表示月的某一天的数值，该值介于1~31之间（以本地时间计）。

在EMCAScript标准化之前，不支持该参数。

返回值

调整过的日期的毫秒表示。

在ECMAScript标准化之前，该方法什么都不返回。

提示和注释：

注释：

该方法总是结合一个Date对象来使用。

实例

例子1

在本例中，我们将通过setMonth（）方法把对象d的月字段设置为0（一月）：

vard=newDate（）

d.setMonth（0）

document.write（d）

输出：

SatJan2118:

33:

34UTC+08002017

例子2

在本例中，我们将通过setMonth（）方法把对象d的月字段设置为0（一月），把天字段设置为20：

vard=newDate（）

d.setMonth（0,20）

document.write（d）

输出：

FriJan2018:

33:

34UTC+08002017

11ThesetSeconds（）methodisusedtosetthesecondsofaspecifiedtime.

语法

dateObject.setSeconds（sec,millisec）

参数

描述

sec

必需。

表示秒的数值，该值是介于0~59之间的整数。

millisec

可选。

表示毫秒的数值，介于0~999之间。

在EMCAScript标准化之前，不支持该参数。

返回值

调整过的日期的毫秒表示。

在ECMAScript标准化之前，该方法什么都不返回。

提示和注释：

注释：

如果上面的参数之一使用一位的数字来规定，那么JavaScript会在结果中加一或两个前置0。

注释：

该方法总是结合一个Date对象来使用。

实例

在本例中，我们将通过setSeconds（）方法把当前时间的秒字段设置为01：

vard=newDate（）

d.setSeconds

（1）

document.write（d）

输出：

TueFeb2118:

34:

01UTC+08002017