JS 常用函数

JS 常用函数

数组常用方法

concat()

描述

连接两个或多个数组，并返回已连接数组的副本

定义和用法

concat()方法用于连接两个或多个数组

concat()方法不会更改现有数组，而是返回一个新数组，其中包含已连接数组的值

语法

array1.concat(array2, array3, array4, ... , arrayx)

参数值

参数	描述
array2, array3, ... , arrayx	必须，要连接的数组

实例

var sedan = ["S60", "S90"];
var SUV = ["XC40", "XC60", "XC90"];
var wagon = ["V60", "V90", "V90CC"];
var Volvo = sedan.concat(SUV, wagon);

copyWithin()

描述

将数组中的数组元素复制到指定位置或从指定位置复制

定义和用法

copyWithin()方法将数组元素复制到数组中的另一个位置，覆盖现有值

copyWithin()方法永远不会向数组添加更多项

语法

array.copyWithin(target, start, end)

参数值

参数
target	必需，将元素复制到的索引位置
start	可选，开始复制元素的索引位置（默认为 0）
end	可选，停止从中复制元素的索引位置（默认为 array.length）

实例

var fruits = ["Banana", "Orange", "Apple", "Mango", "Kiwi", "Papaya"];
fruits.copyWithin(2, 0, 2);

entries()

描述

返回键 / 值对数组迭代对象

定义和用法

entries() 方法返回带有键/值对的 Array Iterator 对象。

对于原始数组中的每一项，新的迭代对象将包含一个以索引为键，以项值为值的数组：

• [0, "Banana"]
• [1, "Orange"]
• [2, "Apple"]
• [3, "Mango"]

注释：entries() 不会更改原始数组。

语法

array.entries()

参数值

无参数

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
var f = fruits.entries();

for (x of f) {
  document.getElementById("demo").innerHTML += x;
}

every()

描述

检查数组中的每个元素是否通过测试

定义和用法

every() 方法检查数组中的所有元素是否都通过了测试（被作为函数提供）。

every() 方法对数组中存在的每个元素执行一次函数：

• 如果找到函数返回 false 值的数组元素，every() 返回 false（并且不检查剩余值）
• 如果没有出现 false，every() 返回 true

注释：every() 不对没有值的数组元素执行函数。

注释：every() 不改变原始数组。

语法

array.every(function(currentValue, index, arr), thisValue)

参数值

参数	描述
function(currentValue, index, arr)	必需。为数组中的每个元素运行的函数。函数参数：参数描述currentValue必需。当前元素的值。index可选。当前元素的数组索引。arr可选。当前元素所属的数组对象
thisValue	可选。要传递给函数以用作其 "this" 值的值。如果此参数为空，则值 "undefined" 将作为其 "this" 值传递。

实例

var ages = [32, 33, 16, 40];

function checkAdult(age) {
  return age >= 18;
}

function myFunction() {
  document.getElementById("demo").innerHTML = ages.every(checkAdult);
}

fill()

描述

用静态值填充数组中的元素

定义和用法

fill() 方法用静态值填充数组中的指定元素。

您可以指定开始和结束填充的位置。如果未指定，则将填充所有元素。

注释：fill() 会覆盖原始数组。

语法

array.fill(value, start, end)

参数值

参数	描述
value	必需。用于填充数组的值。
start	可选。开始填充数组的索引（默认为 0）。
end	可选。停止填充数组的索引（默认为 array.length）。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.fill("Kiwi");

filter()

描述

使用数组中通过测试的每个元素创建新数组

定义和用法

filter() 方法创建数组，其中填充了所有通过测试的数组元素（作为函数提供）。

注释：filter() 不会对没有值的数组元素执行该函数。

注释：filter() 不会改变原始数组。

语法

array.filter(function(currentValue, index, arr), thisValue)

参数值

function(currentValue, index, arr)	必需。为数组中的每个元素运行的函数。函数参数：参数描述currentValue必需。当前元素的值。index可选。当前元素的数组索引。arr可选。当前元素所属的数组对象
thisValue	可选。要传递给函数以用作其 "this" 值的值。如果此参数为空，则值 "undefined" 将作为其 "this"值传递。

实例

var ages = [32, 33, 16, 40];

function checkAdult(age) {
  return age >= 18;
}

function myFunction() {
  document.getElementById("demo").innerHTML = ages.filter(checkAdult);
}

find()

描述

返回数组中第一个待通过测试的元素的值

定义和用法

find() 方法返回数组中第一个通过测试的元素的值（作为函数提供）。

find() 方法对数组中存在的每个元素执行一次函数：

• 如果找到函数返回 true 值的数组元素，则 find() 返回该数组元素的值（并且不检查剩余值）
• 否则返回 undefined

注释：find() 不对空数组执行该函数。

注释：find() 不会改变原始数组。

语法

array.find(function(currentValue, index, arr), thisValue)

参数值

参数	描述
function(currentValue, index, arr)	必需。为数组中的每个元素运行的函数。函数参数：参数描述currentValue必需。当前元素的值。index可选。当前元素的数组索引。arr可选。当前元素所属的数组对象
thisValue	可选。要传递给函数以用作其 "this" 值的值。如果此参数为空，则值 "undefined" 将作为其 "this"值传递。

实例

var ages = [3, 10, 18, 20];

function checkAdult(age) {
  return age >= 18;
}

function myFunction() {
  document.getElementById("demo").innerHTML = ages.find(checkAdult);
}

findIndex()

描述

返回数组中通过测试的第一个元素的索引

定义和用法

findIndex() 方法返回数组中通过测试的第一个元素的索引（作为函数提供）。

