Range.Parse Method (Excel)

Office 2013 and later
GitHub-Mark-64px

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Parses a range of data and breaks it into multiple cells. Distributes the contents of the range to fill several adjacent columns; the range can be no more than one column wide.

expression .Parse(ParseLine, Destination)

expression A variable that represents a Range object.

Parameters

Name

Required/Optional

Data Type

Description

ParseLine

Optional

Variant

A string that contains left and right brackets to indicate where the cells should be split.

Destination

Optional

Variant

A Range object that represents the upper-left corner of the destination range for the parsed data. If this argument is omitted, Microsoft Excel parses in place.

Return Value

Variant

"[xxx][xxx]" would insert the first three characters into the first column of the destination range, and it would insert the next three characters into the second column. If this argument is omitted, Microsoft Excel guesses where to split the columns based on the spacing of the top left cell in the range. If you want to use a different range to guess the parse line, use a Range object as the ParseLine argument. That range must be one of the cells that's being parsed. The ParseLine argument cannot be longer than 255 characters, including the brackets and spaces.

This example divides telephone numbers of the form 206-555-1212 into two columns. The first column contains only the area code, and the second column contains the seven-digit telephone number with the embedded hyphen.

Worksheets("Sheet1").Columns("A").Parse _ 
 parseLine:="[xxx] [xxxxxxxx]", _ 
 destination:=Worksheets("Sheet1").Range("B1")

Concepts

Other resources

Show: