substring Method (String) (JavaScript)

Returns the substring at the specified location within a String object.


      strVariable. substring(start [, end])  
"String Literal".substring(start [, end])   


Required. The zero-based index integer indicating the beginning of the substring.

Optional. The zero-based index integer indicating the end of the substring. The substring includes the characters up to, but not including, the character indicated by end.

If end is omitted, the characters from start through the end of the original string are returned.


The substring method returns a string containing the substring from start up to, but not including, end.

The substring method uses the lower value of start and end as the beginning point of the substring. For example, strvar.substring(0, 3) and strvar.substring(3, 0) return the same substring.

If either start or end is NaN or negative, it is replaced with zero.

The length of the substring is equal to the absolute value of the difference between start and end. For example, the length of the substring returned in strvar.substring(0, 3) and strvar.substring(3, 0) is three.


The following example illustrates the use of the substring method.

var s = "The quick brown fox jumps over the lazy dog.";  
var ss = s.substring(10, 15);  

// Output:  
// brown  


Supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards, Internet Explorer 9 standards, Internet Explorer 10 standards, Internet Explorer 11 standards. Also supported in Store apps (Windows 8 and Windows Phone 8.1). See Version Information.

See Also

substr Method (String)