findIndex() 方法对数组中存在的每个元素执行一次函数：

• 如果找到函数返回 true 值的数组元素，则 findIndex() 返回该数组元素的索引（并且不检查剩余值）
• 否则返回 -1

注释：findIndex() 不会为没有值的数组元素执行函数。

注释：findIndex() 不会改变原始数组。

语法

array.findIndex(function(currentValue, index, arr), thisValue)

参数值

参数	描述
function(currentValue, index, arr)	必需。为数组中的每个元素运行的函数。函数参数：参数描述currentValue必需。当前元素的值。index可选。当前元素的数组索引。arr可选。当前元素所属的数组对象
thisValue	可选。要传递给函数以用作其 "this" 值的值。如果此参数为空，则值 "undefined" 将作为其 "this"值传递。

实例

var ages = [3, 10, 18, 20];

function checkAdult(age) {
  return age >= 18;
}

function myFunction() {
  document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}

forEach()

描述

为每个数组元素调用函数

定义和用法

forEach() 方法按顺序为数组中的每个元素调用一次函数。

注释：对于没有值的数组元素，不执行forEach() 方法。

语法

array.forEach(function(currentValue, index, arr), thisValue)

参数值

参数	描述
function(currentValue, index, arr)	必需。为数组中的每个元素运行的函数。函数参数：参数描述currentValue必需。当前元素的值。index可选。当前元素的数组索引。arr可选。当前元素所属的数组对象
thisValue	可选。要传递给函数以用作其 "this" 值的值。如果此参数为空，则值 "undefined" 将作为其 "this"值传递。

实例

var fruits = ["apple", "orange", "cherry"];
fruits.forEach(myFunction);

function myFunction(item, index) {
  document.getElementById("demo").innerHTML += index + ":" + item + "<br>"; 
}

from()

描述

从对象创建数组

定义和用法

from() 方法从具有 length 属性或可迭代对象的任何对象返回 Array 对象。

语法

Array.from(object, mapFunction, thisValue)

参数值

参数	描述
object	必需。需转换为数组的对象。
mapFunction	可选。对数组的每个项目调用的 map 函数。
thisValue	可选。执行 mapFunction 时用作 this 的值。

实例

var myArr = Array.from("ABCDEFG");

includes()

描述

检查数组是否包含指定的元素

定义和用法

includes() 方法确定数组是否包含指定的元素。

如果数组包含元素，则此方法返回 true，否则返回 false。

注释：includes() 方法区分大小写。

语法

array.includes(element, start)

参数值

参数	描述
element	必需。要搜索的元素。
start	可选。默认 0。在数组中的哪个位置开始搜索。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
var n = fruits.includes("Mango");

indexOf()

描述

在数组中搜索元素并返回其位置。

定义和用法

indexOf() 方法在数组中搜索指定项目，并返回其位置。

搜索将从指定位置开始，如果未指定开始位置，则从头开始，并在数组末尾结束搜索。

如果未找到该项目，则 indexOf() 返回 -1。

如果该项目出现多次，则 indexOf() 方法返回第一次出现的位置。

注释：第一项的位置为 0，第二项的位置为 1，依此类推。

提示：如果您想从尾到头搜索，请使用 lastIndexOf() 方法。

语法

array.indexOf(item, start)

参数值

参数	描述
item	必需。要搜索的项目。
start	可选。从哪里开始搜索。负值给定的位置将从结尾计数，然后搜索到最后。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
var a = fruits.indexOf("Apple");

isArray()

描述

检查对象是否为数组。

定义和用法

isArray() 方法确定对象是否为数组。

如果对象是数组，则此函数返回 true，否则返回 false。

语法

Array.isArray(obj)

参数值

参数	描述
obj	必需。需测试的对象。

实例

function myFunction() {
  var fruits = ["Banana", "Orange", "Apple", "Mango"];
  var x = document.getElementById("demo");
  x.innerHTML = Array.isArray(fruits);
}

join()

描述

将数组的所有元素连接成一个字符串。

定义和用法

join() 方法将数组作为字符串返回。

元素将由指定的分隔符分隔。默认分隔符是逗号 (,)。

注释：join() 方法不会改变原始数组。

语法

array.join(separator)

参数值

参数	描述
separator	可选。要使用的分隔符。如果省略，元素用逗号分隔。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
var energy = fruits.join();

keys()

描述

返回 Array Iteration 对象，包含原始数组的键.

定义和用法

keys() 方法返回带有数组键的 Array Iterator 对象。

注释：keys() 方法不改变原数组。

语法

array.keys()

参数值

无参数。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
var fk = fruits.keys();

for (x of fk) {
  document.getElementById("demo").innerHTML += x + "<br>";
}

lastIndexOf()

描述

在数组中搜索元素，从末尾开始，并返回其位置。

定义和用法

lastIndexOf() 方法在数组中搜索指定项目，并返回其位置。

搜索将从指定位置开始，如果未指定开始位置，则从末尾开始，并在数组的开头结束搜索。

如果未找到该项目，则 lastIndexOf() 方法返回 -1。

如果要搜索的项目不止一次出现，lastIndexOf() 方法将返回最后一次出现的位置。

提示：如果要从头到尾搜索，使用 indexOf() 方法。

语法

array.lastIndexOf(item, start)

参数值

参数	描述
item	必需。要搜索的项目。
start	可选。从哪里开始搜索。负值的给定的位置从末尾计数，然后搜索到开头。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
var a = fruits.lastIndexOf("Apple");

map()

描述

使用为每个数组元素调用函数的结果创建新数组。

定义和用法

map() 方法使用为每个数组元素调用函数的结果创建新数组。

