JavaScripTools Manual

Parsers

Working with the DateParser

The DateParser is a class that can convert strings to dates and dates to strings using a mask. The mask is a string containing the following charactes:

The constructor parameters are:

• mask: The mask string (defaults to the JST_DEFAULT_DATE_MASK constant)
• enforceLength: a flag indicating if parsing requires all fields to have the exact length as declared on the mask (defaults to the JST_DEFAULT_ENFORCE_LENGTH constant)

For more details about customizing those default values, check out this chapter.

If the mask has to change, just setting it will make no effect. To do so, you must call the setMask(newMask) method.

Here are some examples (remember that, the JavaScript Date object, the month starts on 0):

//The default value for enforceLength is true
var parser = new DateParser("yyyy-MM-dd");
parser.format(new Date(2006, 9, 2)) -> "2006-10-02"
parser.parse("2000-12-31") -> Dec 31, 2000
parser.parse("06-7-3") -> null (enforceLength is enabled)
parser.parse("ABC") -> null

var parser2 = new DateParser("d/M/yy H:m:s");
parser2.format(new Date(2006, 3, 7, 9, 30, 02)) -> "7/3/06 9:30:2"