dateBuild¶

Builds a date String based on the specified pattern and date units.

Parameters¶

Combine the parameters as a JSON structure as input.

Parameter	Mandatory/Optional	Data Type	Description
pattern	Mandatory	String	The format of the returned date.
year	Optional	String	The year in yyyy format (for example: 2021). If none or an invalid value is specified, `dateBuild` will use the current year.
month	Optional	String	The month in number format (for example: 1 for January, 2 for February, etc.). If none or an invalid value is specified, `dateBuild` will use the current month.
dayofmonth	Optional	String	The day of the month in number format (for example: 1 for the first day of the month, 2 for the second day of the month, etc.). If none or an invalid value is specified, `dateBuild` will use the current day.
timezone	Optional	String	The timezone for the returned date/time, such as GMT for Greenwich Mean Time. If not specified, GMT is used by default.
locale	Optional	String	Locale for the returned date/time. For example, if `locale` is EN (English), and `pattern` is EEE d MMM yyyy, the returned result will be Thu 2000-04-13 01:45:33. If not specified, EN is used by default. The locales currently supported are: EN: English CH: Chinese

Return Values¶

Value	Data Type	Description
value	String	The date built according to `year`, `month`, and `dayofmonth`, in the format as per specified in `pattern`.

Samples¶

var format = tools.DateUtil.dateBuild({"month":"11","year":"2000","timezone":"GMT","pattern":"EEE yyyy-MM-dd hh:mm:ss","dayofmonth":"13","locale":"CH"});
return tools.resultBuilder.build(true, JSON.stringify(format));

Output

"Mon 2000-11-13 04:40:13"