map() 方法按顺序为数组中的每个元素调用一次提供的函数。

注释：map() 对没有值的数组元素不执行函数。

注释：map() 不会改变原始数组。

语法

array.map(function(currentValue, index, arr), thisValue)

参数值

参数	描述
function(currentValue, index, arr)	必需。为数组中的每个元素运行的函数。函数参数：参数描述currentValue必需。当前元素的值。index可选。当前元素的数组索引。arr可选。当前元素所属的数组对象
thisValue	可选。要传递给函数以用作其 "this" 值的值。如果此参数为空，则值 "undefined" 将作为其 "this"值传递。

实例

var numbers = [4, 9, 16, 25];
var x = numbers.map(Math.sqrt)
document.getElementById("demo").innerHTML = x;

pop()

描述

删除数组的最后一个元素，并返回该元素。

定义和用法

pop() 方法移除数组的最后一个元素，并返回该元素。

注释：pop() 方法会改变数组的长度。

提示：如需删除数组的第一个元素，请使用 shift() 方法。

语法

array.pop()

参数值

无参数。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.pop();

push()

描述

将新元素添加到数组的末尾，并返回新的长度。

定义和用法

push() 方法向数组末尾添加新项目，并返回新长度。

提示：新的项目将被添加到数组的末尾。

注释：push() 方法会改变数组的长度。

提示：如需在数组的开头添加项目，请使用 unshift() 方法。

语法

array.push(item1, item2, ..., itemX)

参数值

参数	描述
item1, item2, ..., itemX	必需。要添加到数组中的项目。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.push("Kiwi");

reduce()

描述

将数组的值减为单个值（从左到右）。

定义和用法

reduce() 方法将数组缩减为单个值。

reduce() 方法为数组的每个值（从左到右）执行提供的函数。

函数的返回值存储在累加器中（结果/总计）。

注释：对没有值的数组元素，不执行 reduce() 方法。

注释：reduce() 方法不会改变原始数组。

语法

array.reduce(function(total, currentValue, currentIndex, arr), initialValue)

参数值

参数	描述
function(total, currentValue, index, arr)	必需。为数组中的每个元素运行的函数。函数参数：参数描述total必需。initialValue，或函数先前返回的值。currentValue必需。当前元素的值。index可选。当前元素的数组索引。arr可选。当前元素所属的数组对象
initialValue	可选。作为初始值传递给函数的值。

实例

var numbers = [175, 50, 25];

document.getElementById("demo").innerHTML = numbers.reduce(myFunc);

function myFunc(total, num) {
  return total - num;
}

reduceRight()

描述

将数组的值减为单个值（从右到左）。

定义和用法

reduceRight() 方法将数组缩减为单个值。

reduceRight() 方法为数组的每个值（从右到左）执行提供的函数。

函数的返回值存储在累加器中（结果/总计）。

注释：对没有值的数组元素，不执行 reduceRight() 方法。

语法

array.reduceRight(function(total, currentValue, currentIndex, arr), initialValue)

参数值

参数描述function(total, currentValue, index, arr)必需。为数组中的每个元素运行的函数。

参数	描述
total	必需。initialValue，或函数先前返回的值。
currentValue	必需。当前元素的值。
index	可选。当前元素的数组索引。
arr	可选。当前元素所属的数组对象

initialValue可选。作为初始值传递给函数的值。

实例

var numbers = [175, 50, 25];

document.getElementById("demo").innerHTML = numbers.reduceRight(myFunc);

function myFunc(total, num) {
  return total - num;
}

reverse()

描述

反转数组中元素的顺序。

定义和用法

reverse() 方法反转数组中元素的顺序。

注释：reverse() 方法将改变原始数组。

语法

array.reverse()

参数值

无参数。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.reverse();

shift()

描述

删除数组的第一个元素，并返回该元素。

定义和用法

shift() 方法移除数组的第一项。

注释：shift() 方法会改变数组的长度。

注释：shift 方法的返回值是被移除的项目。

注释：shift() 方法会改变原始数组。

提示：如需删除数组的最后一项，请使用 pop() 方法。

语法

array.shift()

参数值

无参数。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.shift();

slice()

描述

选择数组的一部分，并返回新数组。

定义和用法

slice() 方法以新的数组对象，返回数组中被选中的元素。

slice() 方法选择从给定的 start 参数开始的元素，并在给定的 end 参数处结束，但不包括。

注释：slice() 方法不会改变原始数组。

语法

array.slice(start, end)

参数值

参数	描述
start	可选。整数，指定从哪里开始选择（第一个元素的索引为 0）。使用负数从数组的末尾进行选择。如果省略，则类似于 "0"。
end	可选。整数，指定结束选择的位置。如果省略，将选择从开始位置到数组末尾的所有元素。使用负数从数组末尾进行选择。

实例

var fruits = ["Banana", "Orange", "Lemon", "Apple", "Mango"];
var citrus = fruits.slice(1, 3);

some()

描述

检查数组中的任何元素是否通过测试。

定义和用法

some() 方法检查数组中的任何元素是否通过测试（作为函数提供）。

some() 方法对数组中存在的每个元素执行一次函数：

• 如果找到函数返回真值的数组元素，some() 返回真（并且不检查剩余值）
• 否则返回 false

注释：some() 对没有值的数组元素不执行函数。

注释：some() 不改变原始数组。

语法

array.some(function(currentValue, index, arr), thisValue)

参数值

参数	描述
function(currentValue, index, arr)	必需。为数组中的每个元素运行的函数。函数参数：参数描述currentValue必需。当前元素的值。index可选。当前元素的数组索引。arr可选。当前元素所属的数组对象
thisValue	可选。要传递给函数以用作其 "this" 值的值。如果此参数为空，则值 "undefined" 将作为其 "this" 值传递。

实例

var ages = [3, 10, 18, 20];

function checkAdult(age) {
  return age >= 18;
}

function myFunction() {
  document.getElementById("demo").innerHTML = ages.some(checkAdult);
}

sort()

描述

对数组的元素进行排序。

定义和用法

sort() 方法对数组的项目进行排序。

排序顺序可以是按字母或数字，也可以是升序（向上）或降序（向下）。

默认情况下，sort() 方法将按字母和升序将值作为字符串进行排序。

这适用于字符串（"Apple" 出现在 "Banana" 之前）。但是，如果数字按字符串排序，则 "25" 大于 "100" ，因为 "2" 大于 "1"。

正因为如此，sort() 方法在对数字进行排序时会产生不正确的结果。

您可以通过提供“比较函数”来解决此问题（请参阅下面的“参数值”）。

注释：sort() 方法会改变原始数组。

语法

array.sort(compareFunction)

参数值

参数	描述
compareFunction	可选。定义替代排序顺序的函数。该函数应返回负值、零值或正值，具体取决于参数，例如：function(a, b){return a-b}sort() 方法比较两个值时，将值发送给比较函数，根据返回的（负、零、正）值对值进行排序。举例：比较 40 和 100 时，sort() 方法调用比较函数(40,100)。该函数计算 40-100，并返回 -60（负值）。sort 函数会将 40 排序为小于 100 的值。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.sort();

splice()

描述

从数组中添加/删除元素。

定义和用法

splice() 方法向/从数组添加/删除项目，并返回删除的项目。

注释：splice() 方法会改变原始数组。

语法

array.splice(index, howmany, item1, ....., itemX)

参数值

参数	描述
index	必需。整数，指定在什么位置添加/删除项目，使用负值指定从数组末尾开始的位置。
howmany	可选。要删除的项目数。如果设置为 0，则不会删除任何项目。
item1, ..., itemX	可选。要添加到数组中的新项目。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.splice(2, 0, "Lemon", "Kiwi");

toString()

描述

将数组转换为字符串，并返回结果。

定义和用法

toString() 方法返回包含所有数组值的字符串，以逗号分隔。

注释：toString() 方法不会改变原始数组。

语法

array.toString()

参数值

无参数。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
var x = fruits.toString();

unshift()

描述

将新元素添加到数组的开头，并返回新的长度。

定义和用法

unshift() 方法将新项添加到数组的开头，并返回新的长度。

注释：unshift() 方法会改变数组的长度。

提示：如需在数组末尾添加新项，请使用 push() 方法。

语法

array.unshift(item1, item2, ..., itemX)

参数值

参数	描述
item1, item2, ..., itemX	必需。要添加到数组开头的项。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.unshift("Lemon","Pineapple");

valueOf()

描述

返回数组的原始值。

定义和用法

valueOf() 方法返回数组。

valueOf() 方法是数组对象的默认方法。

注释：valueOf() 方法不会改变原始数组。

语法

array.valueOf()

参数值

无参数。

实例

var fruits = ["Banana", "Orange", "Apple", "Mango"];
var v = fruits.valueOf();	// 返回 fruits

日期常用方法

getDate()

描述

返回月中的第几天（从 1 到 31）。

定义和用法

getDate() 方法返回指定日期在月中的第几天（从 1 到 31）。

语法

Date.getDate()

参数值

无参数。

实例

var d = new Date();
var n = d.getDate();

getDay()

描述

返回星期几（0-6）。

定义和用法

getDay() 方法返回指定日期是星期几（从 0 到 6）。

注释：星期日为 0，星期一为 1，依此类推。

语法

Date.getDay()

参数值

无参数。

实例

var d = new Date();
var n = d.getDay();

getFullYear()

描述

返回年份。

定义和用法

getFullYear() 方法返回指定日期的年份（1000 年到 9999 年之间的日期的四位数字）。

语法

Date.getFullYear()

参数值

无参数。

实例

var d = new Date();
var n = d.getFullYear();

getHours()

描述

返回小时（从 0-23）。

定义和用法

getHours() 方法返回指定日期和时间的小时数（从 0 到 23）。

语法

Date.getHours()

参数值

无参数。

实例

var d = new Date();
var n = d.getHours();

getMilliseconds()

描述

返回毫秒（0-999）。

定义和用法

getMilliseconds() 方法返回指定日期和时间的毫秒数（从 0 到 999）。

语法

Date.getMilliseconds()

参数值

无参数。

实例

var d = new Date();
var n = d.getMilliseconds();

getMinutes()

描述

返回分钟（从 0-59）。

定义和用法

getMinutes() 方法返回指定日期和时间的分钟数（从 0 到 59）。

语法

Date.getMinutes()

参数值

无参数。

实例

var d = new Date();
var n = d.getMinutes();

getMonth()

描述

返回月份（从 0-11）。

定义和用法

getMonth() 方法根据本地时间返回指定日期的月份（从 0 到 11）。

注释：一月为 0，二月为 1，依此类推。

语法

Date.getMonth()

参数值

无参数。

实例

var d = new Date();
var n = d.getMonth();

getSeconds()

描述

返回秒数（从 0-59）。

定义和用法

getSeconds() 方法返回指定日期和时间的秒数（从 0 到 59）。

语法

Date.getSeconds()

参数值

无参数。

实例

var d = new Date();
var n = d.getSeconds();

getTime()

描述

返回自 1970 年 1 月 1 日午夜以来与指定日期的毫秒数。

定义和用法

getTime() 方法返回从 1970 年 1 月 1 日午夜到指定日期之间的毫秒数。

语法

Date.getTime()

参数值

无参数。

实例

var d = new Date();
var n = d.getTime();

now()

描述

返回自 1970 年 1 月 1 日午夜以来的毫秒数。

定义和用法

Date.now() 方法返回自 1970 年 1 月 1 日 00:00:00 UTC 以来的毫秒数。

语法

Date.now()

参数值

无参数。

实例

var n = Date.now();

parse()

描述

解析日期字符串并返回自 1970 年 1 月 1 日以来的毫秒数。

定义和用法

parse() 方法解析日期字符串，并返回日期字符串与 1970 年 1 月 1 日午夜之间的毫秒数。

说明：该方法是 Date 对象的静态方法。一般采用 Date.parse() 的形式来调用，而不是通过 dateobject.parse() 调用该方法。

语法

Date.parse(datestring)

参数值

参数	描述
datestring	必需。表示日期的字符串。

实例

计算从 1970 年 1 月 1 日到 2012 年 3 月 21 日之间的年数：

var d = Date.parse("March 21, 2012");
var minutes = 1000 * 60;
var hours = minutes * 60;
var days = hours * 24;
var years = days * 365;

var y = Math.round(d / years);

setDate()

描述

设置 Date 对象中月的某一天。

定义和用法

setDate() 方法将月份中的某一天设置为日期对象。

语法

Date.setDate(day)

参数值

参数	描述
day	必需。整数，表示月中的某一天。预期值是 1-31，但允许其他值：0 将导致上个月的最后一天-1 将导致上个月的最后一天的前一天如果一个月有 31 天：32 将导致下个月的第一天如果一个月有 30 天：32 将导致下个月的第二天

实例

将本月的某一天设置为上个月的最后一天：

var d = new Date();
d.setDate(0);

setFullYear()

描述

设置日期对象的年份

定义和用法

setFullYear() 方法设置日期对象的年份（1000 年到 9999 年之间的四位数字）。

此方法也可用于设置月份和月份的日期。

语法

Date.setFullYear(year, month, day)

参数值

参数	描述
year	必需。表示年份的值，允许负值。
month	可选。表示月份的整数。预期值是 0-11，但允许其他值：-1 将导致上一年的最后一个月12 将导致明年的第一个月13 将导致明年的第二个月
day	可选。整数，表示月中的哪一天。预期值是 1-31，但允许其他值：0 将导致上个月的最后一天-1 将导致上个月的最后一天的前一天如果一个月有 31 天：32 将导致下个月的第一天如果一个月有 30 天：32 将导致下个月的第二天

实例

将日期设置为 2020 年 11 月 3 日：

var d = new Date();
d.setFullYear(2020, 10, 3);

setHours()

描述

设置日期对象的小时。

定义和用法

setHours() 方法设置日期对象的小时。

此方法还可用于设置分钟、秒和毫秒。

语法

Date.setHours(hour, min, sec, millisec)

参数值

参数	描述
hour	必需。表示小时的整数。期望值是 0-23，但允许其他值：-1 将导致前一天的最后一个小时24 将导致第二天的第一个小时
min	可选。表示分钟的整数。期望值是 0-59，但允许其他值：-1 将导致前一小时的最后一分钟60 将导致下一小时的第一分钟
sec	可选。表示秒的整数。期望值是 0-59，但允许其他值：-1 将导致前一分钟的最后一秒60 将导致下一分钟的第一秒
millisec	可选。表示毫秒的整数。期望值为 0-999，但允许其他值：-1 将导致前一秒的最后一毫秒1000 将导致下一秒的第一毫秒

实例

将时间设置为 15:35:01

var d = new Date();
d.setHours(15, 35, 1);

setMilliseconds()

描述

设置日期对象的毫秒数。

定义和用法

setMilliseconds() 方法设置日期对象的毫秒数。

语法

Date.setMilliseconds(millisec)

参数值

参数	描述
millisec	必需。表示毫秒的整数。期望值为 0-999，但允许其他值：-1 将导致前一秒的最后一毫秒1000 将导致下一秒的第一毫秒1001 将导致下一秒的第二毫秒

实例

将毫秒设置为 192：

var d = new Date();
d.setMilliseconds(192);
var n = d.getMilliseconds();

setMinutes()

描述

设置日期对象的分钟数。

定义和用法

setMinutes() 方法设置日期对象的分钟。

这个方法也可以用来设置秒和毫秒。

语法

Date.setMinutes(min, sec, millisec)

参数值

参数	描述
min	必需。表示分钟的整数。预期值为 0-59，但允许其他值：-1 将导致前一小时的最后一分钟60 将导致下一小时的第一分钟
sec	可选。表示秒的整数。预期值为 0-59，但允许其他值：-1 将导致前一分钟的最后一秒60 将导致下一分钟的第一秒
millisec	可选。表示毫秒的整数。预期值为 0-999，但允许其他值：-1 将导致前一秒的最后一毫秒1000 将导致下一秒的第一毫秒

实例

将日期时间设置为 90 分钟前：

var d = new Date();
d.setMinutes(d.getMinutes() - 90);

setMonth()

描述

设置日期对象的月份。

定义和用法

setMonth() 方法设置日期对象的月份。

注释：一月为 0，二月为 1，依此类推。

此方法还可用于设置月中的日期。

语法

Date.setMonth(month, day)

参数值

参数	描述
month	必需。表示月份的整数。期望值是 0-11，但允许其他值：-1 将导致上一年的最后一个月12 将导致明年的第一个月13 将导致明年的第二个月
day	可选。整数，表示月中的哪一天。期望值是 1-31，但允许其他值：0 将导致上个月的最后一天-1 将导致上个月的最后一天的前一天如果一个月有 31 天：32 将导致下个月的第一天如果一个月有 30 天：32 将导致下个月的第二天

实例

将月份设置为 4（五月），将日期设置为 20 日：

var d = new Date();
d.setMonth(4, 20);

setSeconds()

描述

设置日期对象的秒数。

定义和用法

setSeconds() 方法设置日期对象的秒数。

此方法也可用于设置毫秒。

语法

Date.setSeconds(sec, millisec)

参数值

参数	描述
sec	必需。表示秒的整数。期望值是 0-59，但允许其他值：-1 将导致前一分钟的最后一秒60 将导致下一分钟的第一秒
millisec	可选。表示毫秒的整数。期望值为 0-999，但允许其他值：-1 将导致前一秒的最后一毫秒1000 将导致下一秒的第一毫秒

实例

设置秒和毫秒：

var d = new Date();
d.setSeconds(35, 825);
var n = d.getSeconds() + ":" + d.getMilliseconds();

setTime()

描述

将日期设置为 1970 年 1 月 1 日之后/之前的指定毫秒数。

定义和用法

setTime() 方法通过从 1970 年 1 月 1 日午夜开始添加或减去指定的毫秒数来设置日期和时间。

语法

Date.setTime(millisec)

参数值

参数	描述
millisec	必需。1970 年 1 月 1 日午夜加上或减去的毫秒数。

实例

从 1970 年 1 月 1 日减去 1332403882588 毫秒，并显示新的日期和时间：

var d = new Date();
d.setTime(-1332403882588);

toJSON()

描述

以字符串形式返回日期，格式为 JSON 日期。

定义和用法

toJSON() 方法将 Date 对象转换为字符串，格式为 JSON 日期。

JSON 日期的格式与 ISO-8601 标准相同：YYYY-MM-DDTHH:mm:ss.sssZ

语法

Date.toJSON()

参数值

无参数。

实例

将 Date 对象作为字符串返回，格式为 JSON 日期：

var d = new Date();
var n = d.toJSON();

toLocaleString()

描述

使用区域设置约定将 Date 对象转换为字符串。

定义和用法

toLocaleString() 方法使用区域设置将 Date 对象转换为字符串。

默认语言取决于您计算机上的区域设置。

语法

Date.toLocaleString(locales, options)

参数值

参数	描述
locales	可选。要使用哪种语言特定格式。单击“试一试”按钮来查看所有正在运行的值。合法值：ar-SA 阿拉伯语（沙特阿拉伯） bn-BD Bangla（孟加拉国） bn-IN 孟加拉语（印度） cs-CZ 捷克语（捷克共和国） da-DK 丹麦语（丹麦） de-AT 奥地利 德语 de-CH“瑞士”德语 de-DE 标准德语（在德国使用） el-GR 现代希腊语 en-AU 澳大利亚英语 en-CA 加拿大英语 en-GB 英式英语 en-IE 爱尔兰语 英语 en-IN 印度 英语 en-NZ 新西兰 英语 en-US 美国英语 en-ZA 英语（南非） es-AR 阿根廷 西班牙语 es-CL 智利 西班牙语 es-CO 哥伦比亚西班牙语 es-ES 卡斯蒂利亚西班牙语（在西班牙中北部使用） es-MX 墨西哥 西班牙语 es-US 美式 西班牙语 fi-FI 芬兰语（芬兰） fr-BE 比利时 法语 fr-CA 加拿大法语 fr-CH “瑞士” 法语 fr-FR 标准法语（尤其是在法国） he-IL 希伯来语（以色列） hi-IN 印地语（印度） hu-HU 匈牙利语（匈牙利） id-ID 印度尼西亚语（印度尼西亚） it-CH“瑞士”意大利语 it-IT 标准意大利语（意大利语） jp-JP 日语（日本） ko-KR 韩文（大韩民国） nl-BE 比利时荷兰语 nl-NL 标准荷兰语（荷兰语） no-NO 挪威语（挪威） pl-PL 波兰语（波兰） pt-BR 巴西葡萄牙语 pt-PT 欧洲葡萄牙语（在葡萄牙书写和使用） ro-RO 罗马尼亚语（罗马尼亚） ru-RU 俄语（俄罗斯联邦） sk-SK 斯洛伐克语（斯洛伐克） sv-SE 瑞典语（瑞典） ta-IN 印度语 泰米尔语 ta-LK 斯里兰卡泰米尔语 th-TH Thai (泰国) tr-TR 土耳其语（土耳其） zh-CN 中国大陆，简体字 zh-HK 香港，繁体字 zh-TW 台湾，繁体字
options	可选。可以设置一些属性的对象。合法属性：dateStyle Legal values: "full" "long" "medium" "short" timeStyle "full" "long" "medium" "short" localeMatcher "best-fit" (default) "lookup" timeZone hour12 false true hourCycle "h11" "h12" "h23" "h24" formatMatcher "basic" "best-fit" (default) weekday "long" "short" "narrow" year "2-digit" "numeric" month "2-digit" "long" "narrow" "numeric" "short" day "2-digit" "long" hour "2-digit" "long" minute "2-digit" "long" second "2-digit" "long" timeZoneName "long" "short"

实例

使用区域约定将 Date 对象转换为字符串：

var d = new Date();
var n = d.toLocaleString();

toString()

描述

将 Date 对象转换为字符串。

定义和用法

toString() 方法将 Date 对象转换为字符串。

注释：每当需要将 Date 对象显示为字符串时，JavaScript 就会自动调用此方法。

语法

Date.toString()

参数值

无参数。

实例

将 Date 对象转换为字符串：

var d = new Date();
var n = d.toString();

valueOf()

描述

返回 Date 对象的原始值。

定义和用法

valueOf() 方法返回 Date 对象的原始值。

注释：原始值以 UTC 时间 1970 年 1 月 1 日午夜以来的毫秒数形式返回。

语法

Date.valueOf()

参数值

无参数。

实例

返回 Date 对象的原始值：

var d = new Date();
var n = d.valueOf();

字符串常用方法

anchor()

描述

创建 HTML 锚。

定义和用法

anchor() 方法用于创建 HTML 锚。

语法

stringObject.anchor(anchorname)

参数值

参数	描述
anchorname	必需。为锚定义名称。

实例

在本例中，我们会为文本添加一个锚：

<script type="text/javascript">

var txt="Hello world!"
document.write(txt.anchor("myanchor"))

</script>

上面的代码将输出为纯粹的 HTML：

<a name="myanchor">Hello world!</a>

bold()

描述

使用粗体显示字符串。

定义和用法

bold() 方法用于把字符串显示为粗体。

语法

stringObject.bold()

参数值

无参数。

实例

在本例中，"Hello world!" 将被显示为粗体：

<script type="text/javascript">

var str="Hello world!"
document.write(str.bold())

</script>

charAt()

描述

返回在指定位置的字符。

定义和用法

charAt() 方法可返回指定位置的字符。

请注意，JavaScript 并没有一种有别于字符串类型的字符数据类型，所以返回的字符是长度为 1 的字符串。

语法

stringObject.charAt(index)

参数值

参数	描述
index	必需。表示字符串中某个位置的数字，即字符在字符串中的下标。

实例

在字符串 "Hello world!" 中，我们将返回位置 1 的字符：

<script type="text/javascript">

var str="Hello world!"
document.write(str.charAt(1))

</script>

以上代码的输出是：

e

concat()

描述

连接字符串。

定义和用法

concat() 方法用于连接两个或多个字符串。

语法

stringObject.concat(stringX,stringX,...,stringX)

参数值

参数	描述
stringX	必需。将被连接为一个字符串的一个或多个字符串对象。

实例

在本例中，我们将创建两个字符串，然后使用 concat() 把它们显示为一个字符串：

<script type="text/javascript">

var str1="Hello "
var str2="world!"
document.write(str1.concat(str2))

</script>

以上代码的输出是：

Hello world!

fontcolor()

描述

使用指定的颜色来显示字符串。

定义和用法

fontcolor() 方法用于按照指定的颜色来显示字符串。

语法

stringObject.fontcolor(color)

参数值

参数	描述
color	必需。为字符串规定 font-color。该值必须是颜色名(red)、RGB 值(rgb(255,0,0))或者十六进制数(#FF0000)。

实例

在本例中，"Hello world!" 将显示为红色：

<script type="text/javascript">

var str="Hello world!"
document.write(str.fontcolor("Red"))

</script>

fontsize()

描述

使用指定的尺寸来显示字符串。

定义和用法

fontsize() 方法用于按照指定的尺寸来显示字符串。

语法

stringObject.fontsize(size)

参数值

参数	描述
size	size 参数必须是从 1 至 7 的数字。

实例

在本例中，"Hello world!" 将显示为大号字：

<script type="text/javascript">

var str="Hello world!"
document.write(str.fontsize(7))

</script>

indexOf()

描述

检索字符串。

定义和用法

indexOf() 方法可返回某个指定的字符串值在字符串中首次出现的位置。

语法

stringObject.indexOf(searchvalue,fromindex)

参数值

参数	描述
searchvalue	必需。规定需检索的字符串值。
fromindex	可选的整数参数。规定在字符串中开始检索的位置。它的合法取值是 0 到 stringObject.length - 1。如省略该参数，则将从字符串的首字符开始检索。

实例

在本例中，我们将在 "Hello world!" 字符串内进行不同的检索：

<script type="text/javascript">

var str="Hello world!"
document.write(str.indexOf("Hello") + "<br />")
document.write(str.indexOf("World") + "<br />")
document.write(str.indexOf("world"))

</script>

以上代码的输出：

0
-1
6

lastIndexOf()

描述

从后向前搜索字符串。

定义和用法

lastIndexOf() 方法可返回一个指定的字符串值最后出现的位置，在一个字符串中的指定位置从后向前搜索。

语法

stringObject.lastIndexOf(searchvalue,fromindex)

参数值

参数	描述
searchvalue	必需。规定需检索的字符串值。
fromindex	可选的整数参数。规定在字符串中开始检索的位置。它的合法取值是 0 到 stringObject.length - 1。如省略该参数，则将从字符串的最后一个字符处开始检索。

实例

在本例中，我们将在 "Hello world!" 字符串内进行不同的检索：

<script type="text/javascript">

var str="Hello world!"
document.write(str.lastIndexOf("Hello") + "<br />")
document.write(str.lastIndexOf("World") + "<br />")
document.write(str.lastIndexOf("world"))

</script>

以上代码的输出：

0
-1
6

match()

描述

找到一个或多个正则表达式的匹配。

定义和用法

match() 方法可在字符串内检索指定的值，或找到一个或多个正则表达式的匹配。

该方法类似 indexOf() 和 lastIndexOf()，但是它返回指定的值，而不是字符串的位置。

语法

stringObject.match(searchvalue)
stringObject.match(regexp)

参数值

参数	描述
searchvalue	必需。规定要检索的字符串值。
regexp	必需。规定要匹配的模式的 RegExp 对象。如果该参数不是 RegExp 对象，则需要首先把它传递给 RegExp 构造函数，将其转换为 RegExp 对象。

实例

在本例中，我们将在 "Hello world!" 中进行不同的检索：

<script type="text/javascript">

var str="Hello world!"
document.write(str.match("world") + "<br />")
document.write(str.match("World") + "<br />")
document.write(str.match("worlld") + "<br />")
document.write(str.match("world!"))

</script>

输出：

world
null
null
world!

replace()

描述

替换与正则表达式匹配的子串。

定义和用法

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

语法

stringObject.replace(regexp/substr,replacement)

参数值

参数	描述
regexp/substr	必需。规定子字符串或要替换的模式的 RegExp 对象。请注意，如果该值是一个字符串，则将它作为要检索的直接量文本模式，而不是首先被转换为 RegExp 对象。
replacement	必需。一个字符串值。规定了替换文本或生成替换文本的函数。

实例

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

<script type="text/javascript">

var str="Visit Microsoft!"
document.write(str.replace(/Microsoft/, "W3School"))

</script>

输出：

Visit W3School!

search()

描述

检索与正则表达式相匹配的值。

定义和用法

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

语法

stringObject.search(regexp)

参数值

参数	描述
regexp	该参数可以是需要在 stringObject 中检索的子串，也可以是需要检索的 RegExp 对象。注释：要执行忽略大小写的检索，请追加标志 i。

实例

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

<script type="text/javascript">

var str="Visit W3School!"
document.write(str.search(/W3School/))

</script>

输出：

6

slice()

描述

提取字符串的片断，并在新的字符串中返回被提取的部分。

定义和用法

slice() 方法可提取字符串的某个部分，并以新的字符串返回被提取的部分。

语法

stringObject.slice(start,end)

参数值

参数	描述
start	要抽取的片断的起始下标。如果是负数，则该参数规定的是从字符串的尾部开始算起的位置。也就是说，-1 指字符串的最后一个字符，-2 指倒数第二个字符，以此类推。
end	紧接着要抽取的片段的结尾的下标。若未指定此参数，则要提取的子串包括 start 到原字符串结尾的字符串。如果该参数是负数，那么它规定的是从字符串的尾部开始算起的位置。

实例

在本例中，我们将提取从位置 6 开始的所有字符：

<script type="text/javascript">

var str="Hello happy world!"
document.write(str.slice(6))

</script>

输出：

happy world!

split()

描述

把字符串分割为字符串数组。

定义和用法

split() 方法用于把一个字符串分割成字符串数组。

语法

stringObject.split(separator,howmany)

参数值

参数	描述
separator	必需。字符串或正则表达式，从该参数指定的地方分割 stringObject。
howmany	可选。该参数可指定返回的数组的最大长度。如果设置了该参数，返回的子串不会多于这个参数指定的数组。如果没有设置该参数，整个字符串都会被分割，不考虑它的长度。

实例

在本例中，我们将按照不同的方式来分割字符串：

<script type="text/javascript">

var str="How are you doing today?"

document.write(str.split(" ") + "<br />")
document.write(str.split("") + "<br />")
document.write(str.split(" ",3))

</script>

输出：

How,are,you,doing,today?
H,o,w, ,a,r,e, ,y,o,u, ,d,o,i,n,g, ,t,o,d,a,y,?
How,are,you

substr()

描述

从起始索引号提取字符串中指定数目的字符。

定义和用法

substr() 方法可在字符串中抽取从 start 下标开始的指定数目的字符。

语法

stringObject.substr(start,length)

参数值

参数	描述
start	必需。要抽取的子串的起始下标。必须是数值。如果是负数，那么该参数声明从字符串的尾部开始算起的位置。也就是说，-1 指字符串中最后一个字符，-2 指倒数第二个字符，以此类推。
length	可选。子串中的字符数。必须是数值。如果省略了该参数，那么返回从 stringObject 的开始位置到结尾的字串。

实例

在本例中，我们将使用 substr() 从字符串中提取一些字符：

<script type="text/javascript">

var str="Hello world!"
document.write(str.substr(3))

</script>

输出：

lo world!

substring()

描述

提取字符串中两个指定的索引号之间的字符。

定义和用法

substring() 方法用于提取字符串中介于两个指定下标之间的字符。

语法

stringObject.substring(start,stop)

参数值

参数	描述
start	必需。一个非负的整数，规定要提取的子串的第一个字符在 stringObject 中的位置。
stop	可选。一个非负的整数，比要提取的子串的最后一个字符在 stringObject 中的位置多 1。如果省略该参数，那么返回的子串会一直到字符串的结尾。

实例

在本例中，我们将使用 substring() 从字符串中提取一些字符：

<script type="text/javascript">

var str="Hello world!"
document.write(str.substring(3))

</script>

输出：

lo world!

toLowerCase()

描述

把字符串转换为小写。

定义和用法

toLowerCase() 方法用于把字符串转换为小写。

语法

stringObject.toLowerCase()

参数值

无参数。

实例

在本例中，"Hello world!" 将以小写字母来显示：

<script type="text/javascript">

var str="Hello World!"
document.write(str.toLowerCase())

</script>

toUpperCase()

描述

把字符串转换为大写。

定义和用法

toUpperCase() 方法用于把字符串转换为大写。

语法

stringObject.toUpperCase()

参数值

无参数。

实例

在本例中，"Hello world!" 将以大写字母来显示：

<script type="text/javascript">

var str="Hello World!"
document.write(str.toUpperCase())

</script>